** UltimateDuels 插件 - 完整说明
? 插件概览
UltimateDuels 是一款面向运行在 Paper 上的 Minecraft 1.21.1 至 1.21.x 服务器的专业级竞技决斗插件。它提供了一个完整的 PvP 生态系统,包括排名决斗、大乱斗(Free-For-All)竞技场、小队战斗以及复杂的匹配系统。
核心亮点:
- 多回合战斗系统 - 每场决斗可配置 1-20 个回合
- 完整的套装管理 - 支持完整的背包、盔甲和副手栏位的序列化保存
- 结构图竞技场还原 - 使用 WorldEdit/FAWE 自动再生竞技场
- 小队系统 - 支持小队对小队(Party vs Party)和小队分裂(Party Split)模式的小队战斗
- FFA 竞技场 - 基于特定套装的大乱斗战斗区域
- 自定义大厅 - 拥有独立世界和交互式快捷栏物品的专属大厅
? 核心功能
- 决斗模式
| 模式 |
描述 |
玩家数 |
| 1v1 决斗 |
经典单人决斗 |
2 名玩家 |
| 小队 vs 小队 |
小队之间的团队战斗 |
2-10+ 名玩家 |
| 小队分裂 |
内部训练赛(红队 vs 蓝队) |
2-10+ 名玩家 |
| FFA (自由混战) |
在特定套装的竞技场中无限制人数战斗 |
无限制 |
- 排队系统
| 功能 |
描述 |
| 基于套装的排队 |
玩家通过选择特定套装进行排队 |
| 实时显示 |
显示每个套装的“排队中: X”和“战斗中: Y” |
| 智能匹配 |
自动配对排队的玩家 |
| 小队排队 |
队长可以为整个小队排队 |
- 多回合系统
| 设置 |
选项 |
| 回合数 |
可配置的 1 到 20 个回合 |
| 胜利条件 |
“三局两胜”(先赢多数者)或“全部打完”(所有回合) |
| 回合重置 |
即时治疗、恢复套装、重置位置 |
| 分数追踪 |
实时记分板更新 |
? 详细功能分解
? 套装系统
管理员标准套装
- 由管理员通过命令创建
- 全服可用
- 示例:NoDebuff, Sumo, Diamond, Archer, UHC, Build UHC
玩家自定义套装
- 基于管理员套装的个人变体
- 可通过套装编辑器 GUI 进行自定义
- 按玩家保存在 YAML 文件中
套装序列化(关键功能)
完整背包序列化:
├── 主背包(36 格)
├── 盔甲槽位(4 格)
│ ├── 头盔
│ ├── 胸甲
│ ├── 护腿
│ └── 靴子
└── 副手槽位(1 格)← 至关重要
└── 盾牌、不死图腾、食物等
套装编辑器 GUI
- 可视化背包编辑器
- 专用的副手槽位表示
- 拖放式物品放置
- 实时预览
?️ 竞技场系统
竞技场类型
| 类型 |
用途 |
再生方式 |
| 决斗竞技场 |
1v1 和小队战斗 |
每场比赛后 |
| FFA 竞技场 |
自由混战 |
服务器重启时 |
竞技场组件
竞技场结构:
├── 名称与 ID
├── 竞技场类型(DUEL / FFA)
├── 出生点
│ ├── 位置 1(玩家/队伍 1)
│ └── 位置 2(玩家/队伍 2)
├── 结构图文件
├── 指定套装(仅限 FFA)
└── 状态(AVAILABLE / IN_USE / REGENERATING)
结构图集成
- WorldEdit/FAWE 支持 - 异步结构图操作
- 自动粘贴 - 比赛后自动还原竞技场
- 性能优化 - 非阻塞式再生
? 大厅系统
自定义大厅世界
- 决斗者的独立世界/出生点
- 受保护的环境(无 PvP,无法破坏方块)
- 专用出生点
快捷栏物品(锁定/保存)
| 槽位 |
物品 |
动作 |
| 1 |
⚔️ 钻石剑 |
打开排队/决斗菜单 |
| 2 |
? 望远镜 |
打开小队菜单 |
| 3 |
? 书 |
打开套装编辑器 |
| 4 |
? 不死图腾 |
打开 FFA 菜单 |
| 5 |
⚙️ 比较器 |
打开设置菜单 |
⚔️ 战斗循环(多回合)
阶段 1:决斗开始
1. 玩家传送至竞技场出生点
2. 应用套装(背包 + 盔甲 + 副手)
3. 玩家冻结(禁用移动)
4. 倒计时:3... 2... 1... 战斗!
5. 玩家解冻,启用 PvP
阶段 2:回合结束(死亡)
1. 检测到死亡
2. 广播死亡信息
3. 更新分数
4. 检查胜利条件:
├── 如果比赛继续:
│ ├── 即时重置(治疗、清空、恢复套装)
│ ├── 传送至出生点
│ ├── 倒计时:3... 2... 1... 战斗!
│ └── 下一回合开始
└── 如果比赛结束:
├── 显示 VICTORY/DEFEAT 标题
├── 3 秒庆祝时间
├── 更新统计
├── 传送至大厅
└── 竞技场排队等待再生
阶段 3:赛后
1. 获胜者获得 VICTORY 标题
2. 失败者获得 DEFEAT 标题
3. 失败者变为观战状态(3 秒)
4. 双方传送至大厅
5. 粘贴竞技场结构图(异步)
6. 竞技场标记为 AVAILABLE(可用)
? 小队系统
小队结构
小队:
├── 队长(1 名玩家)
│ └── 完全控制权:邀请、踢人、解散、排队
├── 成员(最多 9 名玩家)
│ └── 可以离开、查看成员列表
└── 待处理邀请
└── 60 秒后过期
小队模式
小队 vs 小队:
小队分裂:
- 单个小队分为两队
- 红队 vs 蓝队
- 内部训练赛模式
- 非常适合练习/训练
? FFA (自由混战) 系统
FFA 特征
- 特定套装竞技场 - 每个 FFA 竞技场绑定一个套装
- 无队伍 - 每个人为自己而战
- 即时行动 - 无倒计时,立即开始 PvP
- 重生系统 - 死亡后传送至大厅,通过图腾重新加入
FFA 流程
1. 玩家在大厅点击图腾
2. 打开 FFA 菜单(选择套装/竞技场)
3. 玩家选择套装(例如:“Sumo FFA”)
4. 传送至 FFA 竞技场
5. 应用套装
6. 立即启用 PvP
7. 死亡时:传送至大厅
8. 重新加入:再次使用图腾
? 记分板系统
大厅记分板
╔═══════════════════════════╗
║ ⚔ ULTIMATE DUELS ⚔ ║
╠═══════════════════════════╣
║ 玩家: Steve ║
║ ║
║ 击杀: 150 ║
║ 死亡: 45 ║
║ K/D: 3.33 ║
║ 连胜: 12 ║
║ ║
║ 在线: 64 ║
║ 战斗中: 24 ║
║ ║
║ play.yourserver.com ║
╚═══════════════════════════╝
决斗中记分板
╔═══════════════════════════╗
║ ⚔ ULTIMATE DUELS ⚔ ║
╠═══════════════════════════╣
║ 套件: NoDebuff ║
║ 回合: 3/5 ║
║ ║
║ 你: Steve ║
║ 延迟: 24ms ║
║ ║
║ 对手: Alex ║
║ 延迟: 31ms ║
║ ║
║ 比分: 2 - 1 ║
║ ║
║ play.yourserver.com ║
╚═══════════════════════════╝
大乱斗 (FFA) 记分板
╔═══════════════════════════╗
║ ⚔ FFA - SUMO ARENA ⚔ ║
╠═══════════════════════════╣
║ 玩家: Steve ║
║ 击杀: 7 ║
║ 死亡: 2 ║
║ ║
║ 玩家数: 12 ║
║ ║
║ play.yourserver.com ║
╚═══════════════════════════╝
?️ 观战系统
观战功能
- 赛后观战 - 失败者在返回大厅前可观看 3 秒
- 外部观战 - 玩家可通过 GUI 进行观战
- 隐身模式 - 观战者对决斗者不可见
- 飞行启用 - 可在竞技场周围自由移动
- 无交互 - 无法影响决斗
观战 GUI
- 列出所有活跃的决斗
- 显示玩家、套件、竞技场、回合
- 点击即可观战任意决斗
⚙️ 设置系统
玩家设置(切换)
| 设置项 |
描述 |
默认值 |
| 记分板 |
显示/隐藏记分板 |
开启 |
| 死亡消息 |
接收死亡通知 |
开启 |
| 决斗请求 |
接受传入的决斗请求 |
开启 |
| 队伍邀请 |
接受队伍邀请 |
开启 |
| 允许观战 |
允许他人观战你 |
开启 |
| 私人模式 |
从观战列表中隐藏 |
关闭 |
? 统计系统
追踪的统计数据
| 统计项 |
描述 |
| 击杀 |
所有模式下的总击杀数 |
| 死亡 |
所有模式下的总死亡数 |
| K/D 比率 |
计算的击杀/死亡比率 |
| 胜利 |
决斗总胜场数 |
| 失败 |
决斗总负场数 |
| 胜率 |
获胜决斗的百分比 |
| 当前连胜 |
当前活跃连胜纪录 |
| 最佳连胜 |
达到的最高连胜纪录 |
| 游戏场次 |
参与的决斗总数 |
| FFA 击杀 |
在 FFA 竞技场中的击杀数 |
排行榜
- 最高击杀
- 最佳 K/D 比率
- 最高连胜纪录
- 最多胜利次数
? 依赖与要求
必需依赖
| 依赖项 |
用途 |
版本 |
| Paper |
服务端软件 |
1.21.1 - 1.21.x |
| WorldEdit 或 FAWE |
蓝图操作 |
最新版 |
| PlaceholderAPI |
占位符支持 |
2.11+ |
可选依赖
| 依赖项 |
用途 |
| Vault |
经济集成(未来功能) |
| LuckPerms |
权限管理 |
存储要求
| 存储类型 |
用途 |
| MySQL |
玩家统计数据(持久化) |
| YAML |
配置、竞技场、套件 |
| 文件系统 |
蓝图、玩家数据 |
? 使用场景
使用场景 1:服务器管理员设置
1. 安装插件及依赖项
2. 配置 config.yml(数据库、大厅世界)
3. 创建竞技场 (/arena create <name>)
4. 设置出生点 (/arena setspawn pos1/pos2)
5. 保存蓝图 (/arena save)
6. 创建套件 (/kit create <name>)
7. 设置大厅出生点 (/duels setlobby)
8. 重载插件 (/duels reload)
使用场景 2:玩家加入
1. 玩家加入服务器
2. 自动传送至大厅(如果已启用)
3. 获得锁定的快捷栏物品
4. 出现大厅记分板
5. 玩家可以:
├── 排队决斗(剑)
├── 管理队伍(望远镜)
├── 编辑套件(书)
├── 加入 FFA(图腾)
└── 更改设置(比较器)
使用场景 3:1v1 决斗
1. 玩家 A: /duel PlayerB
2. 打开决斗请求 GUI
3. 玩家 A 选择:套件、竞技场、回合数 (5)、胜利条件 (BO3)
4. 玩家 B 收到请求
5. 玩家 B 接受
6. 双方传送至竞技场
7. 应用套件
8. 倒计时:3... 2... 1... FIGHT!
9. 战斗开始
10. 回合继续进行,直到一方先取得 3 胜
11. 显示“胜利”/“失败”标题
12. 传送回大厅
13. 竞技场复原
使用场景 4:队伍对战
1. 玩家 A: /party create
2. 玩家 A: /party invite PlayerB PlayerC
3. 玩家 B 和 C 接受邀请
4. 玩家 A(队长)打开排队菜单
5. 选择“队伍排队”
6. 另一支队伍进入排队队列
7. 双方队伍匹配成功
8. 队伍 1 对战 队伍 2
9. 最后存活的队伍获胜
使用场景 5:FFA 会话
1. 玩家在快捷栏点击图腾
2. 打开 FFA 菜单
3. 玩家选择“钻石 FFA”
4. 传送至钻石 FFA 竞技场
5. 应用套件
6. 立即开始 PvP(无倒计时)
7. 玩家与其他玩家战斗
8. 死亡时:传送回大厅
9. 若想继续:再次点击图腾
? 命令参考
玩家命令
| 命令 |
描述 |
权限 |
/duel <player> |
挑战玩家进行决斗 |
ultimateduels.duel |
/accept |
接受决斗请求 |
ultimateduels.duel |
/deny |
拒绝决斗请求 |
ultimateduels.duel |
/stats [player] |
查看统计数据 |
ultimateduels.stats |
/leaderboard |
查看排行榜 |
ultimateduels.leaderboard |
队伍命令
| 命令 |
描述 |
权限 |
/party create |
创建新队伍 |
ultimateduels.party |
/party invite <player> |
邀请玩家 |
ultimateduels.party |
/party accept |
接受邀请 |
ultimateduels.party |
/party leave |
离开队伍 |
ultimateduels.party |
/party disband |
解散队伍(仅限队长) |
ultimateduels.party |
/party kick <player> |
踢出成员(仅限队长) |
ultimateduels.party |
/party list |
列出成员 |
ultimateduels.party |
管理员命令
| 命令 |
描述 |
权限 |
/duels admin |
管理面板 |
ultimateduels.admin |
/duels setlobby |
设置大厅出生点 |
ultimateduels.admin |
/duels reload |
重载配置 |
ultimateduels.admin |
/duels forceend |
强制结束决斗 |
ultimateduels.admin |
/arena create <name> |
创建竞技场 |
ultimateduels.admin |
/arena delete <name> |
删除竞技场 |
ultimateduels.admin |
/arena setspawn <pos> |
设置出生点 |
ultimateduels.admin |
/arena save |
保存结构图 |
ultimateduels.admin |
/arena list |
列出竞技场 |
ultimateduels.admin |
/kit create <name> |
创建装备包 |
ultimateduels.admin |
/kit delete <name> |
删除装备包 |
ultimateduels.admin |
/kit edit <name> |
编辑装备包 |
ultimateduels.admin |
/kit give <player> <kit> |
给予装备包 |
ultimateduels.admin |
? 完整摘要
UltimateDuels 概览
| 类别 |
详情 |
| 插件名称 |
UltimateDuels |
| 版本 |
3.0.0 |
| MC 版本 |
1.21.1 - 1.21.x |
| 服务端软件 |
Paper(必需) |
| 游戏模式 |
1v1、队伍对战、队伍分裂、自由混战 (FFA) |
| 回合系统 |
1-20 回合,最佳/全部游玩 |
| 装备包系统 |
管理员 + 玩家自定义,支持副手物品 |
| 竞技场系统 |
通过 WorldEdit/FAWE 自动再生 |
| 排队系统 |
基于装备包,实时统计 |
| 队伍系统 |
最多 10 名玩家,支持分裂模式 |
| 统计数据 |
MySQL 存储,完整追踪 |
| 计分板 |
大厅、决斗、FFA、观战 |
| GUI |
完整的基于库存的界面 |
| 本地化 |
完全可定制的 messages.yml |
功能完整性
| 功能 |
状态 |
| ✅ 多回合决斗 |
已完成 |
| ✅ 副手装备包支持 |
已完成 |
| ✅ 结构图再生 |
已完成 |
| ✅ 队伍系统 |
已完成 |
| ✅ FFA 竞技场 |
已完成 |
| ✅ 排队系统 |
已完成 |
| ✅ 统计数据与排行榜 |
已完成 |
| ✅ 自定义大厅 |
已完成 |
| ✅ 计分板系统 |
已完成 |
| ✅ 设置系统 |
已完成 |
| ✅ 观战系统 |
已完成 |
| ✅ PlaceholderAPI 集成 |
已完成 |
** UltimateDuels Plugin - Complete Description
? Plugin Overview
UltimateDuels is a professional-grade, competitive dueling plugin designed for Minecraft 1.21.1 through 1.21.x servers running on Paper. It provides a complete PvP ecosystem including ranked duels, Free-For-All arenas, party battles, and a sophisticated matchmaking system.
Key Highlights:
- Multi-Round Combat System - Configurable 1-20 rounds per duel
- Complete Kit Management - Full inventory, armor, and offhand serialization
- Schematic Arena Restoration - Automatic arena regeneration using WorldEdit/FAWE
- Party System - Team battles with Party vs Party and Party Split modes
- FFA Arenas - Kit-specific Free-For-All combat zones
- Custom Lobby - Dedicated world with interactive hotbar items
? Core Features
- Duel Modes
| Mode |
Description |
Players |
| 1v1 Duel |
Classic solo dueling |
2 players |
| Party vs Party |
Team battles between parties |
2-10+ players |
| Party Split |
Internal scrimmage (Red vs Blue) |
2-10+ players |
| FFA (Free For All) |
Unlimited players in kit-specific arenas |
Unlimited |
- Queue System
| Feature |
Description |
| Kit-Based Queue |
Players queue by selecting a specific kit |
| Real-Time Display |
Shows "In Queue: X" and "Fighting: Y" per kit |
| Smart Matchmaking |
Automatically pairs queued players |
| Party Queue |
Leaders can queue entire parties |
- Multi-Round System
| Setting |
Options |
| Rounds |
1 to 20 configurable rounds |
| Win Conditions |
"Best Of" (first to majority) or "Play All" (all rounds) |
| Round Reset |
Instant heal, kit restore, position reset |
| Score Tracking |
Real-time scoreboard updates |
? Detailed Feature Breakdown
? Kit System
Admin Standard Kits
- Created by administrators via commands
- Server-wide availability
- Examples: NoDebuff, Sumo, Diamond, Archer, UHC, Build UHC
Player Custom Kits
- Personal kit variants based on admin kits
- Customizable through Kit Editor GUI
- Saved per-player in YAML files
Kit Serialization (Critical Feature)
Full Inventory Serialization:
├── Main Inventory (36 slots)
├── Armor Slots (4 slots)
│ ├── Helmet
│ ├── Chestplate
│ ├── Leggings
│ └── Boots
└── Offhand Slot (1 slot) ← CRUCIAL
└── Shields, Totems, Food, etc.
Kit Editor GUI
- Visual inventory editor
- Dedicated offhand slot representation
- Drag-and-drop item placement
- Real-time preview
?️ Arena System
Arena Types
| Type |
Purpose |
Regeneration |
| Duel Arenas |
1v1 and Party battles |
After each match |
| FFA Arenas |
Free-For-All combat |
On server restart |
Arena Components
Arena Structure:
├── Name & ID
├── Arena Type (DUEL / FFA)
├── Spawn Points
│ ├── Position 1 (Player/Team 1)
│ └── Position 2 (Player/Team 2)
├── Schematic File
├── Assigned Kit (FFA only)
└── State (AVAILABLE / IN_USE / REGENERATING)
Schematic Integration
- WorldEdit/FAWE Support - Async schematic operations
- Auto-Paste - Automatic arena restoration after matches
- Performance Optimized - Non-blocking regeneration
? Lobby System
Custom Lobby World
- Separate world/spawn for duelists
- Protected environment (no PvP, no block breaking)
- Dedicated spawn point
Hotbar Items (Locked/Saved)
| Slot |
Item |
Action |
| 1 |
⚔️ Diamond Sword |
Open Queue/Duel Menu |
| 2 |
? Spyglass |
Open Party Menu |
| 3 |
? Book |
Open Kit Editor |
| 4 |
? Totem of Undying |
Open FFA Menu |
| 5 |
⚙️ Comparator |
Open Settings Menu |
⚔️ Combat Loop (Multi-Round)
Phase 1: Duel Start
1. Players teleported to arena spawn points
2. Kit applied (Inventory + Armor + Offhand)
3. Players frozen (movement disabled)
4. Countdown: 3... 2... 1... FIGHT!
5. Players unfrozen, PvP enabled
Phase 2: Round End (Death)
1. Death detected
2. Death message broadcast
3. Score updated
4. Check win condition:
├── If match continues:
│ ├── Instant reset (heal, clear, restore kit)
│ ├── Teleport to spawn points
│ ├── Countdown: 3... 2... 1... FIGHT!
│ └── Next round begins
└── If match ends:
├── VICTORY/DEFEAT titles
├── 3-second celebration
├── Stats updated
├── Teleport to lobby
└── Arena queued for regeneration
Phase 3: Post-Match
1. Winner gets VICTORY title
2. Loser gets DEFEAT title
3. Loser becomes spectator (3 seconds)
4. Both teleported to lobby
5. Arena schematic pasted (async)
6. Arena marked AVAILABLE
? Party System
Party Structure
Party:
├── Leader (1 player)
│ └── Full control: invite, kick, disband, queue
├── Members (up to 9 players)
│ └── Can leave, view members
└── Pending Invites
└── Expire after 60 seconds
Party Modes
Party vs Party:
- Two party leaders queue
- Full team vs team battle
- All members participate
Party Split:
- Single party splits into teams
- Red Team vs Blue Team
- Internal scrimmage mode
- Great for practice/training
? FFA (Free For All) System
FFA Characteristics
- Kit-Specific Arenas - Each FFA arena tied to one kit
- No Teams - Every player for themselves
- Instant Action - No countdown, immediate PvP
- Respawn System - Death sends to lobby, re-enter via Totem
FFA Flow
1. Player clicks Totem in lobby
2. FFA Menu opens (kit/arena selection)
3. Player selects kit (e.g., "Sumo FFA")
4. Teleported to FFA arena
5. Kit applied
6. Immediate PvP enabled
7. On death: Teleport to lobby
8. To rejoin: Use Totem again
? Scoreboard System
Lobby Scoreboard
╔═══════════════════════════╗
║ ⚔ ULTIMATE DUELS ⚔ ║
╠═══════════════════════════╣
║ Player: Steve ║
║ ║
║ Kills: 150 ║
║ Deaths: 45 ║
║ K/D: 3.33 ║
║ Streak: 12 ║
║ ║
║ Online: 64 ║
║ Fighting: 24 ║
║ ║
║ play.yourserver.com ║
╚═══════════════════════════╝
In-Duel Scoreboard
╔═══════════════════════════╗
║ ⚔ ULTIMATE DUELS ⚔ ║
╠═══════════════════════════╣
║ Kit: NoDebuff ║
║ Round: 3/5 ║
║ ║
║ You: Steve ║
║ Ping: 24ms ║
║ ║
║ Enemy: Alex ║
║ Ping: 31ms ║
║ ║
║ Score: 2 - 1 ║
║ ║
║ play.yourserver.com ║
╚═══════════════════════════╝
FFA Scoreboard
╔═══════════════════════════╗
║ ⚔ FFA - SUMO ARENA ⚔ ║
╠═══════════════════════════╣
║ Player: Steve ║
║ Kills: 7 ║
║ Deaths: 2 ║
║ ║
║ Players: 12 ║
║ ║
║ play.yourserver.com ║
╚═══════════════════════════╝
?️ Spectator System
Spectator Features
- Post-Match Spectating - Losers spectate for 3s before lobby
- External Spectating - Players can spectate via GUI
- Invisible Mode - Spectators invisible to duelists
- Flight Enabled - Free movement around arena
- No Interaction - Cannot affect duel
Spectator GUI
- Lists all active duels
- Shows players, kit, arena, round
- Click to spectate any duel
⚙️ Settings System
Player Settings (Toggle)
| Setting |
Description |
Default |
| Scoreboard |
Show/hide scoreboard |
ON |
| Death Messages |
Receive death notifications |
ON |
| Duel Requests |
Accept incoming duel requests |
ON |
| Party Invites |
Accept party invitations |
ON |
| Spectators |
Allow others to spectate you |
ON |
| Private Mode |
Hide from spectator list |
OFF |
? Statistics System
Tracked Statistics
| Statistic |
Description |
| Kills |
Total kills across all modes |
| Deaths |
Total deaths across all modes |
| K/D Ratio |
Calculated kill/death ratio |
| Wins |
Total duel wins |
| Losses |
Total duel losses |
| Win Rate |
Percentage of duels won |
| Current Streak |
Active win streak |
| Best Streak |
Highest win streak achieved |
| Games Played |
Total duels participated |
| FFA Kills |
Kills in FFA arenas |
Leaderboards
- Top kills
- Best K/D ratio
- Highest win streak
- Most wins
? Dependencies & Requirements
Required Dependencies
| Dependency |
Purpose |
Version |
| Paper |
Server software |
1.21.1 - 1.21.x |
| WorldEdit or FAWE |
Schematic operations |
Latest |
| PlaceholderAPI |
Placeholder support |
2.11+ |
Optional Dependencies
| Dependency |
Purpose |
| Vault |
Economy integration (future) |
| LuckPerms |
Permission management |
Storage Requirements
| Storage |
Purpose |
| MySQL |
Player statistics (persistent) |
| YAML |
Configuration, arenas, kits |
| File System |
Schematics, player data |
? Use Cases
Use Case 1: Server Owner Setup
1. Install plugin and dependencies
2. Configure config.yml (database, lobby world)
3. Create arenas (/arena create <name>)
4. Set spawn points (/arena setspawn pos1/pos2)
5. Save schematics (/arena save)
6. Create kits (/kit create <name>)
7. Set lobby spawn (/duels setlobby)
8. Reload plugin (/duels reload)
Use Case 2: Player Joining
1. Player joins server
2. Auto-teleported to lobby (if enabled)
3. Receives locked hotbar items
4. Lobby scoreboard appears
5. Player can:
├── Queue for duel (Sword)
├── Manage party (Spyglass)
├── Edit kits (Book)
├── Join FFA (Totem)
└── Change settings (Comparator)
Use Case 3: 1v1 Duel
1. Player A: /duel PlayerB
2. Duel Request GUI opens
3. Player A selects: Kit, Arena, Rounds (5), Win Condition (Best Of)
4. Player B receives request
5. Player B accepts
6. Both teleported to arena
7. Kits applied
8. Countdown: 3... 2... 1... FIGHT!
9. Combat begins
10. Rounds continue until first to 3 wins
11. VICTORY/DEFEAT titles
12. Teleport to lobby
13. Arena regenerates
Use Case 4: Party Battle
1. Player A: /party create
2. Player A: /party invite PlayerB PlayerC
3. Players B & C accept
4. Player A (leader) opens Queue Menu
5. Selects "Party Queue"
6. Another party queues
7. Both parties matched
8. Team 1 vs Team 2
9. Last team standing wins
Use Case 5: FFA Session
1. Player clicks Totem in hotbar
2. FFA Menu opens
3. Player selects "Diamond FFA"
4. Teleported to Diamond FFA arena
5. Kit applied
6. Immediate PvP (no countdown)
7. Player fights others
8. On death: Teleport to lobby
9. To continue: Click Totem again
? Commands Reference
Player Commands
| Command |
Description |
Permission |
/duel <player> |
Challenge player to duel |
ultimateduels.duel |
/accept |
Accept duel request |
ultimateduels.duel |
/deny |
Deny duel request |
ultimateduels.duel |
/stats [player] |
View statistics |
ultimateduels.stats |
/leaderboard |
View leaderboards |
ultimateduels.leaderboard |
Party Commands
| Command |
Description |
Permission |
/party create |
Create new party |
ultimateduels.party |
/party invite <player> |
Invite player |
ultimateduels.party |
/party accept |
Accept invitation |
ultimateduels.party |
/party leave |
Leave party |
ultimateduels.party |
/party disband |
Disband party (leader) |
ultimateduels.party |
/party kick <player> |
Kick member (leader) |
ultimateduels.party |
/party list |
List members |
ultimateduels.party |
Admin Commands
| Command |
Description |
Permission |
/duels admin |
Admin panel |
ultimateduels.admin |
/duels setlobby |
Set lobby spawn |
ultimateduels.admin |
/duels reload |
Reload configuration |
ultimateduels.admin |
/duels forceend |
Force end a duel |
ultimateduels.admin |
/arena create <name> |
Create arena |
ultimateduels.admin |
/arena delete <name> |
Delete arena |
ultimateduels.admin |
/arena setspawn <pos> |
Set spawn point |
ultimateduels.admin |
/arena save |
Save schematic |
ultimateduels.admin |
/arena list |
List arenas |
ultimateduels.admin |
/kit create <name> |
Create kit |
ultimateduels.admin |
/kit delete <name> |
Delete kit |
ultimateduels.admin |
/kit edit <name> |
Edit kit |
ultimateduels.admin |
/kit give <player> <kit> |
Give kit |
ultimateduels.admin |
? Complete Summary
UltimateDuels at a Glance
| Category |
Details |
| Plugin Name |
UltimateDuels |
| Version |
3.0.0 |
| MC Versions |
1.21.1 - 1.21.x |
| Server Software |
Paper (required) |
| Game Modes |
1v1, Party vs Party, Party Split, FFA |
| Round System |
1-20 rounds, Best Of / Play All |
| Kit System |
Admin + Player Custom, Full Offhand Support |
| Arena System |
Auto-regeneration via WorldEdit/FAWE |
| Queue System |
Kit-based, Real-time statistics |
| Party System |
Up to 10 players, Split mode |
| Statistics |
MySQL storage, Full tracking |
| Scoreboards |
Lobby, Duel, FFA, Spectator |
| GUIs |
Full inventory-based interface |
| Localization |
Full messages.yml customization |
Feature Completeness
| Feature |
Status |
| ✅ Multi-Round Duels |
Complete |
| ✅ Offhand Kit Support |
Complete |
| ✅ Schematic Regeneration |
Complete |
| ✅ Party System |
Complete |
| ✅ FFA Arenas |
Complete |
| ✅ Queue System |
Complete |
| ✅ Statistics & Leaderboards |
Complete |
| ✅ Custom Lobby |
Complete |
| ✅ Scoreboard System |
Complete |
| ✅ Settings System |
Complete |
| ✅ Spectator System |
Complete |
| ✅ PlaceholderAPI Integration |
Complete |
**
评论 0
登录后参与评分
还没有评论,来抢沙发吧