# \u2694 HypeDuels<\/p>\n
**The most complete 1v1 duel plugin for Paper 1.21.4.**
\nChallenge players, pick your kit, fight in a dedicated arena, and climb the ELO leaderboard \u2014 all through a clean, fully interactive GUI.<\/p>\n
—<\/p>\n
## \u2728 What is HypeDuels?<\/p>\n
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 \u2014 no commands required to play.<\/p>\n
Every stat operation runs **asynchronously** so your main thread stays clean and your server stays fast.<\/p>\n
—<\/p>\n
## \ud83d\udd25 Key Features<\/p>\n
– **Full GUI System** \u2014 7 separate menus handle every part of the duel experience. Players never need to type a command beyond `\/duel`. —<\/p>\n ## \ud83d\udda5 GUI Flow<\/p>\n Opening `\/duel` shows the **Main Hub**. From there:<\/p>\n – **1v1 Duel** \u2192 Pick a player from the online player list \u2192 Choose a kit \u2192 Choose an arena (if multiple exist) \u2192 Request is sent automatically —<\/p>\n ## \ud83c\udf92 Built-in Kits<\/p>\n | Kit | Description | Kit icons and display names can be overridden in `config.yml` under `kit-display` without restarting the server.<\/p>\n —<\/p>\n ## \ud83d\udccb Commands<\/p>\n | Command | Description | Permission | —<\/p>\n ## \ud83d\udce6 Installation<\/p>\n 1. Download `HypeDuels.jar` and place it in your `\/plugins\/` folder. —<\/p>\n ## \ud83c\udf10 Platform Compatibility<\/p>\n | Platform | Status | —<\/p>\n ## \u2699 Requirements<\/p>\n – **Minecraft:** 1.21.4 —<\/p>\n *Found a bug or have a suggestion? Leave a comment below or open an issue on GitHub.*<\/p>\n **Made by xXantares_peek**<\/p>\n","protected":false},"excerpt":{"rendered":" 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.<\/p>\n","protected":false},"featured_media":82955,"template":"","meta":{"_minecraft_slug":"hypeduels","_minecraft_project_id":"Fbmqb9a9","_minecraft_author":"xXantares_peek","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":34,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"hypeduels.zip","_minecraft_size_bytes":100714,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:57:44.194158Z","_minecraft_date_created":"2026-03-21T23:14:17.085484Z","_minecraft_date_modified":"2026-03-21T20:42:09.936286Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/hypeduels","_minecraft_icon_attachment_id":82955,"_minecraft_imported_at":"2026-06-04T18:08:29+00:00","_minecraft_import_hash":"ff9b80ba79ee9a9c53dcfd6bd08d538d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,125,126,866,127,128,129],"mod_loader":[130,131,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-82954","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-folia","mod_category-management","mod_category-minigame","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– **ELO Rating** \u2014 K-factor based ELO system. Win against stronger opponents for bigger gains. Configurable starting ELO, K-factor, and minimum floor.
\n– **6 Built-in Kits** \u2014 Sword, UHC, Combo, Axe, Sumo, and Bow \u2014 all balanced and ready to use out of the box.
\n– **Custom Kits** \u2014 Admins can save any inventory layout as a kit with `\/hypeduels kit create
\n– **Multi-Arena Support** \u2014 Create as many arenas as you want. When multiple arenas are available, players choose through a GUI.
\n– **Matchmaking Queue** \u2014 Players join a per-kit queue and get matched automatically every 2 seconds.
\n– **Spectator Mode** \u2014 Watch live duels through the Active Duels GUI, or click any duel to spectate instantly.
\n– **Death \u2192 Spectator** \u2014 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.
\n– **Async Stats Storage** \u2014 All YAML file I\/O happens off the main thread. Stats are cached in memory and saved in the background.
\n– **Platform Support** \u2014 Works on Bukkit, Spigot, Paper, Purpur, Leaf, and Folia. Platform is detected automatically at startup.
\n– **Fully Configurable** \u2014 Change every message, sound, ELO value, kit icon, arena icon, timer, and countdown through `config.yml`.<\/p>\n
\n– **Queue** \u2192 Choose a kit \u2192 You are placed in the matchmaking queue \u2192 Duel starts when a match is found
\n– **Stats** \u2192 View your ELO rank, wins, losses, K\/D ratio, and total duels
\n– **Leaderboard** \u2192 See the top 10 players by ELO with player heads \u2014 click any entry to view their profile
\n– **Active Duels** \u2192 See every duel in progress and click one to spectate<\/p>\n
\n|—|—|
\n| \u2694 Sword | Iron sword, iron armor, 16x golden apples |
\n| \u2622 UHC | Diamond sword, bow, limited golden apples and food |
\n| \u26a1 Combo | Knockback sword, no armor \u2014 pure mechanical skill |
\n| \ud83e\ude93 Axe | Diamond axe + shield, diamond armor |
\n| \ud83e\udd4a Sumo | Knockback II stick \u2014 knock your opponent off the edge |
\n| \ud83c\udff9 Bow | Power IV bow + iron sword, leather armor |<\/p>\n
\n|—|—|—|
\n| `\/duel` | Open the main GUI | everyone |
\n| `\/duel
\n| `\/duel accept` | Accept incoming request | hypeduels.duel |
\n| `\/duel deny` | Deny incoming request | hypeduels.duel |
\n| `\/duel queue [kit]` | Join the matchmaking queue | hypeduels.queue |
\n| `\/duel leave` | Leave queue or stop spectating | everyone |
\n| `\/duel stats [player]` | View player statistics | hypeduels.stats |
\n| `\/duel top` | View the ELO leaderboard | everyone |
\n| `\/duel spectate
\n| `\/hypeduels reload` | Reload config | hypeduels.admin |
\n| `\/hypeduels arena create
\n| `\/hypeduels arena setspawn1
\n| `\/hypeduels arena setspawn2
\n| `\/hypeduels arena delete
\n| `\/hypeduels arena list` | List all arenas | hypeduels.admin |
\n| `\/hypeduels kit create
\n| `\/hypeduels kit delete
\n| `\/hypeduels kit list` | List all kits | hypeduels.admin |
\n| `\/hypeduels info` | Show plugin info and platform | hypeduels.admin |<\/p>\n
\n2. Start or restart your server. Config files are generated automatically.
\n3. In-game, run `\/hypeduels arena create arena1`.
\n4. Stand at your first spawn point and run `\/hypeduels arena setspawn1 arena1`.
\n5. Move to the second spawn point and run `\/hypeduels arena setspawn2 arena1`.
\n6. Type `\/duel` in-game \u2014 everything is ready.<\/p>\n
\n|—|—|
\n| Bukkit | Supported |
\n| Spigot | Supported |
\n| Paper | Recommended |
\n| Purpur | Supported |
\n| Leaf | Supported |
\n| Folia | Supported |<\/p>\n
\n– **Java:** 21 or higher
\n– **Server:** Paper or any Paper fork<\/p>\n