X-Rooms

<div align="center"> (https://img.shields.io/badge/Available%20on-Spigot-orange?style=for-the-badge&logo=spigotmc&logoColor=white)](https://www.spigotmc.org/resources/134537/) (https://img.shields.io/badge/Wiki-Documentation-blue?style=for-the-badge&logo=readme&logoColor=white)](https://xproyects.qzz.io) (https://img.shields.io/badge/Discord-Community-7289da?style=for-the-badge&logo=discord&logoColor=white)](https://discord.xproyects.qzz.io/) # **X-Rooms** ### *Advanced BoxPVP room management for your server* </div> ### 📝 **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** | 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> `** 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 al