Duels 竞技场插件

Duels
轻量 1v1 决斗插件，支持无限竞技场与装备套件（Kit）、可自定义消息、统计追踪与排行榜，开箱即用。
基本信息

| 项目 | 信息 |
| --- | --- |
| 插件名称 | Duels（MultiArena Duels） |
| 开发者 | Dartanboy（Dartanman）[citation:7] |
| 最新版本 | Modrinth 分支 3.3.3（2023-06-11）；SpigotMC/CurseForge 分支 4.1.0 / 4.0.5（2024–2025，见下方说明）[citation:4][citation:10] |
| 许可协议 | MIT（Modrinth）；SpigotMC/CurseForge 渠道另有 All Rights Reserved 标注 [citation:7][citation:10] |
| 兼容版本 | 1.19.x、1.20.x–1.21.x（Modrinth 页标注 1.19.x / 1.20.x / 1.21.x）[citation:7] |
| 运行平台 | Bukkit、Paper、Purpur、Spigot [citation:7] |
| 官方地址 | https://modrinth.com/plugin/duels |
| 源码 | https://github.com/Dartanboy/Duels |
简介

Duels 是一款面向 Minecraft Java 版服务端的 1v1 决斗插件，主打"无限竞技场 + 自定义装备套件 + 统计排行榜"的核心玩法。管理员可在不同世界搭建任意数量的竞技场，每个竞技场独立配置大厅、两个出生点；玩家通过 /duels join 加入队列或指定竞技场，配对成功后进入战斗，结束后自动结算胜负、更新胜场与击杀统计。

整套系统无需额外依赖即可运行，消息文本全部可配置，统计默认以 YAML 存储，也可切换到 MySQL。配合 PlaceholderAPI 还能把排行榜投射到全息图或计分板上，适合用作小游戏服的核心玩法或主城的决斗擂台。
核心特性
无限竞技场：数量无上限，每个竞技场拥有独立的 ID、名称、大厅与两个出生点，支持多世界（含 Multiverse-Core，见更新说明）[citation:3]
无限装备套件（Kit）：可创建任意数量的装备组合，玩家用当前背包一键生成，下一场决斗前自选套件 [citation:3]
可配置消息：帮助菜单、提示语等文本内容均可在配置文件中自定义 [citation:3]
统计追踪与排行榜：记录每位玩家的胜场（wins）与击杀（kills），支持个人查询与全局排行 [citation:3]
权限系统：每个命令对应独立权限节点，便于按玩家/管理员分级 [citation:2]
双存储后端：统计默认存于 YAML（Stats.yml / statistics.yml），可迁移至 MySQL [citation:9]
PlaceholderAPI 支持：提供胜场、击杀、个人数据、排行榜占位符 [citation:3]
匿名统计：通过 bStats 收集服务端匿名信息（可关闭）[citation:1]
环境要求

| 项目 | 要求 |
| --- | --- |
| 服务端 | Bukkit、Spigot、Paper、Purpur [citation:7] |
| Minecraft 版本 | 1.19.x、1.20.x、1.21.x [citation:7] |
| 前置依赖 | 无硬性依赖；如需占位符需安装 PlaceholderAPI，如需 MySQL 需自建数据库 [citation:3] |
3.x 分支（Modrinth）不再支持 1.19 以下版本；从 3.x 升级到 4.x 时由于套件改用 NBT 序列化，需删除配置中的 Kits 段落并重新创建套件（破坏性变更）[citation:9]。
安装方法
从 Modrinth（或 SpigotMC / CurseForge）下载对应版本的 jar 文件
放入服务端 plugins/ 目录
启动或重启服务端，等待 config.yml、消息文件、Stats.yml / statistics.yml 生成
按下方流程创建竞技场与套件，按需开启 MySQL
竞技场创建流程
/duels createarena <名称> — 开始创建一个竞技场
/duels setlobby — 设置该竞技场的大厅位置
/duels setspawn1 / /duels setspawn2 — 分别设置两名玩家的出生点
/duels finisharena — 完成创建，加入可加入列表
装备套件流程
把背包整理成想要的装备
/duels kits create <名称> — 用当前背包生成一个套件
玩家用 /duels kits select <名称> 选择下一场决斗使用的套件（未选择时使用 Default 套件）
提示：升级到 4.x 后套件改为 NBT 序列化，旧套件需重建；不要直接手动编辑配置中的套件数据（Base64 编码），除非熟悉其结构 [citation:3][citation:9]。

