⚔️ AsDuels
竞技服务器终极 1v1 决斗插件
by ItzAzeem | AsDevelopment
挑战。排队。战斗。重复。
? AsDuels 是什么?
AsDuels 是一款高性能、功能丰富的 1v1 决斗插件,专为竞技 PvP 和 FFA(自由死斗)服务器设计。玩家互相发起挑战,从美观且实时更新的图形用户界面中选择自己的装备套件,并在自定义建造的竞技场中展开激战——所有功能开箱即用,无需任何外部依赖。
管理员可以在游戏内 100% 完成所有设置 —— 无需编辑 YAML 文件,无需重启服务器,毫无烦恼。
零延迟。无废话。纯粹的竞技决斗体验。
✨ 功能详解
⚔️ 决斗系统
- 使用
/duel <玩家> 挑战任意玩家,或通过 /duel 打开队列图形界面
- 聊天框中可直接点击 [接受] 和 [拒绝] 按钮
- 决斗请求在可配置的超时时间后自动失效
- 防止自相残杀、与已在比赛中的玩家进行决斗,以及在队列中进行决斗
? Kit 选择界面
- 精美的箱子 GUI,以图标形式展示所有可用 Kit
- 每个 Kit 显示实时战斗次数和实时排队人数
- 当任何玩家加入或离开队列/比赛时,GUI 自动刷新
- 点击任意 Kit 图标即可立即加入该 Kit 的队列或使用它发起挑战
? 排队系统
- 每个 套件 拥有独立的匹配队列 —— 确保公平匹配
- 若已有对手在等待 → 立即开始对战
- 实时显示的 动作栏计时器,显示你已排队的时间
- 输入
/duel leave 可随时退出排队
- 玩家断线时会自动从队列中移除
?️ 竞技场系统
- 使用法杖工具在游戏内完全创建竞技场——无需坐标
- 铁锄法杖——左键点击 = 位置1,右键点击 = 位置2
- 为每个竞技场设置两个独立的玩家出生点
- 同时运行多个竞技场——无瓶颈
- 系统会在比赛开始时自动分配最佳可用竞技场
?️ 智能竞技场保护
这正是 AsDuels 区别于其他对战插件的地方:
- ❌ 原始竞技场方块永远无法被破坏——受到永久保护
- ✅ 玩家可以在比赛期间自由放置新方块
- ✅ 玩家可以破坏自己在比赛期间放置的方块
- ? 所有玩家放置的方块会在比赛结束时自动移除
- 每次比赛后,竞技场都会完美重置——无需手动清理!
? 套装系统
- 无需触碰任何配置文件,即可在游戏中创建套装
- 保存你的完整物品栏:36 个主槽位 + 护甲槽位 + 副手槽位
- 为每个套装设置自定义 GUI 图标,让玩家一眼就能识别
- 将任意套装绑定到任意竞技场——比赛开始时自动发放套装
- 比赛结束时自动移除套装并恢复玩家物品栏
?️ 观战模式
/duel spectate <arena> — 实时观看任何正在进行中的比赛
- 完整的原版旁观者游戏模式——可在竞技场内自由飞行
- 无法与玩家互动或造成伤害
- 比赛结束后自动传送回大厅
- 可通过
/spawn 提前离开
⚙️ 深度配置
- 25+ 条可配置消息 —— 所有面向玩家的文本均可自定义
- 所有消息和标题均支持完整的 十六进制颜色代码
&#RRGGBB
- 可配置 GUI 标题、行数以及填充材料
- 可按每场比赛单独启用/禁用饥饿值、坠落伤害与自然生物伤害
- 可配置倒计时时长与请求超时时间
?️ 竞技场设置 — 逐步指南
1. /ad wand → 获取铁锄作为标记工具
2. 左击一个方块 → 设置 Pos1(角点 1)
3. 右击一个方块 → 设置 Pos2(角点 2)
4. /ad create arena <name> → 竞技场已创建!
5. 站在出生点 1 上
6. /ad arena <name> setspawn1 → 出生点 1 已保存
7. 站在出生点 2 上
8. /ad arena <name> setspawn2 → 出生点 2 已保存 —— 竞技场准备就绪!
9. 在背包中放入所需物品
10. /ad kit save <name> → 套装已保存!
11. 手持图标物品
12. /ad kit icon <name> → 图标已设置!
13. /ad kit bind <kit> <arena> → 套装已绑定至竞技场!
完成!你的竞技场已完全准备好进行对战。
? 命令列表
玩家命令
| 命令 |
描述 |
/duel |
打开套装队列 GUI |
/duel <player> |
向指定玩家发起挑战 |
/duel accept |
接受收到的决斗请求 |
/duel deny |
拒绝收到的决斗请求 |
/duel cancel |
取消你发出的请求 |
/duel leave |
退出匹配队列 |
/duel spectate <arena> |
观战正在进行的比赛 |
/spawn |
返回大厅出生点 |
管理员指令 (/ad 或 /adminduel)
| 指令 |
描述 |
/ad wand |
获取选择魔杖 |
/ad create arena <name> |
从选区创建新竞技场 |
/ad create kit <name> |
创建新的装备包条目 |
/ad arena <name> setspawn1 |
设置竞技场出生点 1 |
/ad arena <name> setspawn2 |
设置竞技场出生点 2 |
/ad kit save <name> |
将当前物品栏保存为装备包 |
/ad kit bind <kit> <arena> |
将装备包绑定到竞技场 |
/ad kit icon <name> |
将主手物品设置为装备包图标 |
/ad setspawn |
设置全局大厅出生点 |
/ad list arenas |
列出所有竞技场及其状态 |
/ad list kits |
列出所有装备包 |
/ad delete arena <name> |
删除一个竞技场 |
/ad delete kit <name> |
删除一个装备包 |
/ad reload |
重载配置和数据 |
? 权限
| 权限 |
描述 |
默认值 |
asduels.use |
访问所有玩家命令 |
true |
asduels.admin |
访问所有管理员命令 |
op |
?️ 兼容性
|
|
| 服务端软件 |
Paper 1.21.4, Spigot 1.21.4 |
| Java 版本 |
Java 21 或更高 |
| 依赖项 |
无 — 完全独立运行 |
| 数据库 |
无 — 使用纯 YAML 文件存储 |
? 插件文件
plugins/AsDuels/
├── config.yml ← 所有设置、GUI 配置及 25 多条消息
├── arenas.yml ← 竞技场区域、出生点、套件绑定(自动管理)
└── kits.yml ← Base64 格式的套件物品(自动管理)
?? 开发者介绍
ItzAzeem.As 是 AsDevs 的创始人 —— 一个专注于为竞技服务器打造独特、精致且注重性能的 Minecraft 插件开发品牌。
? 支持与错误报告
遇到问题?需要帮助进行设置?想建议新功能?
加入 AsDevs Discord 服务器以获取快速、友好的支持:
? discord.gg/xRW5rdAvs5
请不要在 Modrinth 评论区提交错误报告 —— Discord 会更快更方便!
?️ 路线图
| 功能 |
状态 |
| 核心决斗系统 |
✅ 已发布 |
| 带有实时统计数据的套件 GUI |
✅ 已发布 |
| 竞技场方块保护 + 自动清理 |
✅ 已发布 |
| 排队系统 |
✅ 已发布 |
| 观战模式 |
✅ 已发布 |
| 玩家统计数据(胜/负/连胜) |
? v1.1.0 |
| 排队超时 |
? v1.1.0 |
| 胜负结果标题 |
? v1.1.0 |
| ELO / 评级系统 |
? 未来 |
| 锦标赛系统 |
? 未来 |
由 ItzAzeem.As | AsDevs 用 ❤️ 制作
喜欢 AsDuels 吗?请留下 ⭐ 评论 —— 这对我们真的很有帮助!
Discord • Website
⚔️ AsDuels
The Ultimate 1v1 Duel Plugin for Competitive Servers
by ItzAzeem | AsDevelopment
Challenge. Queue. Fight. Repeat.
? What is AsDuels?
AsDuels is a high-performance, feature-packed 1v1 duel plugin designed for competitive PvP and FFA servers. Players challenge each other, pick their kit from a beautiful live-updated GUI, and battle it out in custom-built arenas — all working out of the box with zero external dependencies.
Admins set up everything 100% in-game — no YAML editing, no restarts, no headaches.
No lag. No nonsense. Just pure competitive dueling.
✨ Feature Breakdown
⚔️ Duel System
- Challenge any player with
/duel <player> or open the queue GUI with /duel
- Clickable [Accept] and [Deny] buttons directly in chat
- Duel requests auto-expire after a configurable timeout
- Prevents self-dueling, dueling players already in matches, and dueling while in queue
? Kit Selection GUI
- Beautiful chest GUI showing all available kits as icons
- Each kit displays live Fighting count and live Queue count
- GUI auto-refreshes when any player joins or leaves a queue or match
- Click any kit icon to instantly join that kit's queue or send a challenge with it
? Queue System
- Separate matchmaking queue per kit — players are matched fairly
- If an opponent is already waiting → instant match start
- Live actionbar timer showing how long you've been queued
/duel leave to exit queue at any time
- Players auto-removed from queue on disconnect
?️ Arena System
- Create arenas entirely in-game with the wand tool — no coordinates needed
- Iron Hoe wand — Left Click = Pos1, Right Click = Pos2
- Set two individual player spawns per arena
- Run multiple arenas simultaneously — no bottleneck
- System automatically assigns the best available arena on match start
?️ Smart Arena Protection
This is where AsDuels stands out from other duel plugins:
- ❌ Original arena blocks can never be broken — protected forever
- ✅ Players can place new blocks during a match freely
- ✅ Players can break blocks they personally placed during the match
- ? All player-placed blocks are automatically removed when the match ends
- Arena resets itself perfectly after every single match — no manual cleanup needed!
? Kit System
- Create kits in-game without touching any config file
- Saves your complete inventory: 36 main slots + armor slots + offhand slot
- Set a custom GUI icon per kit so players instantly recognize it
- Bind any kit to any arena — kit is automatically given when match starts
- Kit is automatically removed and inventory restored when match ends
?️ Spectator Mode
/duel spectate <arena> — watch any live match in real time
- Full vanilla spectator gamemode — fly freely around the arena
- Cannot interact with or damage players
- Automatically teleported back to lobby when the match ends
- Can leave early using
/spawn
⚙️ Deep Configuration
- 25+ configurable messages — every single player-facing string
- Full hex color support
&#RRGGBB in all messages and titles
- Configurable GUI title, row count, and filler material
- Toggle hunger, fall damage, and natural mob damage per match
- Configurable countdown duration and request timeout
?️ Arena Setup — Step by Step
1. /ad wand → Get the Iron Hoe wand
2. Left click a block → Set Pos1 (corner 1)
3. Right click a block → Set Pos2 (corner 2)
4. /ad create arena <name> → Arena created!
5. Stand on spawn point 1
6. /ad arena <name> setspawn1 → Spawn 1 saved
7. Stand on spawn point 2
8. /ad arena <name> setspawn2 → Spawn 2 saved — Arena READY!
9. Fill your inventory with items
10. /ad kit save <name> → Kit saved!
11. Hold the icon item in hand
12. /ad kit icon <name> → Icon set!
13. /ad kit bind <kit> <arena> → Kit bound to arena!
Done! Your arena is fully ready for matches.
? Commands
Player Commands
| Command |
Description |
/duel |
Open kit queue GUI |
/duel <player> |
Challenge a specific player |
/duel accept |
Accept incoming duel request |
/duel deny |
Deny incoming duel request |
/duel cancel |
Cancel your outgoing request |
/duel leave |
Leave the matchmaking queue |
/duel spectate <arena> |
Spectate an active match |
/spawn |
Return to lobby spawn |
Admin Commands (/ad or /adminduel)
| Command |
Description |
/ad wand |
Get selection wand |
/ad create arena <name> |
Create new arena from selection |
/ad create kit <name> |
Create new kit entry |
/ad arena <name> setspawn1 |
Set arena spawn point 1 |
/ad arena <name> setspawn2 |
Set arena spawn point 2 |
/ad kit save <name> |
Save current inventory as kit |
/ad kit bind <kit> <arena> |
Bind kit to arena |
/ad kit icon <name> |
Set kit icon from main hand |
/ad setspawn |
Set global lobby spawn |
/ad list arenas |
List all arenas and their status |
/ad list kits |
List all kits |
/ad delete arena <name> |
Delete an arena |
/ad delete kit <name> |
Delete a kit |
/ad reload |
Reload config and data |
? Permissions
| Permission |
Description |
Default |
asduels.use |
Access all player commands |
true |
asduels.admin |
Access all admin commands |
op |
?️ Compatibility
|
|
| Server Software |
Paper 1.21.4, Spigot 1.21.4 |
| Java Version |
Java 21 or higher |
| Dependencies |
None — completely standalone |
| Database |
None — flat file YAML storage |
? Plugin Files
plugins/AsDuels/
├── config.yml ← All settings, GUI config & 25+ messages
├── arenas.yml ← Arena regions, spawns, kit bindings (auto-managed)
└── kits.yml ← Kit items in Base64 format (auto-managed)
?? About the Developer
ItzAzeem.As is the founder of AsDevs — a Minecraft plugin development brand focused on creating unique, polished, and performance-first plugins for competitive servers.
? Support & Bug Reports
Having issues? Need help with setup? Want to suggest a feature?
Join the AsDevs Discord server for fast, friendly support:
? discord.gg/xRW5rdAvs5
Please do not use Modrinth comments for bug reports — Discord is much faster and easier!
?️ Roadmap
| Feature |
Status |
| Core duel system |
✅ Released |
| Kit GUI with live stats |
✅ Released |
| Arena block protection + auto cleanup |
✅ Released |
| Queue system |
✅ Released |
| Spectator mode |
✅ Released |
| Player stats (W/L/Streak) |
? v1.1.0 |
| Queue timeout |
? v1.1.0 |
| Win/Loss result titles |
? v1.1.0 |
| ELO / Rating system |
? Future |
| Tournament system |
? Future |
Made with ❤️ by ItzAzeem.As | AsDevs
Enjoying AsDuels? Please leave a ⭐ review — it really helps!
Discord • Website
评论 0
登录后参与评分
还没有评论,来抢沙发吧