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 (optional).: Prevent clan members from fighting each other
• DeluxeCombat (optional): 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

Permission Description
pvproom.admin Full access to creation, editing, and admin commands. (Default: OP)
staff.room Allows staff to enter arenas in spectator/staff mode without occupying a player slot and without interfering in the match.

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 &).