HypeDuels

⚔ 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

- Fully Configurable — 7 separate menus handle every part of the duel experience. Players never need to type a command beyond `/duel`. - Fully Configurable — K-factor based ELO system. Win against stronger opponents for bigger gains. Configurable starting ELO, K-factor, and minimum floor. - Fully Configurable — Sword, UHC, Combo, Axe, Sumo, and Bow — all balanced and ready to use out of the box. - Fully Configurable — Admins can save any inventory layout as a kit with `/hypeduels kit create <name>`. - Fully Configurable — Create as many arenas as you want. When multiple arenas are available, players choose through a GUI. - Fully Configurable — Players join a per-kit queue and get matched automatically every 2 seconds. - Fully Configurable — Watch live duels through the Active Duels GUI, or click any duel to spectate instantly. - Fully Configurable — 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. - Fully Configurable — All YAML file I/O happens off the main thread. Stats are cached in memory and saved in the background. - Fully Configurable — 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:

- Active Duels → Pick a player from the online player list → Choose a kit → Choose an arena (if multiple exist) → Request is sent automatically - Active Duels → Choose a kit → You are placed in the matchmaking queue → Duel starts when a match is found - Active Duels → View your ELO rank, wins, losses, K/D ratio, and total duels - Active Duels → 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

- Server: 1.21.4 - Server: 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