玩家工具箱

玩家工具 (Player Utils)

一个为 NeoForge 1.21.1 打造的功能强大的管理模组，添加了四个用于游戏控制的基本命令。


---

✨ 功能特性

• /choke – 强制玩家窒息，除非满足特定的物品栏条件。
  氧气会迅速耗尽，耗尽后造成伤害。条件是可选的。
• /health – 将玩家的生命值锁定在固定值（1-100），直到满足条件。
  支持可选的物品栏条件。
• /pvp – 禁用玩家攻击其他玩家的能力。
  简单的开关切换。
• /autosp – 死亡时自动将你的出生点设置为你死亡的位置。
  点击重生按钮即可在你死亡的位置精确重生。

所有状态持久化保存在每个玩家的 NBT 数据中，服务器重启和重新登录后仍然有效。

---

📖 命令参考

/choke

子命令	语法	描述
start	/choke start <targets> [slotList]	使目标玩家开始窒息。如果省略 slotList，效果为无条件（始终激活）。
stop	/choke stop [targets]	停止效果。如果未指定目标，则作用于命令发送者。

/health

子命令	语法	描述
start	/health start <target> <health> [slotList]	将目标的生命值锁定为给定值（1-100）。如果省略 slotList，锁定为无条件。
stop	/health stop [target]	解除锁定并将最大生命值恢复为 20。

/pvp

子命令	语法	描述
start	/pvp start <targets>	为目标禁用 PvP（他们无法伤害其他玩家）。
stop	/pvp stop [targets]	重新启用 PvP。

/autosp

子命令	语法	描述
start	/autosp start <targets>	启用自动出生点 – 死亡后，玩家的出生点将设置为其死亡位置。
stop	/autosp stop [targets]	禁用此功能。

---

🧩 SlotList 格式（用于 /choke 和 /health）

slotList 是一个可选的 JSON 数组，用于定义特定物品栏槽位的条件。
每个条目是一个对象，键为槽位名称，值为包含物品 ID 和所需数量的对象。

槽位名称：

• hotbar.0 到 hotbar.8 – 快捷栏
• inventory.9 到 inventory.35 – 物品栏
• armor.head、armor.chest、armor.legs、armor.feet – 盔甲栏
• offhand – 副手

物品格式： "namespace:item"（例如，"minecraft:diamond"）。
数量是可选的；如果省略，则接受任意数量。同一槽位中的多个物品为或关系（满足其中任意一个即可）。

示例：

[
  {"hotbar.8": {"minecraft:bedrock": 1}},
  {"armor.head": {"create:diving_helmet": 1, "create:netherite_diving_helmet": 1}},
  {"inventory.32": {"minecraft:netherite_block": 32}}
]

这需要满足：

• 快捷栏第 8 格（最后一个快捷栏槽位）至少有 1 个基岩。
• 头盔槽位有任意一个潜水头盔或下界合金潜水头盔。
• 物品栏第 32 格恰好有 32 个下界合金块。

---

🔒 权限

所有命令都需要OP 等级 2（大多数服务器管理员的默认等级）。
在单人游戏中，请启用作弊或在服务器环境中使用 /op。

---

📝 许可协议

除非源代码中另有说明，否则本模组根据保留所有权利分发。
您可以在您的服务器上使用它，但重新分发或修改需要获得作者的明确许可。

---

🙏 致谢

• NeoForge 提供了模组框架。
• 所有贡献者和测试者。

---

📞 联系方式

作者：DogOfFurina
问题与建议：GitHub Issues

---