PlaceholderAPI 占位符（3.3.3+ / 3.3.6+）

| 占位符 | 含义 |
| --- | --- |
| %duels_top_wins_#% | 胜场榜第 # 名玩家名与胜场数（如 Dartanman (5 wins)） |
| %duels_top_kills_#% | 击杀榜第 # 名玩家名与击杀数 |
| %duels_your_wins% | 当前查看者的胜场数 |
| %duels_your_kills% | 当前查看者的击杀数 |
每个排行榜仅支持前 10 名（# 取 1–10）。典型用法：配合支持 PlaceholderAPI 的全息图插件逐行展示 %duels_top_wins_1%、%duels_top_wins_2%、%duels_top_wins_3%… [citation:3]
使用场景
小游戏服核心玩法：搭建多个主题竞技场，配合套件实现"弓箭决斗""剑斗""药水战"等分模式
主城决斗擂台：在 spawn 附近放置一个竞技场，玩家随时 /duels join 随机配对
公会 / 好友切磋：指定竞技场 ID，两人约战
排行榜与积分墙：用全息图 + PAPI 占位符展示胜场/击杀 Top10，激励竞争
近期更新
4.x 分支（SpigotMC / CurseForge，2024–2025）
4.1.0：扩展兼容至 1.20.6–1.21.11 [citation:3]
4.0.x：套件改用 NBT API 序列化（修复 MMOItems / MythicItems 等自定义物品元数据丢失），升级需删除旧 Kits 段落 [citation:9]
新增 %duels_your_wins% / %duels_your_kills% 个人数据占位符 [citation:9]
3.3.3（Modrinth，2023-06-11）
新增占位符 %duels_top_wins_#%、%duels_top_kills_#%（PAPI，仅前 10 名）[citation:4][citation:7]
修复：玩家可同时加入多场决斗或成为自己的对手；创建无护甲套件时的 NullPointerException [citation:4]
修复：套件中的药水效果在重启后保留；使用 Multiverse 时不再报错 [citation:4]
更早版本
3.2.0（2023-06-09）：Modrinth 首次发布；统计可存入 MySQL，新增 /duels filetosql [citation:4][citation:9]
重要安全公告：3.0.9 存在物品复制（dupe）漏洞，1.17/1.18 务必升级至 3.1.3，1.19/1.20 升级至当时最新版 [citation:9]
相关链接
Modrinth 项目页：https://modrinth.com/plugin/duels [citation:7]
SpigotMC 资源页（更新更快）：https://www.spigotmc.org/resources/multiarena-duels-1v1-leaderboard-mysql-support-1-20-1-21-11.44820/ [citation:3]
CurseForge：https://www.curseforge.com/minecraft/bukkit-plugins/multiarena-duels [citation:10]
源码仓库：https://github.com/Dartanboy/Duels [citation:3]
教程视频：https://youtu.be/qyLIn_5412A [citation:2]
许可与统计
许可协议：MIT（Modrinth 渠道）；SpigotMC / CurseForge 渠道页面另有 All Rights Reserved 标注，请以所下载渠道为准 [citation:7][citation:10]
匿名统计：插件通过 bStats 收集服务端匿名信息（在线模式、玩家数、MC 版本、服务端软件、插件版本、核心数、系统架构、操作系统、Java 版本、地理位置），可在 plugins/bStats 文件夹中关闭；作者鼓励保持开启以协助开发 [citation:1]