Defixus Anti-Cheat

模组

· 作者 Kole07139

Defixus (Lex) - 客户端与服务器之间的模组,可阻止作弊客户端并增强你对服务器的控制。同时也是一个提升管理体验的工具。免费。

6 本站下载 0 关注 更新于 1 个月前

最新 1.1.0-beta.1 · 26.3 · NeoForge

一键开服(送7天)

?️ Defixus:反作弊与 QoL 管理工具

? 终极反作弊模组,具备完整性保护 ?

检测非授权资源 • 验证文件完整性 • 监控实时变更 • 资源哈希分析 • 保护你的社区

活跃支持:Minecraft 26.x 和 1.21.11


⚡ ? SHA-256 验证与客户端检查器 ? ⚡

Defixus 是一款功能强大的防篡改与验证系统,适用于 Fabric/Quilt 和 NeoForge 服务器,并包含大量提升体验(QoL)的功能。

Defixus 内部正在开发运行时行为反作弊模块,欢迎在 Ko-fi 上支持本项目

支持 Geyser/Floodgate 及 ViaVersion/ViaBackwards 身份认证

与传统基于模组 ID 的“白名单/黑名单”方案不同,Defixus 不仅验证加载了哪些模组,还通过 SHA-256 校验和哈希以及二进制文件行为检查来验证其完整性,确保作弊、伪装或篡改过的客户端无法绕过由 Defixus 定义的服务端安全策略。 无论大型还是小型社区,只要需要对客户端环境进行控制,Defixus 都是理想之选。


✨ 功能特性

为你的 SMP 或社区提供清晰的客户端规则,分享社区所需的资源,并将实用的管理工具触手可及。

  • ? 模组与资源包规则,支持允许列表、检查列表、禁止列表和必选列表。
  • ? SHA-256 完整性检查,用于参考文件和 Defixus 客户端本身。
  • ⬇️ 服务端必需资源,在进入世界前需获得玩家同意方可准备。
  • ? 游戏内客户端扫描,支持单个或批量 客户端 → 服务端下载。
  • ? 活跃的资源包变更报告,并提供阻止正常选择资源包的选项。
  • ?️ 游戏内设置面板,分页聊天报告以及多人服务器列表指示器。
  • ? 双向 Discord 控制台,使用你在 Minecraft 中运行的自己的机器人(也支持单向 Webhook 控制台)。
  • ? Discord 事件警报,包括配置的由玩家发出的命令,使用 Webhooks 发送。
  • ? 持久的服务器与玩家统计数据。
  • ? 多种客户端消息语言,用于警报、踢人等场景。

? 从 安装 开始,或访问 Defixus Wiki 获取完整指南。


?️ 为什么选择 Defixus?

运营一个社区服务器通常意味着要回答一个简单的问题:哪些客户端资源属于这里?

下表回答了这个问题。理解此处所称的 ? 资源 和 ? 列表 至关重要。

  • 一个 ? 资源 要么是一个 ? 模组,要么是一个 ? 资源包。
? 列表 在此列表中的 ? 资源意味着
? 允许列表 (Allowlist)
“此资源被欢迎加入服务器。” 不需要特定的文件版本。对模组使用 mod-id,对资源包使用标准化名称。
? 检查列表 (Checklist)
“如果你使用此资源,它必须逐比特匹配(SHA-256 校验和),如果不匹配,则会被自动踢出服务器。”
? 禁止列表 (Denylist)
“此资源被禁止使用。” 对模组使用 mod-id,对资源包使用标准化名称。
? 必选列表 (Mustlist)
“每个人都需要激活完全相同的模组或资源包。” 它必须逐比特匹配(SHA-256 校验和),如果不匹配,玩家将无法加入服务器。附带一个简单的“同步必选列表至服务器”按钮,因此客户端无需手动安装必备资源。这是 ?️ 整合包的完美选择。
  • ⚪ 已批准 (Allowed) 资源:存在于 ? 允许列表 和 ? 必选列表 中的资源,或者存在于 ? 检查列表 且与服务端对应资源的文件完整性匹配的资源,被标记为 ⚪ 已批准。

  • ? 未批准 (Unapproved) 资源:不存在于 ? 允许列表 和 ? 检查列表 中的资源,被标记为 ? 未批准。当启用 kick-unapproved-* 设置时,未批准的资源可能成为 ⚫ 被禁止 (Prohibited) 的。

  • ⚫ 禁止(Prohibited) 资源:存在于 ? 检查清单(Checklist) 中且文件完整性不匹配的资源,或存在于 ? 黑名单(Denylist) 中的资源。此类资源被标记为 ⚫ 禁止,并会导致玩家被踢出服务器。

