Fiw AntiCheat

Fiw AntiCheat

面向 Minecraft 服务器的专业模组验证、整合包强制执行和管理员调查工具。

Fiw AntiCheat 帮助服主应对不受欢迎的客户端模组，而无需猜测玩家运行了什么。玩家加入时，服务器会向客户端配套模组发起挑战，记录其上报的模组列表，按可配置规则进行检查，并为管理员提供可读的强制执行、逐步推广和调查工具。

这是为真实的服务器管理而打造的：将已知的不公平模组加入黑名单，审计可疑的资源包，通过白名单强制执行官方整合包，在踢出玩家前先监控检测结果，并保留每位玩家的档案，让工作人员能看到随时间发生的变化。

为什么选择 Fiw AntiCheat？

大多数反作弊方案只关注移动或战斗行为。Fiw AntiCheat 关注的是客户端模组可见性和整合包完整性：

• 检测常见的不公平模组类别，如作弊客户端、X 光、全亮、自由视角、自动点击器和原理图打印机
• 审计启用和未启用的资源包，包括以常见名称残留安装的 X 光/全亮资源包
• 为私人 SMP、活动、工作人员服务器和模组社区强制执行官方整合包列表
• 保留可读的玩家档案，将嘈杂的加载器/API 条目与真正安装的模组和资源包区分开
• 让管理员通过仅监控模式安全地推行规则，然后再踢出玩家
• 通过一个共享规则引擎，同时支持 Fabric、Forge 和 NeoForge 目标

Fiw AntiCheat 是一个管理员强制执行工具和模组验证层。它不是魔法，也不声称能防作弊：恶意的自定义客户端可以说谎。它的设计目的是让诚实客户端可被强制执行，捕获常见的不受欢迎模组，并为工作人员提供实用的可见性。

支持的目标

| 加载器 | Minecraft | 状态 |
|—|—|—|
| Fabric | 1.21.1 | 活跃 |
| NeoForge | 1.21.1 | 活跃 |
| Fabric | 1.21.11 | 活跃 |
| NeoForge | 1.21.11 | 活跃 |
| Fabric | 1.20.1 | 活跃 |
| MinecraftForge | 1.20.1 | 活跃 |

NeoForge 在当前 NeoForge Maven 上并未发布真正的 Minecraft 1.20.1 构件，因此 1.20.1 Forge 系列构建面向 MinecraftForge 47.x。

没有 Minecraft 1.21.8 构建。请在服务器和玩家客户端上使用相同版本的 Fiw AntiCheat。

功能

• 黑名单模式 – 允许正常模组，同时屏蔽选定的不公平类别
• 白名单模式 – 强制使用已捕获的官方整合包列表
• 内置签名数据库 – 通过模组 ID 和稳定的软件包标记检测已知的不公平模组
• 管理员档案 – 查看每位玩家当前的模组、平台/加载器条目及近期变更
• 资源包审计 – 记录已启用和未启用的资源包，以及添加/启用/禁用/移除记录
• 可选的资源包封禁 – 根据精确的资源包 ID/名称或 SHA-256 指纹进行标记；默认不启用踢出功能
• 清晰分组 – 将 Fabric、Forge、NeoForge、前置库和加载器相关内容与玩家安装的模组分开显示
• 仅监控部署 – 调整规则期间只记录并提醒管理人员，不踢出玩家
• 管理人员提醒 – 在线管理员可实时查看检测结果
• 绕过名单 – 按名称或 UUID 将受信任的账号或测试用户设为豁免对象
• 分级豁免 – 可为每位玩家授予bypass、silent、monitor、quiet_kick、固定的preset或force_block，并可设置过期时间及管理员定义的重复检测后自动升级规则
• Floodgate/Geyser 支持 – 存在 Floodgate 时，可选择豁免基岩版玩家
• 热重载 – 从已安装的 jar 重新读取config/fiw-mods-api/config.json和内置签名；不会加载外部签名文件
• 服务器快照 – 将服务器或在线玩家捕获为官方白名单基准

命令

所有命令都需要权限等级 4。

