Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
Licensed ARR
Published 4 months ago
** UltimateDuels Plugin - Complete Description
๐ฎ Plugin Overview
UltimateDuels is a professional-grade, competitive dueling plugin designed for Minecraft 1.21.1 through 1.21.x servers running on Paper. It provides a complete PvP ecosystem including ranked duels, Free-For-All arenas, party battles, and a sophisticated matchmaking system.
Key Highlights:
- Multi-Round Combat System - Configurable 1-20 rounds per duel
- Complete Kit Management - Full inventory, armor, and offhand serialization
- Schematic Arena Restoration - Automatic arena regeneration using WorldEdit/FAWE
- Party System - Team battles with Party vs Party and Party Split modes
- FFA Arenas - Kit-specific Free-For-All combat zones
- Custom Lobby - Dedicated world with interactive hotbar items
๐ Core Features
- Duel Modes
| Mode | Description | Players |
|---|---|---|
| 1v1 Duel | Classic solo dueling | 2 players |
| Party vs Party | Team battles between parties | 2-10+ players |
| Party Split | Internal scrimmage (Red vs Blue) | 2-10+ players |
| FFA (Free For All) | Unlimited players in kit-specific arenas | Unlimited |
- Queue System
| Feature | Description |
|---|---|
| Kit-Based Queue | Players queue by selecting a specific kit |
| Real-Time Display | Shows "In Queue: X" and "Fighting: Y" per kit |
| Smart Matchmaking | Automatically pairs queued players |
| Party Queue | Leaders can queue entire parties |
- Multi-Round System
| Setting | Options |
|---|---|
| Rounds | 1 to 20 configurable rounds |
| Win Conditions | "Best Of" (first to majority) or "Play All" (all rounds) |
| Round Reset | Instant heal, kit restore, position reset |
| Score Tracking | Real-time scoreboard updates |
๐ Detailed Feature Breakdown
๐ฏ Kit System
Admin Standard Kits
- Created by administrators via commands
- Server-wide availability
- Examples: NoDebuff, Sumo, Diamond, Archer, UHC, Build UHC
Player Custom Kits
- Personal kit variants based on admin kits
- Customizable through Kit Editor GUI
- Saved per-player in YAML files
Kit Serialization (Critical Feature)
Full Inventory Serialization:
โโโ Main Inventory (36 slots)
โโโ Armor Slots (4 slots)
โ โโโ Helmet
โ โโโ Chestplate
โ โโโ Leggings
โ โโโ Boots
โโโ Offhand Slot (1 slot) โ CRUCIAL
โโโ Shields, Totems, Food, etc.
Kit Editor GUI
- Visual inventory editor
- Dedicated offhand slot representation
- Drag-and-drop item placement
- Real-time preview
๐๏ธ Arena System
Arena Types
| Type | Purpose | Regeneration |
|---|---|---|
| Duel Arenas | 1v1 and Party battles | After each match |
| FFA Arenas | Free-For-All combat | On server restart |
Arena Components
Arena Structure:
โโโ Name & ID
โโโ Arena Type (DUEL / FFA)
โโโ Spawn Points
โ โโโ Position 1 (Player/Team 1)
โ โโโ Position 2 (Player/Team 2)
โโโ Schematic File
โโโ Assigned Kit (FFA only)
โโโ State (AVAILABLE / IN_USE / REGENERATING)
Schematic Integration
- WorldEdit/FAWE Support - Async schematic operations
- Auto-Paste - Automatic arena restoration after matches
- Performance Optimized - Non-blocking regeneration
๐ Lobby System
Custom Lobby World
- Separate world/spawn for duelists
- Protected environment (no PvP, no block breaking)
- Dedicated spawn point
Hotbar Items (Locked/Saved)
| Slot | Item | Action |
|---|---|---|
| 1 | โ๏ธ Diamond Sword | Open Queue/Duel Menu |
| 2 | ๐ญ Spyglass | Open Party Menu |
| 3 | ๐ Book | Open Kit Editor |
| 4 | ๐ Totem of Undying | Open FFA Menu |
| 5 | โ๏ธ Comparator | Open Settings Menu |
โ๏ธ Combat Loop (Multi-Round)
Phase 1: Duel Start
1. Players teleported to arena spawn points
2. Kit applied (Inventory + Armor + Offhand)
3. Players frozen (movement disabled)
4. Countdown: 3... 2... 1... FIGHT!
5. Players unfrozen, PvP enabled
Phase 2: Round End (Death)
1. Death detected
2. Death message broadcast
3. Score updated
4. Check win condition:
โโโ If match continues:
โ โโโ Instant reset (heal, clear, restore kit)
โ โโโ Teleport to spawn points
โ โโโ Countdown: 3... 2... 1... FIGHT!
โ โโโ Next round begins
โโโ If match ends:
โโโ VICTORY/DEFEAT titles
โโโ 3-second celebration
โโโ Stats updated
โโโ Teleport to lobby
โโโ Arena queued for regeneration
Phase 3: Post-Match
1. Winner gets VICTORY title
2. Loser gets DEFEAT title
3. Loser becomes spectator (3 seconds)
4. Both teleported to lobby
5. Arena schematic pasted (async)
6. Arena marked AVAILABLE
๐ฅ Party System
Party Structure
Party:
โโโ Leader (1 player)
โ โโโ Full control: invite, kick, disband, queue
โโโ Members (up to 9 players)
โ โโโ Can leave, view members
โโโ Pending Invites
โโโ Expire after 60 seconds
Party Modes
Party vs Party:
- Two party leaders queue
- Full team vs team battle
- All members participate
Party Split:
- Single party splits into teams
- Red Team vs Blue Team
- Internal scrimmage mode
- Great for practice/training
๐ฏ FFA (Free For All) System
FFA Characteristics
- Kit-Specific Arenas - Each FFA arena tied to one kit
- No Teams - Every player for themselves
- Instant Action - No countdown, immediate PvP
- Respawn System - Death sends to lobby, re-enter via Totem
FFA Flow
1. Player clicks Totem in lobby
2. FFA Menu opens (kit/arena selection)
3. Player selects kit (e.g., "Sumo FFA")
4. Teleported to FFA arena
5. Kit applied
6. Immediate PvP enabled
7. On death: Teleport to lobby
8. To rejoin: Use Totem again
๐ Scoreboard System
Lobby Scoreboard
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ โ ULTIMATE DUELS โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ Player: Steve โ
โ โ
โ Kills: 150 โ
โ Deaths: 45 โ
โ K/D: 3.33 โ
โ Streak: 12 โ
โ โ
โ Online: 64 โ
โ Fighting: 24 โ
โ โ
โ play.yourserver.com โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
In-Duel Scoreboard
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ โ ULTIMATE DUELS โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ Kit: NoDebuff โ
โ Round: 3/5 โ
โ โ
โ You: Steve โ
โ Ping: 24ms โ
โ โ
โ Enemy: Alex โ
โ Ping: 31ms โ
โ โ
โ Score: 2 - 1 โ
โ โ
โ play.yourserver.com โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
FFA Scoreboard
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ โ FFA - SUMO ARENA โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ Player: Steve โ
โ Kills: 7 โ
โ Deaths: 2 โ
โ โ
โ Players: 12 โ
โ โ
โ play.yourserver.com โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
๐๏ธ Spectator System
Spectator Features
- Post-Match Spectating - Losers spectate for 3s before lobby
- External Spectating - Players can spectate via GUI
- Invisible Mode - Spectators invisible to duelists
- Flight Enabled - Free movement around arena
- No Interaction - Cannot affect duel
Spectator GUI
- Lists all active duels
- Shows players, kit, arena, round
- Click to spectate any duel
โ๏ธ Settings System
Player Settings (Toggle)
| Setting | Description | Default |
|---|---|---|
| Scoreboard | Show/hide scoreboard | ON |
| Death Messages | Receive death notifications | ON |
| Duel Requests | Accept incoming duel requests | ON |
| Party Invites | Accept party invitations | ON |
| Spectators | Allow others to spectate you | ON |
| Private Mode | Hide from spectator list | OFF |
๐ Statistics System
Tracked Statistics
| Statistic | Description |
|---|---|
| Kills | Total kills across all modes |
| Deaths | Total deaths across all modes |
| K/D Ratio | Calculated kill/death ratio |
| Wins | Total duel wins |
| Losses | Total duel losses |
| Win Rate | Percentage of duels won |
| Current Streak | Active win streak |
| Best Streak | Highest win streak achieved |
| Games Played | Total duels participated |
| FFA Kills | Kills in FFA arenas |
Leaderboards
- Top kills
- Best K/D ratio
- Highest win streak
- Most wins
๐ฆ Dependencies & Requirements
Required Dependencies
| Dependency | Purpose | Version |
|---|---|---|
| Paper | Server software | 1.21.1 - 1.21.x |
| WorldEdit or FAWE | Schematic operations | Latest |
| PlaceholderAPI | Placeholder support | 2.11+ |
Optional Dependencies
| Dependency | Purpose |
|---|---|
| Vault | Economy integration (future) |
| LuckPerms | Permission management |
Storage Requirements
| Storage | Purpose |
|---|---|
| MySQL | Player statistics (persistent) |
| YAML | Configuration, arenas, kits |
| File System | Schematics, player data |
๐ฎ Use Cases
Use Case 1: Server Owner Setup
1. Install plugin and dependencies
2. Configure config.yml (database, lobby world)
3. Create arenas (/arena create <name>)
4. Set spawn points (/arena setspawn pos1/pos2)
5. Save schematics (/arena save)
6. Create kits (/kit create <name>)
7. Set lobby spawn (/duels setlobby)
8. Reload plugin (/duels reload)
Use Case 2: Player Joining
1. Player joins server
2. Auto-teleported to lobby (if enabled)
3. Receives locked hotbar items
4. Lobby scoreboard appears
5. Player can:
โโโ Queue for duel (Sword)
โโโ Manage party (Spyglass)
โโโ Edit kits (Book)
โโโ Join FFA (Totem)
โโโ Change settings (Comparator)
Use Case 3: 1v1 Duel
1. Player A: /duel PlayerB
2. Duel Request GUI opens
3. Player A selects: Kit, Arena, Rounds (5), Win Condition (Best Of)
4. Player B receives request
5. Player B accepts
6. Both teleported to arena
7. Kits applied
8. Countdown: 3... 2... 1... FIGHT!
9. Combat begins
10. Rounds continue until first to 3 wins
11. VICTORY/DEFEAT titles
12. Teleport to lobby
13. Arena regenerates
Use Case 4: Party Battle
1. Player A: /party create
2. Player A: /party invite PlayerB PlayerC
3. Players B & C accept
4. Player A (leader) opens Queue Menu
5. Selects "Party Queue"
6. Another party queues
7. Both parties matched
8. Team 1 vs Team 2
9. Last team standing wins
Use Case 5: FFA Session
1. Player clicks Totem in hotbar
2. FFA Menu opens
3. Player selects "Diamond FFA"
4. Teleported to Diamond FFA arena
5. Kit applied
6. Immediate PvP (no countdown)
7. Player fights others
8. On death: Teleport to lobby
9. To continue: Click Totem again
๐ Commands Reference
Player Commands
| Command | Description | Permission |
|---|---|---|
/duel <player> |
Challenge player to duel | ultimateduels.duel |
/accept |
Accept duel request | ultimateduels.duel |
/deny |
Deny duel request | ultimateduels.duel |
/stats [player] |
View statistics | ultimateduels.stats |
/leaderboard |
View leaderboards | ultimateduels.leaderboard |
Party Commands
| Command | Description | Permission |
|---|---|---|
/party create |
Create new party | ultimateduels.party |
/party invite <player> |
Invite player | ultimateduels.party |
/party accept |
Accept invitation | ultimateduels.party |
/party leave |
Leave party | ultimateduels.party |
/party disband |
Disband party (leader) | ultimateduels.party |
/party kick <player> |
Kick member (leader) | ultimateduels.party |
/party list |
List members | ultimateduels.party |
Admin Commands
| Command | Description | Permission |
|---|---|---|
/duels admin |
Admin panel | ultimateduels.admin |
/duels setlobby |
Set lobby spawn | ultimateduels.admin |
/duels reload |
Reload configuration | ultimateduels.admin |
/duels forceend |
Force end a duel | ultimateduels.admin |
/arena create <name> |
Create arena | ultimateduels.admin |
/arena delete <name> |
Delete arena | ultimateduels.admin |
/arena setspawn <pos> |
Set spawn point | ultimateduels.admin |
/arena save |
Save schematic | ultimateduels.admin |
/arena list |
List arenas | ultimateduels.admin |
/kit create <name> |
Create kit | ultimateduels.admin |
/kit delete <name> |
Delete kit | ultimateduels.admin |
/kit edit <name> |
Edit kit | ultimateduels.admin |
/kit give <player> <kit> |
Give kit | ultimateduels.admin |
๐ Complete Summary
UltimateDuels at a Glance
| Category | Details |
|---|---|
| Plugin Name | UltimateDuels |
| Version | 3.0.0 |
| MC Versions | 1.21.1 - 1.21.x |
| Server Software | Paper (required) |
| Game Modes | 1v1, Party vs Party, Party Split, FFA |
| Round System | 1-20 rounds, Best Of / Play All |
| Kit System | Admin + Player Custom, Full Offhand Support |
| Arena System | Auto-regeneration via WorldEdit/FAWE |
| Queue System | Kit-based, Real-time statistics |
| Party System | Up to 10 players, Split mode |
| Statistics | MySQL storage, Full tracking |
| Scoreboards | Lobby, Duel, FFA, Spectator |
| GUIs | Full inventory-based interface |
| Localization | Full messages.yml customization |
Feature Completeness
| Feature | Status |
|---|---|
| โ Multi-Round Duels | Complete |
| โ Offhand Kit Support | Complete |
| โ Schematic Regeneration | Complete |
| โ Party System | Complete |
| โ FFA Arenas | Complete |
| โ Queue System | Complete |
| โ Statistics & Leaderboards | Complete |
| โ Custom Lobby | Complete |
| โ Scoreboard System | Complete |
| โ Settings System | Complete |
| โ Spectator System | Complete |
| โ PlaceholderAPI Integration | Complete |
**