服务器端物品黑名单管理器

服务器端物品黑名单管理器

轻量级、100%服务端模组,当玩家尝试使用黑名单物品时,自动从玩家快捷栏和装备中删除该物品。实时阻止使用,支持管理员绕过,且无需客户端下载任何内容。让开发工具和违禁物品远离你的服务器!扫描玩家背包,阻止黑名单物品的使用并移除该物品。

[center][size=6][b]服务端物品黑名单管理器[/b][/size]
[size=4][i]自动清理物品栏、实时拦截物品与管理员豁免[/i][/size]

[color=#00ff88][b]100% 服务端运行 — 客户端无需下载任何内容![/b][/color][/center]

[line]

[size=5][b]概述[/b][/size]
[b]物品黑名单管理器[/b]让服务器管理员可以完全控制玩家在服务器上允许拥有哪些物品。无论你是想阻止玩家使用泄露的管理员工具(如 Super Tool 或 Dev Pistol)、限制过于强大的终局武器,还是维护严格的服务器经济体系,此模组都会自动清理玩家物品栏并实时拦截物品的使用。

由于此模组[b]完全在服务端运行[/b],加入你服务器的玩家[b]无需[/b]下载或安装任何内容!
如果在客户端和服务端同时运行,将会主动进行背包清理,而不仅仅是在使用物品时。

[line]

[size=5][b]主要功能[/b][/size]
[list]
[][b]100% 服务端运行:[/b]仅安装在服务器或主机上。[/]
[][b]实时使用拦截:[/b]如果玩家试图挥动、射击、食用或放置黑名单物品,该操作会在服务端被立即阻止,并在任何伤害或放置发生前拦截,物品会当场被删除。[/]
[][b]客户端运行时进行全面物品栏扫描:[/b]定期扫描玩家的工具栏(快捷栏)、背包、服装/护甲槽以及与手中正在持有的物品。[/]
[][b]即时客户端同步:[/b]强制刷新网络物品栏,确保已删除的物品立即从玩家屏幕上消失(不会残留“幽灵”物品)。[/]
[][b]管理员豁免系统:[/b]可配置的管理员检查,允许管理员和版主(基于权限等级)保留并自由使用黑名单物品,而普通玩家则受到限制。[/]
[][b]配置热重载命令:[/b]在游戏运行时编辑 [font=Courier New]Config.xml[/font],并通过控制台即时重新加载,无需重启服务器![/]
[][b]自定义游戏内通知:[/b]当受限物品被移除时,直接向玩家发送私聊消息。[/]
[/list]
[line]

[size=5][b]工作原理[/b][/size]
1. [b]后台扫描器:[/b]每隔 X 秒(默认 5.0 秒),服务器会遍历已连接的非管理员玩家,检查他们的工具栏、背包和装备中是否有 [font=Courier New]Config.xml[/font] 中列出的物品。
2. [b]即时操作拦截:[/b]如果玩家在扫描循环间隔期间以某种方式获得了受限物品,并试图用其左键或右键操作,Harmony 钩子会拦截 [font=Courier New]Inventory.Execute[/font],取消攻击/使用命令,从玩家手中清除该物品,并立即更新其客户端模型。

[line]

[size=5][b]配置([font=Courier New]Config.xml[/font])[/b][/size]
服务器首次启动时,会在模组文件夹内自动生成一个默认的 [font=Courier New]Config.xml[/font] 文件:

[code]
<?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>[/code]
[i]注意:你可以使用物品的内部 XML 名称(例如 [font=Courier New]gunRocketLauncher[/font])或本地化显示名称(例如 [font=Courier New]Rocket Launcher[/font])来添加物品。[/i]

[line]

[size=5][b]游戏内控制台命令[/b][/size]
你可以使用服务器控制台(F1 或 Telnet/WebDashboard)管理此模组:

[list]
[][font=Courier New]blacklist reload[/font](或 [font=Courier New]bl reload[/font]):从磁盘即时重新加载 [font=Courier New]Config.xml[/font],无需重启服务器。[/]
[][font=Courier New]blacklist[/font](或 [font=Courier New]bl[/font]):打印当前已加载到内存中的黑名单物品列表。[/]
[/list]
[line]

[size=5][b]安装[/b][/size]
[b]用于专用服务器/主机存档:[/b]
1. 下载并解压压缩包。
2. 将 [font=Courier New]Blacklist[/font] 文件夹直接放入服务器的 [font=Courier New]Mods[/font] 目录:
  [font=Courier New]7 Days To Die/Mods/Blacklist/[/font]
3. 启动服务器。模组会在 [font=Courier New]Blacklist[/font] 文件夹内生成 [font=Courier New]Config.xml[/font]。
4. 用你希望禁用的物品编辑 [font=Courier New]Config.xml[/font],然后在服务器控制台输入 [font=Courier New]bl reload[/font]!

[line]

[size=5][b]要求与兼容性[/b][/size]
[list]
[][b]7 Days to Die 版本:[/b]兼容 1.0 / V1.0+ 稳定版本。[/]
[][b]EAC(Easy Anti-Cheat):[/b]完全兼容。仅服务端运行的 Harmony 模组无需禁用 EAC。[/]
[][b]依赖项:[/b]无![/]
[/list]