仅引用检查清单条目 并不要求 玩家安装该资源。当必须存在某资源时(例如面向整合包的服务器),请使用必选列表(Mustlist)。

对于普通模组规则,黑名单具有最高优先级,其次是白名单或已识别的库,最后是检查清单。内置白名单条目和整合包例外情况同样适用,因此在配置严格模式的整合包时,请查阅 验证与安全规则。

开发中也包含一个高成功率的运行时反作弊系统,它不基于 ? 资源,而是基于行为运行时检查(如 Vulkan 等)。目前该项目仍在进行中,预计将在未来几个月内发布。可以考虑 在 Ko-Fi 上捐赠 以支持本项目。


⚡ 验证流程

Defixus 使用客户端报告的加载器模组库存和选定的资源包进行验证。

连接到服务器
         │
         ▼
准备必选列表(Mustlist)资源(如需)
审查 → 批准 → 下载并校验
         │
         ▼
所需模组已加载且资源包已激活?
         │
         ▼
进入世界并发送验证报告
         │
         ▼
Defixus 放行 → 完整性检查 → 普通服务器规则
         │
    ┌────┴─────┐
    ▼          ▼
  接受       拒绝
  或警告     附带错误代码并被踢出
    │
    ▼
报告后续的资源包选择变更 + 运行时检查

必选列表(Mustlist)的检查优先于普通工作人员权限和权限绕过。当需要更改模组时,玩家需要关闭 Minecraft 以应用更改,然后通过启动器重新启动。

有关例外情况和客户端报告的限制,请参阅 验证指南。


? 资源包保护

保持社区内的资源包选择可预测。

功能 可用状态
资源包白名单、检查清单和黑名单 ✅
必需的、活跃的必选列表(Mustlist)资源包 ✅
文件和目录指纹校验 ✅
通过正常资源包界面进行的变更报告 ✅
阻止游戏内正常的资源包选择 ✅
未批准资源包导致踢出 可选;默认关闭

block-pack-change 默认为 true。拥有者(Owner)、管理员(Moderator)以及明确获得绕过资源包更改权限的用户不受此界面屏蔽限制。必需的必选列表(Mustlist)资源包仍然生效。

此屏蔽控制的是正常的客户端界面;它不会独立恢复在该界面之外所做的更改。请参阅 资源包更改行为。


?‍? Defixus 适用于哪些场景?

  • ? 生存服务器(SMPs)和小众社区,希望拥有易于理解的客户端规则。
  • ? 精选整合包,包含必需模组和可选的已批准附加内容。
  • ? RPG 和经济类服务器,拥有共享的视觉资源。
  • ? 私人活动,需要一致的玩家环境配置。
  • ? 管理团队,希望拥有检查工具、报告功能和可见的管理手段。

⚙️ 验证流程操作指南

以下所有验证路径均相对于 config/Defixus-anticheat/verification/ 目录。

? 白名单(Allowlist):按标识符允许

将模组 ID 添加到 mod_allowlist.json,将资源包名称添加到 pack_allowlist.json。这些文件包含 JSON 数组:

["sodium", "iris"]

白名单条目接受不带版本或文件哈希的标识符。内置条目始终包含在内,且默认情况下 library-bypass 允许已识别的库 ID。

? 检查清单(Checklist):批准特定的可选文件

将参考模组 JAR 放入 checklist/mods/,将资源包 ZIP 文件或目录放入 checklist/packs/。

如果玩家报告了该资源,并且其通过了检查清单校验,则其哈希值必须与参考值匹配。除非启用了 kick-unapproved-* 选项,否则缺失的可选资源是可以接受的。

⚠️ 为了进行精确的检查清单比对,请审查重叠的白名单条目和库绕过机制。白名单审批优先发生,因此切勿将相同的模组放入多个列表中!

? 黑名单(Denylist):禁止特定资源

将禁止的 ID 或资源包名称添加到 mod_denylist.json 或 pack_denylist.json。这两个文件初始为空。

