item ban（物品禁用）

ItemBan

适用于 Minecraft Forge 的服务器端物品与方块黑名单控制

ItemBan 为服务器管理员提供了对服务器上允许使用的物品和方块的精确控制。被列入黑名单的内容会自动从物品栏、容器、物品展示框、掉落物以及（可选）游戏世界中移除——支持实时命令、NBT 规则、聊天公告、可选的自动封禁以及审计日志。

客户端无需安装此模组。

---

功能特性

物品黑名单

• 按 ID（modid:item）禁止任何物品
• 完整的 NBT / SNBT 支持（附魔、自定义名称、属性等）
• 自动从玩家物品栏、已打开的容器及大多数模组存储中移除
• 兼容 AE2、机械动力、精致背包、储物抽屉及标准容器

独立的方块黑名单

• 独立列表，存储于 block_blacklist.json
• 与物品相同的 NBT 匹配规则
• 可选的世界扫描，移除玩家附近的被禁方块

掉落物检测（两种模式）

模式	命令	行为
区域扫描（默认）	/itemban dropdetect on	每 2 tick，扫描玩家周围约 2 个区块并删除被禁掉落物
即时拦截	/itemban dropdetect off	在被禁物品实体生成时直接取消（1.0.2 风格）

环境扫描

• 每约 2 秒，扫描每位玩家周围 2 个区块半径
• 清除物品展示框中的被禁物品
• 可选的世界方块扫描（blockscan），垂直范围 ±16 格

公告与自动封禁

• 可选的聊天公告（显示物品/方块 ID + 截断的 NBT）
• 可选的通过 /ban 进行永久档案封禁，然后踢出
• 顺序：移除 → 公告 → 封禁
• 审计排除清单中的物品：仍然移除并公告，但不记录日志且不封禁

审计日志

• 日志位于 logs/ItemBan/ 下，按日存储
• 通过 /itemban logexclude 将特定 ID 从日志中排除

权限

• 创造模式及 OP 等级 2+ 完全豁免

---

命令

所有命令需要 OP 等级 2：

命令	描述
/itemban add <id>{nbt}	添加物品黑名单规则
/itemban remove <id>{nbt}	移除物品规则
/itemban list	列出物品黑名单
/itemban reload	重载配置
/itemban announce on/off	聊天公告开关
/itemban autoban on/off	自动封禁开关
/itemban dropdetect on/off	掉落物检测模式（区域 vs 即时）
/itemban blockscan on/off	世界方块扫描开关
/itemban block add/remove/list	管理方块黑名单
/itemban logexclude add/remove/list	管理审计排除清单

---

配置

在 config/ItemBan/ 下自动生成：

• blacklist.json — 物品黑名单
• block_blacklist.json — 方块黑名单
• config.json — 功能开关与排除项

物品规则示例：

[
  "minecraft:nether_star",
  {
    "id": "minecraft:diamond_sword",
    "nbtString": "{Enchantments:[{id:\"minecraft:sharpness\",lvl:5}]}"
  }
]

---

环境要求

• Minecraft：1.20.1
• 模组加载器：Forge 47.3.0+
• 端侧：服务器（客户端可选 / 非必需）

---

许可证

Apache License 2.0

---

作者

lnsanes

---

轻量级的服务器专用被禁物品与方块控制——通过命令在游戏中管理一切。