WederPVPRooms

WederPvPRooms is an advanced PvP arena system designed for servers that want automatic duels, team battles and clan wars without requiring players to manually organize every match.
Create arenas using an in-game selection wand, configure them through interactive menus and let players join simply by walking into the arena or using commands.
WederPvPRooms supports everything from 1v1 duels up to 10v10 battles, with automatic countdowns, sealed arenas, spectators, kits, rewards, potion effects, statistics, rankings and a complete betting system.
For clan servers, dedicated CLAN rooms allow two clans to challenge each other and automatically select and teleport their fighters.

• 1v1 - 10v10 PvP Rooms
  Create NORMAL PvP rooms with configurable team sizes, minimum players, countdowns and match duration.
• Clan Wars
  Create dedicated CLAN rooms where clans can challenge each other through an invitation and acceptance system.
• Walk-In Arenas
  Players can automatically join a room simply by entering its arena or a linked WorldGuard region.
• Automatic Matches
  When the minimum number of players is reached, WederPvPRooms automatically starts a countdown using titles, Action Bars and sounds.
• Last Team Standing
  The match continues until only one team remains alive.
• Sealed Arenas
  When combat starts, configured entrances are automatically closed and empty spaces in the arena walls and ceiling can be filled.
  When the battle finishes, the arena returns to its original state.
• Selection Wand
  Create arenas directly in-game by selecting two opposite corners with the WederPvPRooms wand.
• Configurable Kits
  Each room can have its own optional combat kit.
  Player inventories are saved to disk before the battle, allowing them to be restored even after an unexpected server shutdown.
• Custom Rewards
  Configure items that every winner receives after a match.
  If the player's inventory is full, rewards are safely dropped at their feet.
• Team Betting System
  Players can bet money on either team through an interactive GUI.
  Betting includes live pools, fixed odds when the bet is placed and a configurable house percentage using Vault.
• 21 Potion Effects
  Configure room-specific potion effects with levels from 1 to 5.
• Statistics System
  Track wins, kills, deaths, K/D ratio and current winning streaks.
• Interactive Top Ranking
  /wprooms top opens a visual podium containing the heads of the highest-ranked players.
• Spectator System
  Players can spectate active rooms from a configurable spectator location.
• Interactive Room Editor
  Configure rooms through /wprooms edit without manually editing every value in configuration files.
• WorldGuard Support
  Link rooms to WorldGuard regions and optionally use region entry to automatically join matches.
• Clan Plugin Support
  Integrates with multiple popular clan, faction, guild and team systems.
• PlaceholderAPI Support
  Use player statistics, rankings and current-room information anywhere PlaceholderAPI is supported.
• 7 Languages
  Built-in support for Spanish, English, French, Portuguese, Italian, German and Russian.
• SQLite Storage
  Statistics are stored locally using SQLite. No external MySQL server is required.
• Full Tab Completion
  Commands and available options include Tab completion.

WederPvPRooms provides two main room types:
NORMAL
Designed for regular PvP battles.
Depending on the configured team size, you can create:
Players can enter manually with:
or simply walk into the arena when Walk-In Join is enabled.
CLAN
Designed specifically for clan wars.
A clan can challenge another clan using:
The challenged clan can accept with:
WederPvPRooms then selects players up to the configured team size.
The player who sent the challenge and the player who accepted it are always included, while the remaining available fighters are selected automatically.
After the configured delay, both teams are teleported into the arena and the clan battle begins.
Rooms can be built directly inside your existing Minecraft worlds.
When a match starts, WederPvPRooms can automatically seal the combat area.
The Custom Block defines the arena entrances.
The Door Material determines which block replaces those entrances and fills open spaces in the walls and ceiling during combat.
Example:
Outside a match, players can walk through the carpet entrance.
Once combat begins, the entrance becomes an invisible barrier and the arena is sealed.
When the match finishes, the original blocks are automatically restored.
Each room can have its own configurable kit.
When kits are enabled:

• The player's original inventory is saved.
• The inventory is cleared.
• The configured PvP kit is given.
• The battle takes place normally.
• The player's original inventory is restored afterward.

Saved inventories are written to disk, providing additional protection if the server unexpectedly shuts down during a match.
If the kit system is enabled but the configured kit is empty, players fight with empty inventories.
Rewards can also be configured separately for each room.
Every winner receives the configured reward items after the match.
With Vault and a compatible economy plugin installed, WederPvPRooms provides a complete team betting system.
Players can open the betting menu with:
The GUI displays both teams and the current betting pool.
Players select a team and enter their desired amount directly through chat.
Odds are calculated using the total betting pool, the amount placed on each team and the configured house percentage.
The odds are locked when the player places the bet.
If the selected team wins, the reward is calculated using the amount wagered and the locked odds.
If the match ends in a draw, is cancelled or reaches its time limit, bets are refunded.
WederPvPRooms tracks player performance automatically.
Available statistics include:

