服务端物品黑名单管理器

自动库存清理、实时物品拦截、管理员豁免权限

完全服务端运行 —— 玩家无需下载任何客户端文件！

概述

物品黑名单管理器让服务器管理员可以完全管控玩家在服务器内可以持有的物品。无论你是想要禁止玩家使用泄露的管理员工具（超级工具、开发者手枪等）、限制强度超模的终局武器，还是维护严格的服务器经济体系，该模组都可以自动清理玩家背包，并实时拦截违规物品的使用。

由于本模组纯服务端运行，加入服务器的玩家不需要下载、安装任何东西！

如果同时在客户端 + 服务端部署模组，会主动持续清理背包，而不只是在物品被使用时才拦截。

主要功能

1. 纯服务端运行：仅安装在服务器 / 主机上即可。

2. 实时使用拦截：当玩家尝试挥动、射击、食用、放置黑名单内物品时，服务器会立刻阻断该行为，不会产生伤害、不会完成放置，同时当场删除该物品。

3. 完整背包扫描（客户端部署时生效）：定时扫描玩家快捷栏、背包、护甲装备栏以及手中正在持有的物品。

4. 客户端即时同步：强制刷新网络背包数据，确保被删除的物品立刻从玩家界面消失，不会残留 “幽灵假物品”。

5. 管理员豁免系统：可配置权限等级，管理员与版主可以正常持有、使用黑名单物品，普通玩家依旧受限制。

6. 配置热重载指令：游戏运行中修改Config.xml配置文件，通过控制台直接重载，无需重启服务器。

7. 自定义游戏内提示：当受限物品被移除时，会向对应玩家发送私聊提示消息。

工作原理

1. 后台扫描器：每隔 X 秒（默认 5 秒），服务器遍历所有非管理员在线玩家，检查快捷栏、背包、装备，查找配置文件Config.xml中登记的黑名单物品。

2. 即时行为阻断：如果玩家在两次扫描间隙获取到违禁物品，并尝试左键 / 右键使用，Harmony 钩子会拦截Inventory.Execute库存执行逻辑，取消攻击 / 使用指令，清除玩家手上的物品，并立刻更新客户端显示。

配置文件（Config.xml）

服务器首次启动时，会在模组文件夹内自动生成默认Config.xml：

<?xml version="1.0" encoding="utf-8"?>
<BlacklistConfig>
  <CheckIntervalSeconds>5.0</CheckIntervalSeconds>

  <BypassForAdmins>true</BypassForAdmins>

  <AdminPermissionLevel>0</AdminPermissionLevel>

  <NotifyPlayer>true</NotifyPlayer>

  <NotificationMessage>[SERVER] The item '{0}' is blacklisted and has been removed from your inventory.</NotificationMessage>

  <BlacklistedItems>
    <Item>adminSuperTool</Item>
    <Item>gunAdminPistol</Item>
    <Item>itemRingOfGod</Item>
    <Item>apparelAdminRing</Item>
    <Item>cntAdminChest</Item>
  </BlacklistedItems>
</BlacklistConfig>

注释说明：

• CheckIntervalSeconds：扫描间隔，单位秒

• BypassForAdmins：是否开启管理员豁免

• AdminPermissionLevel：管理员权限等级阈值

• NotifyPlayer：是否通知玩家物品被删除

• NotificationMessage：提示消息，{0}会自动替换为物品名称

• BlacklistedItems：黑名单物品列表

注意：添加黑名单物品，既可以填写游戏内部 XML 物品 ID（例如gunRocketLauncher火箭发射器），也可以填写游戏内显示的本地化中文名称。

游戏控制台指令

在服务器控制台（F1 按键 / Telnet / 网页后台）输入指令管理模组：

• blacklist reload（简写 bl reload）：立刻重载配置文件，不用重启服务器

• blacklist（简写 bl）：打印当前内存中加载的全部黑名单物品

安装教程（七日杀）

专用服务器 / 本地主机存档：

1. 下载并解压压缩包

2. 将Blacklist文件夹直接放到服务器的Mods目录：7 Days To Die/Mods/Blacklist/

3. 启动服务器，模组会在 Blacklist 文件夹自动生成Config.xml配置文件

4. 修改配置文件，填入你想要封禁的物品，在服务器控制台输入 bl reload 重载配置即可。

运行要求与兼容性

• 七日杀版本：兼容 1.0 及以上正式版本；已测试版本 3.1.0

• EAC 反作弊：完全兼容；纯服务端 Harmony 模组不需要关闭 EAC

• 依赖项：无额外依赖

补充小提示

• 只装服务端的情况下：只有玩家使用物品那一刻才会删除；不会主动扫描背包。

• 想要定时扫背包：需要客户端也装上这个 mod（主机玩家自己本地也要放 mod 文件夹）。

• AdminPermissionLevel>0：七日杀权限，0 是最高管理员，数字越大权限越低。