
Fabric 客户端检查器
Fabric 1.21.11 的服务端客户端指纹识别:品牌、插件通道和翻译键探测可识别每位玩家所使用的客户端。按规则进行提醒、踢出或封禁。可选客户端部分会报告完整模组列表。
Client Inspector 是一个适用于 Minecraft 1.21.11 的服务端 Fabric 模组,它会为每个加入的客户端生成指纹,并根据你控制的规则发出警报、踢出或封禁。客户端无需安装任何东西:原版玩家照常加入,模组玩家在进入时会被检查。如果玩家也在客户端中放入相同的 jar,他们会在加入时报告完整的模组列表,服务器可以将此设为强制要求。
与 Aquerr 的 Forge 模组 “Client Inspector” 无关:这是一个独立的 Fabric 项目,只是恰好同名。
它回答了 Grim 和其他行为反作弊无法回答的一个问题:这个玩家实际运行的是什么客户端?
它检查什么
每个客户端无需任何配套模组就会向服务器泄露三样东西:
- Brand - 在配置阶段发送的字符串(
vanilla、fabric、lunarclient:...,fabric)。 - 插件通道 - Fabric API 会告诉服务器客户端模组可以接收的每个通道。命名空间通常是模组 id,因此 Lunar、Feather、LabyMod、Xaero's、Simple Voice Chat 等会在这里表明身份。
- 翻译键和按键绑定 - 告示牌探测(MC-265322)。加入几秒后,服务器向客户端显示一个隐形告示牌,其各行内容为可翻译组件或按键绑定组件,在同一 tick 内打开并关闭告示牌编辑器,然后读取回复。拥有某模组语言文件的客户端会返回翻译;注册了按键绑定的客户端会返回绑定的按键;原版会返回原始 id。
所有观察到的内容都会按玩家保存,并可通过 /clientinspector profile <name> 查看,即使玩家已经离开。
它能捕获什么
- 开箱即用的 Meteor Client,以及 Meteor+ 和 Meteorist 附加组件(探测)。
- ThunderHack Recode 和 Reborn(探测)。
- Freecam、SeedcrackerX、Advanced XRay、X to Xray - 以仅警报的
DISALLOWED规则提供;如果你要禁止它们,请将其提升为KICK。 - 伪造的 brand:LiquidBounce 和 ThunderHack 的 Lunar 伪装模式会发送真实客户端不会发送的硬编码版本字符串;Fabric 通道旁边的
vanillabrand 是谎言。 - 翻译过滤器(ExploitPreventer、手动白名单模式下的 OpSec),通过金丝雀键检测,这些键必须在通道证明模组已安装的客户端上解析。
- 合法客户端(Lunar、Feather、LabyMod、Badlion、Essential、Replay Mod、Xaero's、Simple Voice Chat)会被识别并仅记录日志。
它不能捕获什么
在依赖它之前请阅读此部分。
- 每个 Fabric 作弊客户端都不注册插件通道,并保持 brand 为
fabric。仅凭 brand 加通道无法将它们与诚实的 Fabric 玩家区分开;探测才是检测手段。 - Wurst(7.44+)和 LiquidBounce 将字符串保存在原版语言系统之外。Aoba、Shoreline、schizoid、Baritone、BleachHack 以及大多数 Meteor 附加组件不附带语言文件。探测无法看到它们中的任何一个。
- OpSec 在其默认 AUTO 模式下会白名单所有注册通道的模组,而这正是金丝雀所依赖的证据,因此其用户仍然隐藏 Meteor。没有任何被动手段能击败以这种方式配置的隐藏器;客户端部分可以,对于安装了它的玩家而言。
- 任何人都可以重新编译客户端来说谎。Client Inspector 阻止的是不知情者,而不是决心已定者。行为方面请继续使用 Grim。
客户端部分(可选)
同一个 jar 也可以在客户端上运行。将其放入客户端 mods/ 文件夹(Fabric API 旁边)的玩家会在加入时报告其模组列表:Fabric Loader 加载的每个模组,包括其版本和 jar 的 SHA-256。该列表来自 Fabric Loader 本身,因此 OpSec 和其他翻译过滤器无法对其隐藏任何内容。OpSec AUTO 背后对探测不可见的 Meteor 会显示为 meteor-client,并在世界加载前被 reported-hack 规则踢出。
- 服务器只询问拥有该 jar 的客户端(它们注册其通道);其他所有人不会被询问,也不会被耽搁。
- 客户端在启动时在后台对其 jar 进行一次哈希计算,写入一行日志,没有设置或界面。在没有 Client Inspector 的服务器上,它不发送任何内容,单人游戏和局域网世界永远不会被检查。
- 服务器会将报告与探测结果交叉核对。如果报告遗漏了探测刚刚证明的模组,或遗漏了 Fabric API,则标记为
MISMATCH,并由companion-mismatch规则踢出。
模式(companion.mode,或 /clientinspector companion <mode>):off;optional(默认:拥有该 jar 的客户端报告,所有人都可加入);required(没有该 jar 的客户端在到达世界之前被拒绝,并显示一条说明下载位置的消息;管理员、绕过权限持有者和 Geyser 玩家豁免)。
它不能做到的事:
- 在
optional模式下,它只覆盖选择安装它的玩家,而作弊者干脆不安装。required是唯一能影响拒绝安装它的玩家的模式。 required也会拒绝原版、Lunar、Forge 以及所有其他无法加载 Fabric 模组的客户端:对于玩家你了解的私有 Fabric 服务器是正确的,对于公共服务器则是错误的。- 报告由客户端整理,客户端部分的修改副本可以发送任何它想要的列表。只有当探测能看到隐藏的模组时,交叉核对才能发现伪造的列表。请将其视为在你认识的人之间的一种强力威慑,而非证据。
安装
- 在服务器的
mods/文件夹中放入 Fabric Loader 0.18.4+ 和适用于 1.21.11 的 Fabric API。 - 将 Client Inspector jar 放在它们旁边。LuckPerms 是可选的,但推荐使用。
- 启动服务器一次;会创建
config/clientinspector/config.json和config/clientinspector/rules.json。 - 给工作人员
clientinspector.alerts(默认 op 等级 2),给自己clientinspector.admin。
在最初几天将 monitor_only 设为 true:踢出和封禁随后会报告为未执行,以便你在让其采取行动之前阅读警报。
对于客户端部分,玩家将相同的 jar 放入其客户端的 mods/ 文件夹(Fabric API 旁边)。从 0.1.x 升级:替换 jar 并重启;rules.json 会一次性获得新的默认规则,并保留你自己的修改。
命令(clientinspector.admin)
/clientinspector- 规则数量、探测状态、跟踪的连接;/ci是每个子命令的简短别名/clientinspector online- 每个玩家一行:brand、通道数量、探测结果、匹配项,以及客户端部分是否报告/clientinspector profile <name>- 玩家(在线或不在线)的所有观察内容,包括报告的模组列表/clientinspector probe <player> [selftest]- 重新运行探测;selftest添加一个原版键,证明探测在你的服务器上有效/clientinspector rules- 已加载的规则及其类别、置信度和操作/clientinspector alerts on|off- 为你自己静音游戏内警报/clientinspector companion [off|optional|required]- 显示或设置客户端部分模式/clientinspector reload- 重新读取两个配置文件
权限:clientinspector.admin、clientinspector.alerts、clientinspector.bypass(永不被踢出或封禁)。管理员自动豁免踢出和封禁。
规则
config/clientinspector/rules.json 是一个 JSON 数组。条件:brand(正则)、channels_any、channels_all、channels_none、no_channels、translation_keys、keybind_keys、probe_state,以及对于客户端部分:reported_mods_any(id 或 glob)和 companion_state。操作:LOG、ALERT、WEBHOOK(Discord 嵌入)、COMMAND、BAN、KICK。占位符 %player%、%uuid%、%rule%、%client%、%brand%、%reported%、%confidence%、%category% 可用于消息和命令中。默认仅在置信度高的 HACK 和 SPOOF 匹配时踢出;其他所有情况发出警报。
指纹的来源
每条默认规则都得到客户端自身源代码或语言文件的支持,读取自仓库变更日志中列出的提交。通道和翻译键名称是可观察的事实;不包含其他反作弊的任何代码或配置。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。