物品净化器

物品净化器

轻量级服务器端Minecraft模组,可从玩家物品栏中移除被禁物品

管理

物品净化器允许服务器管理员在配置文件中定义黑名单物品列表

功能:

  • 黑名单强制执行:自动从玩家物品栏中移除黑名单物品。
  • 玩家通知:当黑名单物品被移除时,向玩家显示一条消息。
  • 玩家白名单:通过 playersWhitelist 允许特定玩家使用特定的黑名单物品。
  • 可配置:在配置文件中轻松定义黑名单物品。
  • OP 绕过:可选择允许服务器管理员(OP)使用黑名单物品。
  • 双端同步:配置从服务器同步到客户端,确保执行一致。

使用场景:

  • 防止在生存或竞技服务器中使用过于强大或具有破坏性的物品。
  • 执行服务器规则并维护平衡的游戏环境。
  • 授予特定玩家访问某些物品的权限(例如,工作人员、建筑者)。

兼容性:

  • 兼容 Minecraft 1.20.1 和 Forge。
  • 需要在服务器和客户端上同时安装才能获得完整功能(黑名单同步和工具提示阻止)。

安装:

  1. 将模组的 JAR 文件放入服务器和客户端的 mods 文件夹中。
  2. 启动服务器以生成配置文件。
  3. 编辑配置文件以定义你的黑名单和玩家白名单。
  4. 重启服务器以应用更改。

命令:

  • /itemsanitizer reload:无需重启服务器即可重新加载配置文件。

权限:

  • 如果配置文件中启用,服务器管理员(OP)可以绕过物品限制。
  • playersWhitelist 中列出的玩家可以使用其白名单物品,不受黑名单限制。

配置:

配置文件位于 config/itemsanitizer.json。你可以使用 blacklistedItems 列表定义黑名单物品。列表中的每一项可以是特定物品 ID 或使用正则表达式的模式。

示例配置:

{
  "blacklistedItems": [
    "minecraft:tnt",
    "minecraft:tnt_minecart",
    "!minecraft:.*_spawn_egg",
    "tfmg:advanced_potato_cannon",
    "tfmg:segmented_display"
  ],
  "allowOpsUseBlacklistedItems": true,
  "playersWhitelist": {
    "BuilderSteve": ["minecraft:bedrock", "minecraft:command_block"],
    "AdminAlex": ["*"]
  }
}
  • 特定物品:添加确切的物品 ID(例如 minecraft:tnt)。
  • 模式:使用 ! 后跟正则表达式来匹配多个物品(例如 !minecraft:.*_spawn_egg 匹配所有刷怪蛋)。
  • 玩家白名单:玩家名称到物品 ID 列表的映射,这些物品 ID 是他们尽管在黑名单中仍被允许使用的。
    • 使用 "*" 作为唯一条目以允许特定玩家使用所有物品。
    • 未列入 playersWhitelist 的玩家受正常黑名单规则约束。

注意事项:

  • 对配置文件的更改需要重启服务器或使用 /itemsanitizer reload 命令才能生效。
  • 确保物品 ID 或模式有效,以避免错误。
  • 模组必须安装在客户端上,以接收同步的配置并防止黑名单物品出现在工具提示中。