X-Rooms | Customs rooms for PvP [1.8.8 - 26.1+]

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+.

Key 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

• ✅ 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.