在普通列表检查中,黑名单具有最高优先级。工作人员绕过以及早期系统/模组提供的资源包例外有其各自的行为;维基 描述了完整的优先级顺序。

? 必选列表(Mustlist):每个人都需要资源

希望玩家使用社区要求的模组或资源包吗?

  1. 将对应加载器的必需模组 JAR 放入 mustlist/mods/,或者针对不同客户端版本放入其子文件夹 1.21.11/、26.1.x/、26.2/ 和 26.3/。
  2. 将必需的资源包 ZIP 文件或目录放入 mustlist/packs/。
  3. 运行 /defixus reload。

? 玩家只需 加入 服务器即可准备这些必需资源,或者在多人游戏列表中点击服务器名称旁边的图标 ↓。服务器的多人游戏指示器会在进入服务器世界之前准备好客户端。

当需要更改模组时(无论是不同模组不存在还是完整性受损),玩家选择 下载,然后选择 关闭 Minecraft 并应用。最终替换的文件会被备份;由启动器管理或嵌套安装的模组可能需要手动更新。

必选列表(Mustlist)同样适用于 Java 版的工作人员。 它要求满足最低集合;额外资源遵循普通规则。更改后的必选列表会在重载后向在线 Java 玩家请求新的报告,并 断开那些不再满足条件的玩家的连接。

请参阅 玩家准备 和 服务器设置及限制。

⚠️ 清单(Checklist)与必选列表(Mustlist)支持常见的模组引用,以及客户端版本覆盖。例如,verification/mustlist/mods/26.1.x/ 会为所有 26.1 补丁版本选择所需的文件。整合包引用、允许列表(Allowlist)和禁止列表(Denylist)保持共享。详见 版本化引用。

? 工作人员权限

在匹配 Defixus 发布版本检查后,普通的加入验证会自动豁免 Owner(所有者)和 Moderator(版主)权限集。独立的权限节点可以跳过模组或整合包检查。

这些豁免并不免除任何人必须遵守 Mustlist 的要求。拥有 Owner 权限和显式整合包更改权限的用户也会跳过普通的整合包更改验证;仅拥有 Moderator 权限的用户只会获得屏幕拦截的豁免。

请参阅 权限指南 了解确切规则。

? 检查并下载客户端资源

授权的工作人员可以检查在线玩家的可下载模组库存和已安装的整合包:

/defixus scan <player> mods
/defixus scan <player> packs

报告包含悬停时的哈希详情,并在获许可时提供可点击的 Download(下载)操作。也可以直接请求下载:

/defixus download <player> mod <mod-id>
/defixus download <player> pack "Pack Name.zip"
/defixus download <player> mods
/defixus download <player> packs
/defixus download <player> unapprovedmods
/defixus download <player> unapprovedpacks

这些命令需要游戏内的工作人员玩家和兼容的在线目标。文件将保存在 config/Defixus-anticheat/downloads/<player-uuid>/ 下;它们不会自动安装。每个文件大小限制为 256 MiB,整合包文件夹以 ZIP 格式传输。

批量下载会显示进度和单个文件的失败情况。嵌套模组和 Java 运行时条目不包含在下载模组库存中。unapproved* 过滤器使用普通的 Allowlist/库和 Checklist 审批,Denylist 具有优先权;它们不咨询 Mustlist 审批。

? 读取有用报告

/defixus list mods
/defixus list packs
/defixus stats global
/defixus stats player <player>
/defixus panel

游戏内报告每页使用 八行,具有私有导航和五分钟过期时间。控制台接收适用于控制台源命令的完整纯文本输出。

扫描、统计、下载和面板命令有单独的访问规则。使用 /dp 作为快捷方式打开面板。详见 命令和统计。


? Discord 集成

控制台共享(Discord Bot 或 Webhooks)

你自己的机器人可以将一个 Discord 文本频道转变为共享 Minecraft 控制台。授权用户发送斜杠命令;能够阅读该频道的每个人都能看到作者、命令、响应和转发的运行时日志。

/defixus console command:list
/defixus console command:defixus list mods
/defixus status

机器人运行在 Minecraft 内部。创建你自己的 Discord 应用程序,将令牌本地保存在服务器上,配置允许的用户或角色,然后重启。不需要单独的机器人程序、Docker 或 VPS。

授权命令具有完整的控制台权限。需要玩家实体的命令仍需要在游戏中运行。

