⚔ HypeDuels

The most complete 1v1 duel plugin for Paper 1.21.4. Challenge players, pick your kit, fight in a dedicated arena, and climb the ELO leaderboard — all through a clean, fully interactive GUI.

---

✨ What is HypeDuels?

HypeDuels is a professional duel plugin built from scratch for Paper 1.21.4 and Java 21. It brings everything a competitive Minecraft server needs: a challenge system, kit-based duels, multi-arena support, a per-kit matchmaking queue, full spectator mode, an ELO rating system, and a complete GUI interface — no commands required to play.

Every stat operation runs asynchronously so your main thread stays clean and your server stays fast.

---

🔥 Key Features

• Full GUI System — 7 separate menus handle every part of the duel experience. Players never need to type a command beyond /duel.
• ELO Rating — K-factor based ELO system. Win against stronger opponents for bigger gains. Configurable starting ELO, K-factor, and minimum floor.
• 6 Built-in Kits — Sword, UHC, Combo, Axe, Sumo, and Bow — all balanced and ready to use out of the box.
• Custom Kits — Admins can save any inventory layout as a kit with /hypeduels kit create <name>.
• Multi-Arena Support — Create as many arenas as you want. When multiple arenas are available, players choose through a GUI.
• Matchmaking Queue — Players join a per-kit queue and get matched automatically every 2 seconds.
• Spectator Mode — Watch live duels through the Active Duels GUI, or click any duel to spectate instantly.
• Death → Spectator — When a player dies in a duel, they respawn directly into spectator mode at the arena. After a configurable timer, they are returned to their original location with their inventory restored.
• Async Stats Storage — All YAML file I/O happens off the main thread. Stats are cached in memory and saved in the background.
• Platform Support — Works on Bukkit, Spigot, Paper, Purpur, Leaf, and Folia. Platform is detected automatically at startup.
• Fully Configurable — Change every message, sound, ELO value, kit icon, arena icon, timer, and countdown through config.yml.

---

🖥 GUI Flow

Opening /duel shows the Main Hub. From there:

• 1v1 Duel → Pick a player from the online player list → Choose a kit → Choose an arena (if multiple exist) → Request is sent automatically
• Queue → Choose a kit → You are placed in the matchmaking queue → Duel starts when a match is found
• Stats → View your ELO rank, wins, losses, K/D ratio, and total duels
• Leaderboard → See the top 10 players by ELO with player heads — click any entry to view their profile
• Active Duels → See every duel in progress and click one to spectate

---

🎒 Built-in Kits

Kit	Description
⚔ Sword	Iron sword, iron armor, 16x golden apples
☢ UHC	Diamond sword, bow, limited golden apples and food
⚡ Combo	Knockback sword, no armor — pure mechanical skill
🪓 Axe	Diamond axe + shield, diamond armor
🥊 Sumo	Knockback II stick — knock your opponent off the edge
🏹 Bow	Power IV bow + iron sword, leather armor

Kit icons and display names can be overridden in config.yml under kit-display without restarting the server.

---

📋 Commands

Command	Description	Permission
/duel	Open the main GUI	everyone
/duel <player> [kit]	Send a duel request	hypeduels.duel
/duel accept	Accept incoming request	hypeduels.duel
/duel deny	Deny incoming request	hypeduels.duel
/duel queue [kit]	Join the matchmaking queue	hypeduels.queue
/duel leave	Leave queue or stop spectating	everyone
/duel stats [player]	View player statistics	hypeduels.stats
/duel top	View the ELO leaderboard	everyone
/duel spectate <player>	Spectate an active duel	hypeduels.spectate
/hypeduels reload	Reload config	hypeduels.admin
/hypeduels arena create <n>	Create a new arena	hypeduels.admin
/hypeduels arena setspawn1 <n>	Set spawn 1 at your location	hypeduels.admin
/hypeduels arena setspawn2 <n>	Set spawn 2 at your location	hypeduels.admin
/hypeduels arena delete <n>	Delete an arena	hypeduels.admin
/hypeduels arena list	List all arenas	hypeduels.admin
/hypeduels kit create <n>	Save current inventory as kit	hypeduels.admin
/hypeduels kit delete <n>	Delete a kit	hypeduels.admin
/hypeduels kit list	List all kits	hypeduels.admin
/hypeduels info	Show plugin info and platform	hypeduels.admin

---

📦 Installation

1. Download HypeDuels.jar and place it in your /plugins/ folder.
2. Start or restart your server. Config files are generated automatically.
3. In-game, run /hypeduels arena create arena1.
4. Stand at your first spawn point and run /hypeduels arena setspawn1 arena1.
5. Move to the second spawn point and run /hypeduels arena setspawn2 arena1.
6. Type /duel in-game — everything is ready.

---

🌐 Platform Compatibility

Platform	Status
Bukkit	Supported
Spigot	Supported
Paper	Recommended
Purpur	Supported
Leaf	Supported
Folia	Supported

---

⚙ Requirements

• Minecraft: 1.21.4
• Java: 21 or higher
• Server: Paper or any Paper fork

---

Found a bug or have a suggestion? Leave a comment below or open an issue on GitHub.

Made by xXantares_peek