COWMODSКаталог модов

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.

Автор: xXantares_peek3714обновлён 7 сент. 2026 г.
ПриключенияУправлениеМини-игры

Описание

⚔ 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

KitDescription
⚔ SwordIron sword, iron armor, 16x golden apples
☢ UHCDiamond sword, bow, limited golden apples and food
⚡ ComboKnockback sword, no armor — pure mechanical skill
🪓 AxeDiamond axe + shield, diamond armor
🥊 SumoKnockback II stick — knock your opponent off the edge
🏹 BowPower 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

CommandDescriptionPermission
/duelOpen the main GUIeveryone
/duel <player> [kit]Send a duel requesthypeduels.duel
/duel acceptAccept incoming requesthypeduels.duel
/duel denyDeny incoming requesthypeduels.duel
/duel queue [kit]Join the matchmaking queuehypeduels.queue
/duel leaveLeave queue or stop spectatingeveryone
/duel stats [player]View player statisticshypeduels.stats
/duel topView the ELO leaderboardeveryone
/duel spectate <player>Spectate an active duelhypeduels.spectate
/hypeduels reloadReload confighypeduels.admin
/hypeduels arena create <n>Create a new arenahypeduels.admin
/hypeduels arena setspawn1 <n>Set spawn 1 at your locationhypeduels.admin
/hypeduels arena setspawn2 <n>Set spawn 2 at your locationhypeduels.admin
/hypeduels arena delete <n>Delete an arenahypeduels.admin
/hypeduels arena listList all arenashypeduels.admin
/hypeduels kit create <n>Save current inventory as kithypeduels.admin
/hypeduels kit delete <n>Delete a kithypeduels.admin
/hypeduels kit listList all kitshypeduels.admin
/hypeduels infoShow plugin info and platformhypeduels.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

PlatformStatus
BukkitSupported
SpigotSupported
PaperRecommended
PurpurSupported
LeafSupported
FoliaSupported

⚙ 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

Последние версии

Все версии →
release

HypeDuels 1.0.1

1.0.1
7 сент. 2026 г.130Minecraft: 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.11bukkit, folia, paper, purpur, spigot
Скачать
Что нового
# HypeDuels v1.0.1 — Changelog ## 🐛 Bug Fixes Fixed a major reconnect bug involving Ender Pearls. Previously, a player could throw an Ender Pearl, leave the duel or disconnect from the server, and get teleported back to the old duel arena after rejoining. Duel, spectator, respawn and delayed teleport states are now cleared correctly when a player quits or reconnects. Fixed delayed restore tasks that could keep old duel locations alive after a player disconnected. Players are now restored to their saved location immediately during quit cleanup instead of waiting for a delayed task that could no longer run after disconnecting. Fixed stale match data remaining after reconnects. Old duel, Team Fight, FFA, spectator and respawn references are now removed when the player joins again. Fixed active arena states not being released correctly during shutdown or unexpected disconnects. Arenas are now safely marked as available during cleanup. Fixed FFA arenas with fewer than two spawn points being considered available. FFA arenas now require at least two valid spawns before they can be used. Fixed queue entries becoming stuck after an offline player was removed. Offline and invalid players are now removed from both the queue and the internal player index. Fixed empty matchmaking queues remaining in memory after a player leaves. ## ✨ New Features Added a live duel scoreboard showing the opponent, opponent health, your health, kit, arena, duel duration and ELO during active 1v1 matches. Added configurable scoreboard support. The scoreboard can be enabled or disabled from the config, and its title, refresh interval and displayed lines can be customized. Added configurable duel command blocking. Commands used during duels, Team Fights, FFA matches and spectator mode are now blocked unless they are explicitly added to the allowed command list. Added configurable teleport protection during matches. Command teleports, Nether Portals, End Portals and End Gateways can now be blocked while a player is in a match. Added configurable bucket protection to prevent players from emptying or filling buckets during matches. Added automatic scoreboard cleanup when a duel ends, a player quits, a player reconnects or the plugin shuts down. The player’s previous scoreboard is restored after the duel. Added active scoreboard reloading. If the scoreboard is disabled or enabled through config reload, the setting is applied to active duels without requiring a full server restart. Added safe plugin shutdown cleanup for active duels. Players and arenas are cleaned up immediately when the plugin is disabled. ## 🔧 Internal Improvements Added a dedicated DuelScoreboardManager to handle scoreboard creation, updates, placeholders, restoration and cleanup. Scoreboard updates are handled by a scheduled task instead of creating permanent per-player tasks, reducing unnecessary task overhead. Added scoreboard placeholders for `{player}`, `{opponent}`, `{kit}`, `{arena}`, `{time}`, `{elo}`, `{opponent_elo}`, `{health}` and `{opponent_health}`. Improved duel lifecycle handling so delayed tasks cannot re-teleport disconnected players into old arenas. Improved FFA arena type separation and match model consistency. Improved queue cleanup and matchmaking state management. Updated the project version and plugin metadata to `1.0.1`. ## ⚠️ Config Note If you are upgrading from v1.0.0, add the new scoreboard, command protection, teleport protection and bucket protection settings to your existing `config.yml`, or delete the old config file to generate the updated default configuration.
release

HypeDuels 1.0.0

1.0.0
21 мар. 2026 г.239Minecraft: 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.11bukkit, folia, paper, purpur, spigot
Скачать