最终,你可以设置 单向 Minecraft 到 Discord 的控制台(通过 webhooks),仅在公共 Discord 频道中分发它(以追求反管理员滥用检查)。

? 遵循 Discord 集成指南 以获取 webhook 单向配置,或应用程序创建、令牌存储和双向 Discord Bot 的设置。

事件警报(Discord Webhooks)

独立的 webhooks 可以发送:

事件 通知
player_join 成功的普通验证
operator_join 自动 Owner/Moderator 加入豁免
operator_change 通过挂钩的命令授予/移除操作员权限
command_dispatch 配置的由玩家发出的命令
player_kick 普通验证踢出
mod_warnings, pack_warnings 未批准内容警告
pack_changes 在适用路径上报告的整合包更改
server_start, server_stop 服务器生命周期警报

在 discord/webhook.json 中配置目标和开关。fancy-webhooks 添加可用的统计信息和哈希详情。当个人机器人禁用时,单独的单向控制台 webhook 仍然可用。


? 统计数据

Defixus 保留持久的全局计数器和个别玩家记录。

服务器记录 玩家记录
检查的报告和成功的验证 名称、UUID、首次/最后出现时间
验证踢出和分类检测 连接、加入和踢出次数
断开连接和工作人员加入豁免 最近的违规行为和最后观察到的模组 ID
服务器启动和停止 存储的游戏时间、平均会话时间和豁免使用情况

报告显示支持的计数器和违规行为详情;额外的会话数据存储在玩家 JSON 文件中。存储的违规历史记录最多保留十条条目,玩家报告最多显示五条。

自最后出现以来超过 90 天 的玩家统计文件有资格进行启动清理和 /defixus cleanup。


⚙️ Defixus 配置逐步指南

主要服务器文件位于 config/Defixus-anticheat/ 下:

Defixus-anticheat/
├── verification/
│   ├── settings.json
│   ├── mod_allowlist.json
│   ├── mod_denylist.json
│   ├── pack_allowlist.json
│   ├── pack_denylist.json
│   ├── checklist/
│   │   ├── mods/
│   │   └── packs/
│   └── mustlist/
│       ├── mods/
│       └── packs/
├── discord/webhook.json
├── console/
│   ├── discord-bot.json
│   └── discord-webhook.json
└── statistics/
    ├── global.json
    └── players/<uuid>.json

默认的 verification/settings.json 是:

{
  "config-version": 1,
  "language": "zh_cn",
  "library-bypass": true,
  "block-pack-change": true,
  "kick-unapproved-mods": false,
  "kick-unapproved-packs": false,
  "unapproved-mod-warning": "",
  "unapproved-pack-warning": ""
}
设置项 预期效果
library-bypass 已识别的库模组无需单独列入白名单即可通过常规模组审核。
block-pack-change 阻止无豁免权的玩家访问常规资源包界面;被阻止期间的常规上报更改会被记录并忽略,但强制列表检查仍会生效。
kick-unapproved-mods 拒绝未知模组,而非仅发出警告。
kick-unapproved-packs 在加入服务器或激活时拒绝未知资源包,而非仅发出警告。
language 默认服务器消息和 Discord 事件的语言。
unapproved-*-warning 留空时使用翻译后的警告文本;非空文本将按原样显示。
config-version 内部配置架构。请勿修改此项。

黑名单决策及适用的清单不匹配项会直接拒绝资源,这与“踢出未知内容”开关的状态无关。

编辑验证规则或资源后,请运行 /defixus reload。无效的重置策略会使之前的有效规则保持启用状态。Discord 文件更改需要重启服务器;面板切换在保存成功时立即生效。

? 更新前请备份您的配置文件。旧版列表路径会随备份自动迁移。服务器配置指南 包含示例、迁移说明及所有数据位置信息。


? 安装指南

模组依赖

必需依赖

  • 对于 Fabric 和 Quilt,需要 Fabric API。任何版本均可,服务端和客户端均需安装。

  • 对于 NeoForge 无需任何额外依赖。服务端和客户端均直接使用。

