X-Rooms

X-Rooms v1.3 - Changelog

New Features

- Debug system: New /xr debug command to toggle debug mode at runtime, plus a DebugLogger that logs detailed internal operations for easier troubleshooting. - PlaceholderAPI expansion: Added %xroom_maxplayers_<room>%, %xroom_minplayers_<room>%, %xroom_players_<room>%, and %xroom_time_<room>% placeholders. - Config auto-update with backup: When the config version changes, the old config is backed up as config_old.yml before generating the new one. - Adventure MiniMessage color support: Internal color system upgraded to use Adventure's MiniMessage for better formatting. - Shared dependency directory: Libby now downloads runtime libraries to plugins/X-API/ so all X plugins share dependencies instead of each having their own copy. - Updated startup messages with standardized logging format. - Standardized plugin lifecycle (onEnable/onDisable) with proper error handling and graceful degradation.

Bug Fixes

- Fixed room deletion not removing player data, causing orphaned entries in the data file. - Fixed room deletion not removing the room from the GUI menu, making deleted rooms still visible. - Fixed GUI not closing properly when a room was deleted while a player had it open. - Fixed GUI items not updating after a player joined or left a room. - Fixed clicking outside the GUI not cancelling the event, allowing accidental item movement. - Fixed room data not loading on server restart, causing all rooms to appear as missing. - Fixed room settings not being saved when modified through the configuration. - Fixed player count not resetting when a room was restarted, showing incorrect player amounts. - Fixed room state not persisting between server restarts, resetting active rooms to inactive. - Fixed minimum players check not working, allowing rooms to start below the required threshold. - Fixed maximum players not being enforced, letting more players join than the configured limit. - Fixed missing language keys in translation files that caused placeholder text to show instead of messages. - Fixed config system not detecting outdated versions, preventing automatic config updates. - Debug messages now include the plugin name in the format: [DEBUG] [X-Rooms] [Category] message.

🌍 Multi-Language Support*: Native support for English, Spanish, French, and Russian. 🛠️ New Messages*: Added messages for the entire plugin (GUIs, Commands, etc.). 🛡️ Barriers*: Completed barrier logic. 📦 New Commands*: Added /xr version and /xr stop commands. 🛠️ Bug Fixes*: Fixed several issues and bugs in the GUI. 🎮 Fluidity*: Added support for joining during the countdown without restarting the timer. 📍 WinLocation*: Now allows removing the set location via Right Click. 🎒 Inventory Management*: Fixed item restoration for winners and disconnections.

X-Rooms v1.1 - Changelog

✨ Arena Reset*: Implemented schematic system using WorldEdit/FAWE. 🛠️ Fawe fix*: Fixed compatibility with FAWE 2.x. 🛠️ Prefix*: Fixed the plugin prefix to appear correctly in messages. 🛠️ New Messages*: Added messages for all plugin usage. 📋 Commands*: Added /xrooms saveschematic and reset options. ⏰ Auto Reset*: Configurable reset interval in config.yml.

Features

- WorldEdit Integration: Select a region with WorldEdit/FAWE and instantly create a PvP room with /xr create. - Full GUI Management: Edit every room property (name, sounds, abilities, equipment, rewards) from a clean visual interface — no config editing needed. - 10 Configurable Abilities: Strength, Speed, Resistance, Haste, Regeneration, Fire Resistance, Jump Boost, Saturation, Absorption, and Fly — each with adjustable levels per room. - Ability Level Limits: Set global maximum levels for each ability in config.yml to prevent overpowered setups. - Custom Equipment & Rewards: Define kit items players receive on match start and reward items for the winner, all via GUI. - Automatic Inventory Management: Player inventories are backed up and restored automatically. No items lost. - Combat Logging Protection: Configurable punishment for players who disconnect during PvP — keep or delete their backup inventory. - Winner Teleport Location: Set a custom destination for the match winner per room, or let them stay in the room. - Configurable End Delay: A customizable delay after the match ends before players are teleported out. Players are invulnerable and locked in the room during this period. - PvP Countdown: Visual countdown (Titles + Sounds) before combat begins with a configurable timer. - Hologram Support: Automatic holograms showing room name, player count and time remaining. Supports DecentHolograms and HolographicDisplays. - Per-Room Permissions: Enable or disable permission requirements per room. Rooms are public by default. - Anti-Escape System: Players cannot walk or teleport out of a room during active PvP. - Barrier Material: Configure a visible or invisible barrier material during countdowns. - Entry Titles & Sounds: Custom welcome titles, subtitles and sounds when entering a room region. - PlaceholderAPI: Full PAPI integration for holograms and messages. Supports both internal and global placeholders. - HEX Color Support: Use &#RRGGBB colors in messages and titles (1.16+). Falls back gracefully on older versions. - Multi-Language: 3 built-in language files (English, Spanish, French) with automatic config updater. - Folia Support: Full compatibility with Folia's regionized threading — all teleports and tasks use async-safe methods. - Config Auto-Updater: Detects outdated configs and updates them automatically without losing your settings.

Compatibility

| Software | Supported | |---|---| | Bukkit / Spigot / Paper / Purpur | | | Folia | | | Minecraft | 1.8.8 → 1.21.x+ |

Main Commands

`/xrooms gui` (aliases: /xr, /rooms, /room) Opens the room management GUI to browse and configure all rooms. `/xrooms create <name>` Creates a new room using your current WorldEdit selection. `/xrooms delete <name>` Permanently deletes a room and its configuration file. `/xrooms edit <name> <option> [value]` Edit a room property directly from chat. Options: name, permission, min-players, max-players, pvp-duration, sound-entry, sound-kill, title, subtitle, winner-location. `/xrooms redefine <name>` Updates a room's region to your current WorldEdit selection. `/xrooms tp <name>` Teleports you to the center of a room. `/xrooms reload` Reloads the plugin configuration and language files. `/xrooms help` Displays the complete help menu.

Permissions

- *`xrooms.admin.`* - Full administrative access to all commands. (default: op)* - `xrooms.admin.create` - Create new rooms. (default: op) - `xrooms.admin.delete` - Delete existing rooms. (default: op) - `xrooms.admin.edit` - Edit room properties. (default: op) - `xrooms.admin.gui` - Open the management GUI. (default: op) - `xrooms.admin.tp` - Teleport to rooms. (default: op) - `xrooms.admin.reload` - Reload the plugin. (default: op) - `xrooms.player.<room>` - Enter a specific room (only when require-permission: true). (default: op) - *`xrooms.player.`* - Enter all rooms. (default: op)*

Tip: Rooms have require-permission: false by default, meaning all players can enter. Set it to true in the room config to restrict access.

Default Configuration

config-version: 1
prefix: "&8[&bX-Rooms&8]&r "
language: "en"  # Available: es, en, fr

room-settings:
  use-own-inventory: false     # false = backup & replace with room kit
  start-countdown: 3           # seconds before PvP starts
  barrier-material: "AIR"      # AIR, BARRIER, RED_STAINED_GLASS
  restore-on-quit: true        # restore inventory on disconnect
  entry-title-cooldown: -1     # -1 = always show
  end-delay: 3                 # seconds before teleporting players out after match
  abilities-level-limit:
    strength: 5
    speed: 5
    resistance: 5
    haste: 5
    regeneration: 5
    fire_resistance: 5
    jump: 5
    saturation: 5
    absorption: 5
    fly: 1

holograms:
  provider: "AUTO"             # AUTO, DecentHolograms, HolographicDisplays
  default-lines:
    - "&b&l{name}"
    - "&7Players: &f{players}/{max}"

<br> </div>