• Wins
• Kills
• Deaths
• K/D Ratio
• Current Streak
• Normal Room statistics
• Clan Room statistics

Players can view their statistics with:
Rankings are available through:
The ranking GUI displays a visual podium using player heads.
Administrators can configure rooms directly in-game using:
The editor provides access to room configuration including:

• Room type
• Team size
• Minimum players
• Maximum match duration
• Start countdown
• Winner delay
• Enabled / Disabled status
• Kit
• Rewards
• Potion effects
• Custom entrance block
• Door material
• Keep Inventory
• Friendly Fire
• Betting mode
• Message channels

Kit and reward editors use paginated inventories where administrators can add items directly from their own inventory.
The interface also supports optional Tiny Font formatting.
Optional integrations:

• PlaceholderAPI — Statistics, rankings and room placeholders.
• Vault — Economy integration for the betting system.
• WorldGuard — Link rooms to regions and use region entry triggers.

Supported clan/team systems include:

• ApexClan
• SimpleClans
• Factions / FactionsUUID / SaberFactions
• Towny
• Guilds
• BetterTeams
• KingdomsX
• Parties
• Vanilla Minecraft Teams (/team)

Main Command:
Aliases:
PLAYER COMMANDS
/wprooms join <room> — Join a PvP room.
/wprooms leave — Leave the current room. Leaving during combat counts as a defeat.
/wprooms spectate <room|leave> — Spectate a room or leave spectator mode.
/wprooms bet <room> — Open the betting menu.
/wprooms stats [player] — View player statistics.
/wprooms top [all|normal|clan] — Open the ranking podium.
/wprooms invite <room> <clan> — Challenge another clan.
/wprooms accept <room> — Accept a clan challenge.
ADMIN COMMANDS
/wprooms create <room> <NORMAL|CLAN> — Create a room using your current wand selection.
/wprooms delete <room> — Delete a room.
/wprooms edit [room] — Open the room editor.
/wprooms wand — Receive the arena selection wand.
/wprooms setarena <room> — Replace the arena selection of an existing room.
/wprooms setregion <room> <region|none> — Link or unlink a WorldGuard region.
/wprooms pos1 <room> — Set Team 1 spawn.
/wprooms pos2 <room> — Set Team 2 spawn.
/wprooms setspectate <room> — Set spectator spawn.
/wprooms setspawn — Set the global return spawn.
/wprooms save [positions|arena|all] — Save room data.
/wprooms start <room> — Force-start a match.
/wprooms stop <room> — Cancel an active match.
/wprooms reload — Reload configuration, languages and rooms.
Default: everyone
Allows players to join and leave rooms, spectate, bet, view statistics and rankings, and use clan challenges.
Default: OP
Allows administrators to create, edit and manage PvP rooms.
Default: OP
Bypasses blocked-command restrictions and inventory restrictions inside rooms.
Supported PlaceholderAPI prefixes:
Available placeholders include:
Available ranking columns:

Component	Required	Notes
Spigot / Paper	Yes	Minecraft 1.19 - 1.21+
Java	Yes	Java 17+
PlaceholderAPI	No	Required only for placeholders.
Vault	No	Required for economy-based betting.
WorldGuard	No	Required for WorldGuard region integration.
Clan Plugin	No	Required only when using its corresponding clan integration.

1. Download WederPvPRooms.jar.
2. Place the plugin inside your server's plugins/ folder.
3. Optionally install Vault, PlaceholderAPI, WorldGuard or a supported clan plugin.
4. Start or restart your server.
5. WederPvPRooms automatically generates:
   
   Code (Text):

   
   config.yml
   rooms.yml
   lang/
   database.db
    
6. Create your first arena using:
   
   Code (Text):

   
   /wprooms wand
    
7. Select two opposite corners.
8. Create the room:
   
   Code (Text):

   
   /wprooms create duel1 NORMAL
    
9. Configure Team 1, Team 2 and spectator positions:
   
   Code (Text):

   
   /wprooms pos1 duel1
   /wprooms pos2 duel1
   /wprooms setspectate duel1
    
10. Finish configuration through:
    
    Code (Text):

    
    /wprooms edit