⚔ HypeDuels
适用于 Paper 1.21.4 的最完整 1v1 决斗插件。
挑战玩家,选择你的装备套装,在专用竞技场中战斗,并攀升 ELO 排行榜 —— 全部通过简洁且完全交互式的 GUI 完成。
✨ HypeDuels 是什么?
HypeDuels 是一款专为 Paper 1.21.4 和 Java 21 从零构建的专业决斗插件。它提供了竞争性 Minecraft 服务器所需的一切功能:挑战系统、基于装备套装的决斗、多竞技场支持、按装备套装匹配队列、完整的观战模式、ELO 评级系统以及完整的图形用户界面 —— 无需使用命令即可游玩。
所有统计数据的操作均在异步执行,以确保主线程保持整洁,服务器运行流畅。
? 主要功能
- 完整 GUI 系统 — 7 个独立菜单处理决斗体验的每个部分。玩家除了
/duel 外无需输入任何命令。
- ELO 评级 — 基于 K 因子的 ELO 系统。战胜更强的对手可获得更高的积分增长。可配置初始 ELO、K 因子和最低保底分数。
- 6 种内置装备套装 — Sword(剑)、UHC、Combo(连击)、Axe(斧)、Sumo(相扑)和 Bow(弓)—— 均已平衡好,开箱即用。
- 自定义装备套装 — 管理员可以通过
/hypeduels kit create <name> 将任何物品栏布局保存为装备套装。
- 多竞技场支持 — 创建任意数量的竞技场。当有多个竞技场可用时,玩家可通过 GUI 进行选择。
- 匹配队列 — 玩家加入按装备分类的队列,每 2 秒自动进行匹配。
- 观战模式 — 通过“活跃决斗”GUI 观看实时决斗,或点击任意决斗立即进入观战状态。
- 死亡 → 观战 — 当玩家在决斗中死亡时,他们会在竞技场直接重生为观战者。经过可配置的计时器后,他们将返回原始位置并恢复物品栏。
- 异步统计数据存储 — 所有 YAML 文件 I/O 都在主线程之外进行。统计数据缓存在内存中并在后台保存。
- 平台支持 — 兼容 Bukkit、Spigot、Paper、Purpur、Leaf 和 Folia。启动时会自动检测平台。
- 完全可配置 — 通过
config.yml 更改每条消息、声音、ELO 数值、装备图标、竞技场图标、计时器和倒计时。
? GUI 流程
打开 /duel 显示主枢纽。从那里:
- 1v1 决斗 → 从在线玩家列表中选择一名玩家 → 选择装备套装 → 选择竞技场(如果存在多个)→ 请求自动发送
- 队列 → 选择装备套装 → 你将被放入匹配队列 → 找到对手时决斗开始
- 统计数据 → 查看你的 ELO 排名、胜场、负场、K/D 比率和总决斗数
- 排行榜 → 查看前 10 名 ELO 玩家及其玩家头像 —— 点击任意条目可查看其个人资料
- 活跃决斗 → 查看正在进行的每场决斗,并点击其中一场进行观战
? 内置装备套装
| 装备 |
描述 |
| ⚔ Sword (剑) |
铁剑、铁甲、16x 金苹果 |
| ☢ UHC |
钻石剑、弓、有限的金苹果和食物 |
| ⚡ Combo (连击) |
击退剑、无护甲 —— 纯粹的技术较量 |
| ? Axe (斧) |
钻石斧 + 盾牌、钻石甲 |
| ? Sumo (相扑) |
击退 II 木棍 —— 将对手击飞出界 |
| ? Bow (弓) |
力量 IV 弓 + 铁剑、皮革甲 |
装备图标和显示名称可以在 config.yml 下的 kit-display 中进行覆盖,无需重启服务器。
? 命令
| 命令 |
描述 |
权限 |
/duel |
打开主 GUI |
everyone |
/duel <player> [kit] |
发送决斗请求 |
hypeduels.duel |
/duel accept |
接受传入的请求 |
hypeduels.duel |
/duel deny |
拒绝传入的请求 |
hypeduels.duel |
/duel queue [kit] |
加入匹配队列 |
hypeduels.queue |
/duel leave |
离开队列或停止观战 |
everyone |
/duel stats [player] |
查看玩家统计数据 |
hypeduels.stats |
/duel top |
查看 ELO 排行榜 |
everyone |
/duel spectate <player> |
观战活跃决斗 |
hypeduels.spectate |
/hypeduels reload |
重载配置 |
hypeduels.admin |
/hypeduels arena create <n> |
创建新竞技场 |
hypeduels.admin |
/hypeduels arena setspawn1 <n> |
在你所在位置设置出生点 1 |
hypeduels.admin |
/hypeduels arena setspawn2 <n> |
在你所在位置设置出生点 2 |
hypeduels.admin |
/hypeduels arena delete <n> |
删除竞技场 |
hypeduels.admin |
/hypeduels arena list |
列出所有竞技场 |
hypeduels.admin |
/hypeduels kit create <n> |
将当前物品栏保存为装备套装 |
hypeduels.admin |
/hypeduels kit delete <n> |
删除装备套装 |
hypeduels.admin |
/hypeduels kit list |
列出所有装备套装 |
hypeduels.admin |
/hypeduels info |
显示插件信息和平台 |
hypeduels.admin |
? 安装
- 下载
HypeDuels.jar 并将其放入 /plugins/ 文件夹。
- 启动或重启服务器。配置文件将自动生成。
- 在游戏中,运行
/hypeduels arena create arena1。
- 站在第一个出生点,运行
/hypeduels arena setspawn1 arena1。
- 移动到第二个出生点,运行
/hypeduels arena setspawn2 arena1。
- 在游戏中输入
/duel —— 一切准备就绪。
? 平台兼容性
| 平台 |
状态 |
| Bukkit |
支持 |
| Spigot |
支持 |
| Paper |
推荐 |
| Purpur |
支持 |
| Leaf |
支持 |
| Folia |
支持 |
⚙ 要求
- Minecraft: 1.21.4
- Java: 21 或更高版本
- Server: Paper 或任何 Paper 分支
⚔ 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
- Download
HypeDuels.jar and place it in your /plugins/ folder.
- Start or restart your server. Config files are generated automatically.
- In-game, run
/hypeduels arena create arena1.
- Stand at your first spawn point and run
/hypeduels arena setspawn1 arena1.
- Move to the second spawn point and run
/hypeduels arena setspawn2 arena1.
- 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
评论 0
登录后参与评分
还没有评论,来抢沙发吧