MultiArena Duels [1v1] [Leaderboard] [MySQL Support] - MultiArena Duels - 竞技场决斗

Duels 是一款功能强大的 Minecraft 决斗插件，支持创建无限数量的竞技场和装备套装，并拥有完整的统计追踪和排行榜系统。所有消息均可自定义，且与 PlaceholderAPI 兼容，便于深度集成。

💡核心特性

• 支持创建无限个决斗竞技场
• 支持创建无限个装备套装 (Kits)
• 所有提示消息均可通过配置文件自定义
• 完整的权限系统支持
• 统计追踪与排行榜系统
• 支持 PlaceholderAPI 占位符
• 可选择使用 YAML 或 MySQL 存储统计数据

🔧命令列表

玩家命令

• /duels help - 显示可配置的帮助菜单
• /duels join [id] - 加入第一个可用的竞技场，或加入指定 ID 的竞技场（如果可用）
• /duels leave - 离开你所在的竞技场。若比赛处于进行中状态时离开，将被记为一次失败
• /duels listarenas - 列出所有竞技场，显示其 ID、名称和状态 (IDLE, COUNTDOWN, PLAYING)
• /duels stats [玩家名] - 查看自己或指定玩家的统计数据
• /duels top [wins/kills] - 查看胜场或击杀数的排行榜

管理员命令：竞技场管理

• /duels createarena <竞技场名称> - 开始创建一个指定名称的竞技场
• /duels setlobby - 为你正在创建的竞技场设置大厅位置
• /duels setspawn1 - 为你正在创建的竞技场设置玩家1出生点
• /duels setspawn2 - 为你正在创建的竞技场设置玩家2出生点
• /duels finisharena - 完成当前竞技场的创建，使其变为可加入状态

管理员命令：装备套装管理

• /duels kits list - 列出所有可用装备套装
• /duels kits create <套装名称> - 用你当前的物品栏创建一个新套装
• /duels kits delete <套装名称> - 删除指定套装
• /duels kits select <套装名称> - 为你下一场决斗选择套装。若套装不存在，你将获得默认套装

管理员命令：数据与维护

• /duels loadoldstats - 从旧的 Stats.yml 加载数据到新的统计系统
• /duels filetosql - 将 statistics.yml 中的数据导入 SQL 数据库
• /duels update - 检查 Duels 插件是否有可用更新

🎮权限节点

• duels.help - 允许使用 /duels help
• duels.join - 允许使用 /duels join
• duels.leave - 允许使用 /duels leave
• duels.listarenas - 允许使用 /duels listarenas
• duels.createarena - 允许使用 /duels createarena, /duels setlobby, /duels setspawn1, /duels setspawn2, /duels finisharena
• duels.kits.list - 允许使用 /duels kits list
• duels.kits.create - 允许使用 /duels kits create
• duels.kits.delete - 允许使用 /duels kits delete
• duels.kits.select - 允许使用 /duels kits select
• duels.admin - 允许使用 /duels loadoldstats, /duels filetosql, /duels update
• duels.stats - 允许使用 /duels stats
• duels.top - 允许使用 /duels top

✨PlaceholderAPI 占位符

自版本 3.3.6 起，支持以下占位符

排行榜占位符

• %duels_top_wins_#% - 显示胜场排行榜第 # 名玩家的名称和胜场数（例如：Dartanman (5 wins)）。仅支持前十名。
• %duels_top_kills_#% - 显示击杀榜第 # 名玩家的名称和击杀数（例如：Dartanman (5 kills)）。仅支持前十名。

玩家数据占位符

• %duels_your_wins% - 显示查看此占位符的玩家的胜场数（例如：5）。
• %duels_your_kills% - 显示查看此占位符的玩家的击杀数（例如：5）。

使用示例

你可以使用支持 PlaceholderAPI 的全息图插件创建一个排行榜，格式如下：

Wins Leaderboard
1. %duels_top_wins_1%
2. %duels_top_wins_2%
3. %duels_top_wins_3%

⭐配置说明

主要配置文件为 config.yml。以下为关键配置项的结构概览：

# Duels by Dartanman
# 除非你非常熟悉 Base64 编解码，否则请不要在文件中直接编辑 kits 部分！

Statistics:
  Storage-Type: 'YAML' # 可选 'YAML' 或 'SQL'
  SQL-Info:
    Address: 'localhost'
    Port: '3306'
    Database: 'schema'
    Username: 'admin'
    Password: 'password'

Messages:
  No-Permission: '&c权限不足。'
  Countdown: '&a决斗将在 <seconds> 秒后开始！'
  # ... 更多可自定义消息

Help-Menu:
  - '&9Duels 帮助菜单&f:'
  - '&6/duels help&f: &e显示此帮助菜单'
  # ... 帮助菜单项

Stats-Card:
  - '&e============='
  - '&8<name> 的统计数据'
  - '&e胜场&f: &6<wins>'
  - '&e败场&f: &6<losses>'
  - '&e击杀&f: &6<kills>'
  - '&e死亡&f: &6<deaths>'
  - '&e============='

Kits:
  0:
    Name: Default
    Armor:
      Helmet: '{ material:iron_helmet amount:1 meta:{ } }'
      # ... 其他盔甲
    Inventory:
    - '{ material:iron_sword amount:1 meta:{ } }'
    - '{ material:bread amount:64 meta:{ } }'

Arenas:
  # 竞技场配置

❓常见问题与说明

从 3.1.3 或更低版本更新

• 停止服务器。
• 删除旧的 config.yml 和旧的 Duels JAR 文件。
• 添加新的 Duels JAR 文件。
• 启动服务器。
• (可选) 如果你希望将旧的胜场数据加载到新统计系统中，请使用权限 duels.admin 运行命令 /duels loadoldstats。如果不需要，请跳过此步。
• 删除 Stats.yml，但不要删除 statistics.yml。

Minecraft 1.17-1.18 版本支持

• 请使用 Duels 版本 3.1.3，这是支持 Minecraft 1.17 和 1.18 的最新版本。
• 该版本已稳定运行约半年，但请注意，此版本发现的任何错误将不会被修复，也不会添加新功能。
• 最新版 Duels 未来可能会增加向后兼容性，但请不要依赖于此。

数据统计 (Metrics)

• Duels 使用 bStats 收集匿名服务器信息（如服务器版本），以帮助改进插件。
• 你可以在 \plugins\bStats 文件夹中禁用它，但我们建议保持启用以支持开发。

支持与感谢

感谢所有玩家的支持！插件下载量已突破 25,000，这是我们持续开发的巨大动力。

• 支持 Discord: https://discord.gg/PfN9J5yrkQ
• 教程视频: (视频链接，内容略有滞后但仍具参考价值)