自定义队伍

Custom Teams - 一个 Paper 1.21.11 插件


---

插件由 imNikos 制作。

---

这是一个 Paper/Bukkit 插件，用于运行管理员控制的 PvP 活动 —— 无论是 自由混战（Free-For-All） 还是 4 队对战（4-Team） —— 配备完整的 GUI 驱动设置、自定义装备、智能出生点布置以及每位玩家的装备保存功能。

---

功能特性

• 两种活动模式
  • 自由混战（FFA）： 任意数量的玩家，各自为战，佩戴白色名称标签。获胜者的名字会直接播报，而非队伍名称。
  • 团队模式： 4 个固定队伍 —— 红队、蓝队、绿队、黄队 —— 名称标签、Tab 列表和聊天前缀均使用浅色变体。
• 灵活的出生点系统
  • 团队模式： 使用游戏内快捷栏工具为每个队伍设置多个出生点。
  • FFA 模式： 可选择为每位玩家放置一个出生点，或放置一个单一中心点，系统会自动将玩家分布在以该点为中心、随玩家数量缩放半径的范围内。
  • 所有自动生成的出生位置在使用前都会经过安全检测，确保地面不会导致窒息。
• 活动主装备编辑器 —— 构建一个共享装备（护甲、副手、药水效果和 27 个背包格），每位参与者都会在比赛开始时获得该装备。
• 个人装备保存 —— 每位玩家可以保存并加载多达 3 套自己的装备，与活动装备相互独立。
• 比赛安全窗口
  • 比赛开始时提供 5 秒无敌时间（期间也无法造成伤害），防止玩家在加载时被偷袭。
  • 获胜者（们）在胜利庆祝期间享有 10 秒无敌时间。
• 可配置开关 —— 开局游戏模式、击杀回血和自然生命恢复，均可从管理员 GUI 中切换。
• 自动观战模式 —— 死亡的玩家会被切换到旁观者模式，可以重新加入成为观战者，或完全离开活动。
• 数据持久化 —— 装备和出生点存储在 kits.yml 中，服务器重启后仍然保留。

---

命令

命令	描述	权限
/ct	打开管理员控制面板（队伍、出生点、装备编辑器、开关、开始/结束活动）。	customteams.admin
/ct leave	离开当前正在进行的活动，并恢复你活动前的背包/位置。	无
/ct kits	打开你的个人"我的装备"菜单（保存/加载多达 3 套个人装备）。	无

Tab 补全会在 /ct 后提示 leave 和 kits。

---

权限

权限	描述
customteams.admin	访问管理员面板：队伍/名单管理、出生点设置、装备创建以及开始/结束活动。

任何玩家（无论是否拥有管理员权限）都可以使用 /ct leave 和 /ct kits。

---

管理员 GUI 操作指南

运行 /ct 打开 Custom Teams 设置：

• 队伍 → 选择下一场活动的分配方式：
  • 自由混战（FFA） → 打开分页的玩家选择器。点击玩家切换其入选状态，然后点击 确认并设置 FFA 名单 锁定。
  • 手动分配队伍 → 选择一个颜色，然后点击玩家将其分配/取消分配到该队伍。
• 出生点 → 选择要配置的出生点系统：
  • FFA 出生点 → 需要先设置好 FFA 名单（这样插件才知道需要多少个出生点）。然后选择：
  • 精确出生点 — 每位参与者会获得一个白色羊毛；将每个羊毛放置在你想让玩家出生的位置。
  • 半径出生点 — 你会获得一个白色羊毛；将其放置一次作为中心点，玩家会在该点周围均匀分布，距离随玩家数量增长。
  • 团队出生点 → 进入游戏内编辑模式，快捷栏布局如下：

槽位	物品
1	红色出生点（放置以添加红队出生点）
2	蓝色出生点
3	绿色出生点
4	黄色出生点
5	重置红色出生点（右键点击清除红队所有出生点）
6	重置蓝色出生点
7	重置绿色出生点
8	重置黄色出生点
9	保存并退出

在你的主背包中还会找到 取消（放弃所有更改）和 全部重置（清除所有队伍的出生点）。在点击 保存并退出 之前，不会向磁盘写入任何数据。

• 装备编辑器 → 构建共享活动主装备：将物品拖到护甲/副手槽和药水效果槽，然后点击绿宝石块保存。
• 游戏模式 / 自然生命恢复 / 击杀回血开关 → 点击切换各项设置；更改会立即保存到 config.yml。
• 开始活动 / 强制结束活动 → 开始 5 秒倒计时（对所有排队参与者以标题形式显示），或立即结束正在进行的活动。

---

个人装备（/ct kits）

每位玩家拥有 3 个个人装备槽，独立于管理员的主装备：

• 左键点击 一个槽位，将该装备加载到当前背包。
• 右键点击 一个槽位，将当前背包保存到该槽位。

这些装备按玩家分别存储，并在多次会话中持续保留。

---

配置文件（config.yml）

settings:
  gamemode-on-start: SURVIVAL   # 或 ADVENTURE
  health-on-kill: true          # 击杀后完全恢复玩家生命/饥饿值
  natural-regen: true           # 活动期间保留原版自然生命恢复

数据文件（kits.yml）

存储活动主装备、队伍出生点列表、FFA 出生点配置以及每位玩家的个人装备。此文件在首次运行时自动创建 —— 无需手动编辑。

---

环境要求

• Paper（或基于 Paper 的分支）—— 该插件使用 Paper/Adventure API（Adventure 文本组件、AsyncChatEvent、现代世界高度方法）。
• Java 17+（与服务器的 Minecraft 版本要求相匹配）。

---

备注与限制

• 获胜者/队伍颜色取自固定的、小型调色板（Minecraft 旧版聊天颜色），而非任意 RGB，因为计分板队伍颜色仅限于该调色板。
• 自然生命恢复开关仅影响当前参与活动的玩家 —— 它按玩家为单位取消自然（由饥饿驱动的）恢复，而非修改世界的游戏规则，因此未参与的玩家和世界本身不受影响。其他治疗来源（药水、装备、击杀回血）无论此开关如何都正常工作。
• FFA 出生点生成会自动验证地面安全；手动放置的团队/精确 FFA 出生点也会被检查，但只会产生警告（管理员的放置位置优先于自动回退方案）。