禁用物品

禁用物品

一个轻量级服务端模组,允许管理员根据物品的完整指纹(注册表 ID + NBT)禁用特定物品。被禁用的物品无论出现在何处(背包、光标、地面、工作台或铁砧)都会被自动销毁。

管理

禁用物品模组

NeoForge 21.1.220 | Minecraft 1.21.1 | 仅服务端

一个轻量级服务端模组,允许管理员按完整的物品指纹(注册表 ID + 所有数据组件 / NBT)禁用特定物品。被禁用的物品无论在何处出现都会被自动销毁:物品栏、光标、地面、工作台或铁砧。


命令 (需要管理员等级 2)

命令 描述
/banhanditem 禁用你主手中当前持有的物品。从你手中删除该物品,并扫描你物品栏的其余部分以查找副本。立即保存到配置文件。
/unbanhanditem 解除禁用你主手中当前持有的物品。
/banneditemslist 将所有当前被禁用的物品打印到聊天栏。
/reloadbanneditems 重新加载 config/banneditems.json,无需重启服务器。

禁用工作原理

  1. 手持一个物品并运行 /banhanditem。
  2. 模组将完整物品(物品 ID + 每个数据组件,如附魔、自定义名称、描述、药水效果等)序列化为 SNBT 并存储到 config/banneditems.json。
  3. 从那一刻起,任何同时匹配物品类型和所有数据组件的物品堆叠都会被视为已禁用。
  4. 禁用为精确匹配:一把带有锋利 V 的钻石剑与一把普通钻石剑是不同的条目。这让你可以禁用特定的作弊物品而不影响正常物品。

强制执行

触发条件 操作
物品栏扫描(每 1 秒) 从全部 41 个物品栏槽位和光标槽位移除被禁用的物品
合成输出 将结果堆叠清零,使玩家无法获得任何物品
右键点击方块 / 空中 事件被取消;物品无法使用
左键点击 / 攻击 事件被取消
从地面拾取物品 物品实体立即被丢弃
铁砧(修理 / 重命名) 输出被阻止

配置文件

config/banneditems.json —— 一个 SNBT 字符串的 JSON 数组。

[
  "{id:\"minecraft:diamond_sword\",count:1}",
  "{id:\"minecraft:tnt\",count:1,components:{\"minecraft:custom_name\":\"{\\\"text\\\":\\\"Super TNT\\\"}\"} }"
]

你可以手动编辑此文件并运行 /reloadbanneditems 来应用更改,无需重启。