Duels - 自定义竞技场与对战限制

💡Duels —— 公平决斗插件

Duels 是一款专注于限制特定物品与能力的 Minecraft 服务器插件。它旨在为玩家提供完全公平、可控的一对一决斗环境。玩家可以自定义禁用诸如图腾、金苹果、弓箭、盾牌等可能带来不平衡优势的物品，无需管理员手动干预，从而确保每场对决的纯粹性与公正性。

🎮核心功能

• 自定义限制：通过 GUI 界面，决斗发起方可灵活选择在本次对决中禁用的物品或能力。
• 决斗流程：完整的发起、接受、传送至竞技场、倒计时及结算流程。
• 旁观系统：使用指令即可旁观正在进行的决斗。
• 物品保存：可配置在决斗前保存玩家物品，决斗结束后原样归还，适合搭配自定义装备使用。
• 模块化配置：服务器管理员可以精细控制每个功能模块的开启与关闭。

🔧指令与使用

发起决斗

使用 /duel <玩家名> 打开决斗设置界面。点击切换各项限制，完成后点击“开始”按钮，即可向目标玩家发送带有相同限制设置的决斗请求。

接受决斗

目标玩家将收到可点击的 [接受] 或 [拒绝] 消息。接受后，双方将被传送至竞技场，并开始从 5 倒数至 0，随后战斗正式开始。

旁观决斗

使用 /duels spectate <玩家名> 可以旁观指定玩家正在进行的决斗。

✨配置说明

以下为插件核心模块的配置示例与说明，你可以在 config.yml 文件中进行调整：

# 在此处可以切换服务器中启用/禁用的模块。
# 如果关闭任何模块，它将不会出现在决斗GUI中，玩家也无法切换该限制。
modules:
  # 禁用此选项将关闭限制GUI，请求将直接发送而无需指定决斗限制。可用于禁用所有限制。
  GUI: true
  # 竞技场选择器模块
  arena-selector: true

keep-inventory:
  enabled: true
  toggled-by-default: true

# 物品保存功能。当请求接收者接受决斗时，如果启用此功能，双方玩家的物品将被收取并存储。
# 决斗结束后，物品将返还。如果你想在游戏中给玩家一些特定装备包，可以使用此功能。
inventory-saving:
  enabled: false
  toggled-by-default: false

# 各项限制配置。enabled 控制该限制是否可用，toggled-by-default 控制其在GUI中默认是否被勾选（禁用）。
restrictions:
  bow:
    enabled: true
    toggled-by-default: true
  totem:
    enabled: true
    toggled-by-default: true
  golden-apple:
    enabled: true
    toggled-by-default: true
  enchanted-golden-apple:
    enabled: true
    toggled-by-default: true
  potion:
    enabled: true
    toggled-by-default: true
  shield:
    enabled: true
    toggled-by-default: true
  elytra:
    enabled: true
    toggled-by-default: true
  ender-pearl:
    enabled: true
    toggled-by-default: true

❓注意事项

• 请勿将此资源声称是你自己的创作。
• 所有配置均可根据服务器需求进行调整，关闭不需要的限制或功能。
• 如需支持，请通过以下 Discord 链接联系开发者。

支持链接：https://discord.gg/2zZChX9AEN

💡简介

本插件为 Minecraft 服务器添加了玩家对战（决斗）功能，支持创建多个竞技场、玩家匹配、观战等特性。通过简单的命令即可完成设置与管理。

🔧如何设置插件

请按以下步骤完成插件的基本设置。

设置重生点

首先，你需要设置一个全局的重生点，决斗结束后玩家将被传送至此。

• 执行命令 /dueladmin setspawn

设置竞技场

接下来，你可以创建一个或多个供玩家对战的竞技场。

• 创建竞技场

- 执行命令 `/dueladmin createarena <arenaName>` （将 `<arenaName>` 替换为你想要的竞技场名称）

• 设置玩家位置

- 前往你希望**玩家1**出现的位置，执行命令 `/dueladmin setarenapos <arenaName> pos1`

- 前往你希望**玩家2**出现的位置，执行命令 `/dueladmin setarenapos <arenaName> pos2`

• 删除竞技场（可选）

- 如需删除某个竞技场，请执行命令 `/dueladmin deletearena <arenaName>`

🎮命令列表

玩家命令

以下命令所有玩家均可使用（无需特殊权限）

• /duel <player> - 邀请一名玩家进行决斗
• /duels cancel <player> - 取消你发出的决斗请求
• /duels accept <player> - 接受一名玩家的决斗请求
• /duels deny <player> - 拒绝一名玩家的决斗请求
• /duels ignore <player> - 开始或停止忽略某玩家的决斗请求
• /duels spectate <player> - 开始观战某玩家的决斗
• /duels stopspectate <player> - 停止观战
• /duels queue - 将自己加入随机匹配队列

管理员命令

• /dueladmin - 显示帮助信息
• /dueladmin setspawn - 设置重生点 (权限: duels.admin.setspawn)
• /dueladmin createarena <arenaName> - 创建竞技场 (权限: duels.admin.createarena)
• /dueladmin setarenapos <arenaName> pos<1/2> - 设置竞技场位置 (权限: duels.admin.setpos)
• /dueladmin deletearena <arenaName> - 删除竞技场 (权限: duels.admin.deletearena)
• /dueladmin reload - 重载插件配置 (权限: duels.admin.reload)

⭐占位符

插件支持以下占位符，可用于计分板或其他支持占位符的插件：

• %duel_time_left% - 决斗剩余时间（显示格式可在配置文件中修改）
• %duel_opponent% - 对手的游戏ID
• %duel_opponent_ping% - 对手的当前网络延迟（ping值）

如需添加更多占位符，请联系我们。

✨MiniMessage 支持

你可以在语言配置文件中使用 MiniMessage 格式来自定义消息文本。

• 使用方法：在每条消息的开头添加 $ 符号即可启用 MiniMessage 格式解析。

❓支持与帮助

如果在使用中遇到问题或有功能建议，欢迎通过 Discord 联系我们。

• Discord: https://discord.gg/2zZChX9AEN