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。

---

功能

• 黑名单模式 - 允许普通模组，同时阻止选定的不公平类别
• 白名单模式 - 强制实施捕获的官方整合包列表
• 内置签名数据库 - 通过 ID 和稳定标记（如包名或 Mixin 配置）检测已知的不公平模组
• 管理员档案 - 查看每个玩家当前的模组、平台/加载器条目以及最近的更改
• 资源包审计 - 记录活跃和非活跃的资源包，以及添加/启用/禁用/删除的历史记录
• 可选的资源包封禁 - 通过确切的包 ID/名称或 SHA-256 指纹标记，默认禁用踢出
• 可读分组 - Fabric、Forge、NeoForge、API 和加载器噪音与玩家安装的模组分开
• 仅监控部署 - 记录并向工作人员发出警报而不踢出，同时调整规则
• 工作人员警报 - 在线的管理员可以看到实时发生的检测
• 绕过列表 - 通过名称或 UUID 豁免受信任的帐户或测试用户
• Floodgate/Geyser 支持 - 当存在 Floodgate 时，可选择性豁免基岩版玩家
• 热重载 - 无需重启即可重新加载配置和签名
• 服务器快照 - 将服务器或在线玩家捕获为官方白名单基线

---

命令

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

命令	作用
/fiwmods reload	重新加载配置和捆绑的签名
/fiwmods snapshot server	将服务器加载的模组捕获到白名单中
/fiwmods snapshot player <名称>	将在线玩家报告的模组捕获到白名单中
/fiwmods profile <名称>	显示分组的当前模组、资源包和最近的档案历史记录

---

配置

配置文件生成于：

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
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 模组
• 审计那些短暂启用、禁用或删除可疑资源包的玩家
• 在实施强制措施之前，使用仅监控记录进行渐进式反作弊部署

---

文档

完整的英文文档随模组一起发布在 DOCS_EN.md 文件中：包含加入协议、完整的配置参考、两种模式、签名数据库、命令、每个玩家的档案以及故障排除。

---

许可证

Fiw AntiCheat 根据 Fiw AntiCheat 许可证（署名-非商业性使用） 发布。只要您明确地、显眼地标明原作者（Fi3w0）并附上返回链接，同时保留现有的声明，您就可以自由地使用、修改、复刻和重新分发它——包括修改后的版本。未经书面许可，不得出售 它或任何复刻版本（在服务器上运行它，即使是盈利性服务器，也是允许的）。Fi3w0 保留原始作品的作者身份。

联系方式：Discord fi3w0。

联系我：Github/Discord 上的 @Fi3w0

---

由 Fi3w0 制作 —— 为一个私人 SMP 构建，与所有人分享。