可选客户端增强

  • 对于 Fabric:
    ↳

    • Mod Menu 允许从模组列表打开 Defixus 设置。
    • Cloth Config 通过 Mod Menu 提供增强的设置界面。


    这两者均为可选。若未安装,请使用 /defixusclient 打开原生语言界面(这是一个测试版设置界面,更完善的版本正在开发中)

  • 对于 NeoForge,出于相同原因建议仅安装 可选 Cloth Config。即使没有它,原生界面和 /defixusclient 也能正常工作。

服务端设置

  1. 安装你的加载器并接受 Minecraft EULA。
  2. 将 模组依赖 和 Defixus 放入服务器的 mods/ 文件夹。
  3. 启动服务器以生成配置文件。
  4. 选择你的列表和设置,并将文件加载到强制列表(mustlist)和检查清单(checklist)中,然后运行 /defixus reload。
  5. 向你的玩家分享对应的 Defixus 发布版本(Defixus 服务端版本)及所需的设置。

客户端设置

  1. 安装 模组依赖、Defixus,并考虑下载 可选客户端增强。
  2. 加入服务器,或使用 ↓ 准备其 Mustlist 资源。
  3. 审查请求的下载项。如果模组发生变更,关闭 Minecraft 以应用更改,然后重新启动相同的配置文件。

已识别的 Bedrock 玩家,通过 Geyser/Floodgate 协议认证的,可免除 Java 验证流程。


⚠️ 安全须知与模组目标

Defixus 帮助你的社区实施客户端资源规则。精确的文件检查可以识别客户端报告库存中的不匹配项。

经过修改的客户端始终可以伪造该报告。白名单审批有意接受未经字节检查的标识符,你仍然可以从客户端下载它们以进行手动检查。Defixus 目前未实现移动或战斗分析,且资源包界面拦截无法防止所有的本地修改。

Defixus 正在开发运行时行为反作弊功能,欢迎在 Ko-fi 上支持该项目


?️ 技术细节与支持版本

详情 最新版本信息
Defixus 版本 1.1.0-beta.1
Minecraft 目标版本 1.21.11, 26.1.x, 26.2, 26.3
平台 共享 Fabric/Quilt JAR,独立 NeoForge JAR
Java 1.21.11 使用 Java 21;26.x 使用 Java 25
哈希算法 SHA-256
网络通信 Minecraft 配置阶段和游玩阶段的载荷
Discord 事件 Webhook、个人双向控制台、可选转发
UI 添加项 Mod Menu 和 Cloth Config 为可选

跨版本 Defixus 连接使用协议 2,即加载器家族握手和八个协调一致的工件指纹。Minecraft 协议转换需另行提供(例如,合适的 ViaVersion/ViaBackwards/ViaFabric 设置)。Fabric/Quilt 和 NeoForge 家族之间的连接将被拒绝。具有相同发布字符串但使用上一代协议的旧构建必须替换。


❤️ 支持

如果你喜欢 Defixus:

⭐ 在 GitHub 上给项目加星

? 在 Modrinth 上下载

? 在 GitHub 上报告可复现的 Bug

? 在 GitHub 或我的 Discord 服务器中分享想法

? 帮助塑造更好的社区体验


我的其他项目!

如果你喜欢 Defixus Anti-Cheat,你可能也会喜欢我的其他项目:

Builders Freecam - (1.17 - 26.4)

Freecam 的一个完整且结构良好的分支,防止诸如在“固体”方块和岩浆上行走以及窥视洞穴等类似作弊的功能。

Just Redstone Waterlog - (1.14 - 26.4)

此 Mod/插件将所有基岩版(Bedrock Edition)红石组件的可水淹方块扩展至 Java 版。

Just Bedrock Waterlog WIP - (1.14 - 26.4)

此项目将所有基岩版(Bedrock Edition)的可水淹方块扩展至 Java 版。同时也附带配置文件!

ViaAlert (ViaVersion Addon) - (1.21.11 - 26.4)

让你能够看到加入你的 Fabric 服务器的玩家使用的版本以及他们的客户端来源。

Expanded Redstone - (1.21.11 - 26.4)

该模组允许红石信号通过非导体中继器向下传播。中继器是一种新方块,由 4 个原版方块和紫水晶碎片合成。

Cobalt Age - (1.21.11 - 26.4)

这是一个更具结构化的技术类模组,添加了一个全新的能源系统——Cobalt Energy System(钴能系统)。该系统与红石并行运作,其特点是不兼容红石信号且可被水填充,并具备更多特性,例如最高可达 60 的功率强度。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源