🚀 X-Rooms v1.4 - Changelog

✨ New Features

• New submenu for editing the title and subtitle.

🐛 Error Fixes

• Fixed compatibility with 26.1+

🚀 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

🛠️ 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}"