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 - **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> ` | Send a duel request | hypeduels.duel | | `/duel accept` | Accept incoming request | hypeduels.duel | | `/duel deny` | Deny incoming request | hypeduels.duel | | `/duel queue ` | Join the matchmaking queue | hypeduels.queue | | `/duel leave` | Leave queue or stop spectating | everyone | | `/duel stats ` | 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`