?
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.

91
3
91
3

Compatibility

Minecraft: Java Edition

1.21.x

Platforms

Links

Join Discord server

Tags

Creators

Details

Licensed ARR
Published 3 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