X-Rooms

Minecraft 版本： 1.8.8 1.8.9 1.9 1.9.1 1.9.2 1.9.3 1.9.4 1.10 1.10.1 1.10.2 1.11 1.11.1 1.11.2 1.12 1.12.1 1.12.2 1.13 1.13.1 1.13.2 1.14 1.14.1 1.14.2 1.14.3 1.14.4 1.15 1.15.1 1.15.2 1.16 1.16.1 1.16.2 1.16.3 1.16.4 1.16.5 1.17 1.17.1 1.18 1.18.1 1.18.2 1.19 1.19.1 1.19.2 1.19.3 1.19.4 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2 26.2

平台： bukkit folia paper purpur spigot

标签： minigame utility

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