| 命令 | 功能 |
|—|—|
| /fiwmods reload | 重新加载配置和内置签名 |
| /fiwmods snapshot server | 将服务器已加载的模组捕获并加入白名单 |
| /fiwmods snapshot player <name> | 将在线玩家报告的模组捕获并加入白名单 |
| /fiwmods recheck player <name> / recheck all | 对在线玩家重新执行模组检查，不会冻结玩家 |
| /fiwmods profile <name> | 显示分组后的当前模组、资源包和近期档案记录 |
| /fiwmods exempt add <player> <tier> [hours] [preset] | 授予豁免等级，可选设置过期时间和预设名称 |
| /fiwmods exempt remove <player> | 移除玩家的所有豁免 |
| /fiwmods exempt list | 列出所有有效豁免 |

配置

配置文件生成于：

config/fiw-mods-api/config.json

内部配置文件夹会保留原始 ID 以确保兼容性，尽管该模组的公开名称为 Fiw AntiCheat。

主要选项：

| 选项 | 用途 |
|—|—|
| mode | blacklist 或 whitelist |
| detection.preset | strict、balanced、lenient 或 custom |
| detection.monitor_only | 记录检测结果但不踢出 |
| detection.allow_overrides | 即使预设阻止，也允许特定的签名/类别 |
| detection.banned_mods | 将确切的模组 ID 添加到阻止列表 |
| resource_packs.log | 在档案中记录启用/禁用的资源包 |
| resource_packs.kick_on_banned | 对匹配配置的整合包执行踢出；默认为仅记录 |
| resource_packs.banned_packs | 将确切的整合包 ID 或显示名称添加到标记列表 |
| resource_packs.banned_fingerprints | 添加确切的 SHA-256 整合包哈希以标记改名的整合包 |
| exemptions.bypass_players | 对特定名称或 UUID 完全绕过（完全不扫描） |
| exemptions.player_overrides | 通过 /fiwmods exempt add 授予的每玩家豁免层级（silent、monitor、quiet_kick、preset、force_block），可选过期时间 |
| exemptions.escalation_rules | 玩家在时间窗口内累积多次检测后自动应用层级 |
| whitelist.official_mods | 白名单模式下使用的官方整合包快照 |

要求

| 目标 | 要求 |
|—|—|
| Fabric 1.20.1 | Fabric Loader、Fabric API、Java 17 |
| MinecraftForge 1.20.1 | Forge 47.x、Java 17 |
| Fabric 1.21.1 | Fabric Loader、Fabric API、Java 21 |
| NeoForge 1.21.1 | NeoForge 21.1.x、Java 21 |
| Fabric 1.21.11 | Fabric Loader 0.19.2+、Fabric API 0.141.4+1.21.11、Java 21 |
| NeoForge 1.21.11 | NeoForge 21.11.x、Java 21 |

在服务端和玩家客户端上安装 Fiw AntiCheat。客户端配套模组负责向服务端报告模组列表和资源包状态。

最佳用途

• 私人 SMP 整合包强制执行
• 要求所有人使用相同模组列表的活动服务器
• 让管理员查看可疑或变化的客户端配置
• 阻止常见的不公平实用模组，而不锁定无害的 QoL 模组
• 审计短暂启用、禁用或删除可疑资源包的玩家
• 在强制执行前以仅监控日志方式逐步推出反作弊

收集哪些数据

服务端接收每个玩家的模组 ID、版本、SHA-256 哈希和包标记，以及他们启用和禁用的资源包（ID、名称、哈希、状态）。config/fiw-mods-api/profiles/ 中的档案会保留玩家名称和 UUID、访问记录、模组 ID 和版本、资源包以及更改/检测历史；模组哈希和包标记不会存储在档案中。白名单快照将模组哈希存储在 config.json 中，日志可能包含检测和更改。档案没有自动过期。可以在配置中关闭档案记录和资源包审计。

文档

完整的英文文档随模组附带在 DOCS_EN.md 中：加入
协议、完整配置参考、两种模式、签名数据库、
命令、每玩家档案和故障排除。

许可证

Fiw AntiCheat 在 Fiw AntiCheat 许可证（署名、
非商业） 下发布。你可以自由使用、修改、分叉和再分发
它——包括修改后的构建——只要给予清晰可见的署名
给原始创作者（Fi3w0）并附上回链，且保留现有声明不变。
未经书面许可，你不得出售它或任何分叉（在
服务器上运行它，即使是盈利服务器，也没问题）。Fi3w0 保留原始
作品的作者身份。

联系方式：Discord fi3w0。

联系我：Github/Discord 上的 @Fi3w0

由 Fi3w0 制作——为私人 SMP 打造，与所有人分享。