Rooms v1.5.1

PvPRooms – Advanced PvP Room System


PvPRooms is an optimized plugin designed to manage team-based combat rooms (1v1, 2v2, 3v3, 4v4) with a visual configuration system using GUIs and in-game tools. Built for performance and ease of use.

Main Features​

Game Modes​

• Native support for 1v1, 2v2, 3v3, and 4v4 rooms.

Team System​

• Team selection (Red/Blue) through a GUI menu.
• Automatic start in 1v1 mode.
• Team balancing system.
• Friendly fire prevention.

🏟 Dynamic Arenas​

• Automatic Walls: Physical barriers (glass or custom material) generate when the room is completed.
• Protected Regions: Players cannot leave the combat zone while in a match.
• In-Game Editor: Configure region, wall, exit point, and wall material directly from a GUI menu with visual tools.

Optimization​

• Asynchronous statistics saving (no server freezing).
• Cached region boundaries to prevent heavy math calculations every tick.
• Automatic item cleanup after the match ends.

Integrations (Hooks)​

• PlaceholderAPI: Display statistics and leaderboards in scoreboards or holograms.
• UClans / UltimateClans: Prevent clan members from fighting each other (configurable).
• DeluxeCombat: Manages Combat Tag to avoid unfair penalties when entering/exiting rooms and re-enables it during fights.

🛠 Commands​

Main command: /pvproom (alias: /rooms)

• /pvproom help – Shows the list of available commands.
• /pvproom give – Gives you the selection axe to create regions.
• /pvproom create <name> <1v1|2v2|3v3|4v4> – Creates a new room with the current selection.
• /pvproom edit – Opens the GUI menu to edit, rename, or delete existing rooms.
• /pvproom menu – Opens the admin menu to enable/disable Hooks (Clans/DeluxeCombat).
• /pvproom setlobby – Sets the global return point (Lobby).
• /pvproom reload – Reloads the plugin configuration.

🛡 Permissions​

---

Placeholders (PlaceholderAPI Required)​

Player Statistics​

• %pvprooms_wins% – Player wins.
• %pvprooms_kills% – Player kills.
• %pvprooms_deaths% – Player deaths.

Top Rankings​

Format:
%pvprooms_top_<type><data><position>%

Types: kills, wins, deaths
Data: name (player name), value (amount)
Position: Number from 1 to 10

Examples:

• %pvprooms_top_kills_name_1% (Top 1 player with most kills)
• %pvprooms_top_kills_value_1% (Kill count of top 1)
• %pvprooms_top_wins_name_3% (Top 3 player in wins)

Configuration & Editing​

The plugin includes a visual editing system:

1. Use /pvproom edit to view your rooms.
2. Click a room to open its control panel.

From there you can:

• Redefine the combat region.
• Redefine the dividing wall.
• Change the exit (Kick) location.
• Change wall material: Select the option and drop the block you want to use as the wall material.
• Rename the room (supports color codes using &).