UltimateDuels

** 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 1. 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 | 2. 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 | 3. 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