?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
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.

31
3
31
3

Compatibility

Minecraft: Java Edition

1.21.x

Platforms

Links

Join Discord server

Tags

Creators

Details

Licensed ARR
Published 2 months ago

⚔ 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