📝 Description

X-Rooms is a powerful, all-in-one plugin for creating and managing PvP rooms (BoxPVP) on your server. Define combat zones with WorldEdit, set up custom kits, potion effects, rewards, holograms and winner destinations — all from an intuitive in-game GUI. Compatible with Minecraft 1.8.8 to 1.21.x+.

✨ 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}"