X-Rooms

📝 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

- Config Auto-Updater: Select a region with WorldEdit/FAWE and instantly create a PvP room with `/xr create`. - Config Auto-Updater: Edit every room property (name, sounds, abilities, equipment, rewards) from a clean visual interface — no config editing needed. - Config Auto-Updater: Strength, Speed, Resistance, Haste, Regeneration, Fire Resistance, Jump Boost, Saturation, Absorption, and Fly — each with adjustable levels per room. - Config Auto-Updater: Set global maximum levels for each ability in `config.yml` to prevent overpowered setups. - Config Auto-Updater: Define kit items players receive on match start and reward items for the winner, all via GUI. - Config Auto-Updater: Player inventories are backed up and restored automatically. No items lost. - Config Auto-Updater: Configurable punishment for players who disconnect during PvP — keep or delete their backup inventory. - Config Auto-Updater: Set a custom destination for the match winner per room, or let them stay in the room. - Config Auto-Updater: A customizable delay after the match ends before players are teleported out. Players are invulnerable and locked in the room during this period. - Config Auto-Updater: Visual countdown (Titles + Sounds) before combat begins with a configurable timer. - Config Auto-Updater: Automatic holograms showing room name, player count and time remaining. Supports DecentHolograms and HolographicDisplays. - Config Auto-Updater: Enable or disable permission requirements per room. Rooms are public by default. - Config Auto-Updater: Players cannot walk or teleport out of a room during active PvP. - Config Auto-Updater: Configure a visible or invisible barrier material during countdowns. - Config Auto-Updater: Custom welcome titles, subtitles and sounds when entering a room region. - Config Auto-Updater: Full PAPI integration for holograms and messages. Supports both internal and global placeholders. - Config Auto-Updater: Use `&#RRGGBB` colors in messages and titles (1.16+). Falls back gracefully on older versions. - Config Auto-Updater: 3 built-in language files (English, Spanish, French) with automatic config updater. - Config Auto-Updater: 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.player.<room>` - Create new rooms. *(default: op)* - `xrooms.player.<room>` - Delete existing rooms. *(default: op)* - `xrooms.player.<room>` - Edit room properties. *(default: op)* - `xrooms.player.<room>` - Open the management GUI. *(default: op)* - `xrooms.player.<room>` - Teleport to rooms. *(default: op)* - `xrooms.player.<room>` - 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

```yaml 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}" ```