PvP+
A PvP Plugin with duels, parties, arenas (that regenerate), kits, matchmaking, and spectating.
⚔ PvP+
A fully featured PvP plugin for Paper 1.21.1 - duels, parties, arenas, kits, matchmaking, and spectating. Built for competitive servers that want a complete out-of-the-box pvp plugin without bloat.
✨ Features at a Glance
| System | What it does |
|---|---|
| 🏟 Arenas | Admin-defined cuboid arenas with full block snapshot & restore |
| 🔄 Arena Regeneration | Regenerates the Arena after every fight |
| 🎒 Kits | NBT-accurate kit capture from inventory, with icons and round defaults |
| 👥 Parties | Full party system with chat, invites, and party-vs-party duels |
| ⚔ Duels | 1v1 challenges with configurable kit, arena, and round count via GUI |
| 🎯 Queue | Kit-based matchmaking — join a queue and get matched automatically |
| 👁 Spectating | Watch live fights from inside the arena bounds |
| 📊 Scoreboards | Live round/score sidebar during every fight |
| 📋 Fight Summary | Post-fight chat recap with kills, score, and winner |
🏟 Arena System
Admins define arenas by walking to positions in-world with ABSOLUTELY NO coordinate typing required.
/arena create <name> Start setup
/arena setpos1 Set corner 1 (stand at position)
/arena setpos2 Set corner 2 (stand at position)
/arena addspawn1 Add a Team 1 spawn point
/arena addspawn2 Add a Team 2 spawn point
/arena save Capture blocks and save
/arena restore <name> Manually restore arena blocks
/arena delete <name> Delete an arena
/arena list List all arenas and their status
Every arena saves a full block snapshot on creation. When a fight ends, every block — including block states like door orientation, slab type, and stair facing: is restored exactly as it was. Arenas persist across restarts.
🎒 Kit System
Kits capture your entire inventory. This means shulker box contents, bundle contents, enchantments, and custom item data are all preserved.
/kit create <name> Create a new empty kit
/kit save <name> Snapshot your current inventory into the kit
/kit load <name> Apply a kit to your inventory to preview it
/kit icon <name> Set the kit's GUI icon to your held item
/kit rounds <name> <n> Set the default number of rounds for this kit
/kit delete <name> Delete a kit
/kit list List all kits
/kit config <name> (Extensible) Open kit configuration
Kits are stored in plugins/pvp-plus/kits/admin/ and kits/player/ as .kit files.
⚔ Duel System
Challenge any player to a configurable duel. Duels go through a GUI configuration screen where the challenger picks:
- Kit — kit browser with icons
- Rounds — left/right click to adjust (defaults to kit's setting)
- Arena — arena browse
/duel <player> Open duel config GUI targeting that player
/duel accept Accept a pending duel request
/duel deny Deny a pending duel request
/duel toggle Toggle whether you receive duel requests
Requests expire after 30 seconds automatically.
👥 Party System
Full party support with leader controls, party chat, and more.
/party create Create a new party (you become leader)
/party invite <player> Invite a player
/party accept Accept a party invite
/party deny Deny a party invite
/party kick <player> Kick a member (leader only)
/party leave Leave the party
/party disband Disband the party (leader only)
/party list Show all members and their online status
/party chat Toggle party chat mode for yourself
Party Combat
/party duel <leader> Challenge another party — opens config GUI
/party duel accept Accept an incoming party duel challenge
/party duel deny Deny a party duel challenge
/party split Split party into two random teams — opens config GUI
/party ffa Every member fights solo — opens config GUI
Split randomly divides the party into two even teams. FFA makes every member their own team - last one standing wins.
🎯 Queue System
Kit-based matchmaking. Players join a queue for a specific kit and are automatically matched when another player joins the same queue.
/queue Open the queue GUI
The Queue GUI shows all available kits with:
- Player count as the item stack size
- Enchanted glow when someone is already waiting
- Live queue size in the item lore
🎮 Fight System
Every fight — whether a duel, party duel, split, FFA, or queue match — goes through the same engine:
Flow
- Both teams are teleported to their spawn points in the arena
- A 3-second countdown plays as a title — players are frozen
- On FIGHT!, players are unfrozen and combat begins
- On death, the player enters spectator mode for that round
- When all members of a team are eliminated, the round winner is announced
- After all rounds, the fight winner is announced with a full summary
Rounds
Fights use a best-of system - the first team to win the majority of rounds wins the fight. Round scores are displayed on a live sidebar scoreboard.
Forfeit
/leavefight Forfeit the current fight or leave spectator mode
Forfeiting removes you from the fight immediately, notifies all participants, and if you were the last member of your team the other team wins.
👁 Spectating
/spectate <player> Spectate a player's current fight
/leavefight Stop spectating
Spectators are placed in Spectator mode inside the arena. Movement is bounded to the arena box — spectators cannot fly outside the fight area. The live scoreboard is shown to spectators as well.
🔧 Requirements
| Requirement | Version |
|---|---|
| Server | Paper |
| Minecraft version | 1.21.1 |
| Java | 21+ |
🚧 Planned / In Progress
- Statistics tracking (kills, wins, K/D per player)
- Fight history logs
- Leaderboards
- Player kit creation
- Kit configuration (custom options per kit)
- Lobby/spawn location configuration
- Per-kit queue ranked matching
- ELO based queue
- Kiteditor
- Custom site to show rankings
📄 License
MIT — free to use, modify, and distribute.
