HypeDuels

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： bukkit folia paper purpur spigot

标签： adventure management minigame

⚔ 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 icons and display names can be overridden in config.yml under kit-display without restarting the server.

? Commands

? 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

⚙ 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