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

160downloads
4followers
160downloads
4followers

Compatibility

Minecraft: Java Edition

1.21.x

Platforms

Links

Join Discord server

Tags

Creators

Details

Licensed ARR
Published 4 months ago
Updated 4 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