?️ 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):每个人都需要资源
希望玩家使用社区要求的模组或资源包吗?
- 将对应加载器的必需模组 JAR 放入
mustlist/mods/,或者针对不同客户端版本放入其子文件夹 1.21.11/、26.1.x/、26.2/ 和 26.3/。
- 将必需的资源包 ZIP 文件或目录放入
mustlist/packs/。
- 运行
/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 文件更改需要重启服务器;面板切换在保存成功时立即生效。
? 更新前请备份您的配置文件。旧版列表路径会随备份自动迁移。服务器配置指南 包含示例、迁移说明及所有数据位置信息。
? 安装指南
模组依赖
必需依赖
可选客户端增强
服务端设置
- 安装你的加载器并接受 Minecraft EULA。
- 将 模组依赖 和 Defixus 放入服务器的
mods/ 文件夹。
- 启动服务器以生成配置文件。
- 选择你的列表和设置,并将文件加载到强制列表(mustlist)和检查清单(checklist)中,然后运行
/defixus reload。
- 向你的玩家分享对应的 Defixus 发布版本(Defixus 服务端版本)及所需的设置。
客户端设置
- 安装 模组依赖、Defixus,并考虑下载 可选客户端增强。
- 加入服务器,或使用 ↓ 准备其 Mustlist 资源。
- 审查请求的下载项。如果模组发生变更,关闭 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 服务器中分享想法
? 帮助塑造更好的社区体验
Freecam 的一个完整且结构良好的分支,防止诸如在“固体”方块和岩浆上行走以及窥视洞穴等类似作弊的功能。
此 Mod/插件将所有基岩版(Bedrock Edition)红石组件的可水淹方块扩展至 Java 版。
此项目将所有基岩版(Bedrock Edition)的可水淹方块扩展至 Java 版。同时也附带配置文件!
ViaAlert (ViaVersion Addon) - (1.21.11 - 26.4)
让你能够看到加入你的 Fabric 服务器的玩家使用的版本以及他们的客户端来源。
该模组允许红石信号通过非导体中继器向下传播。中继器是一种新方块,由 4 个原版方块和紫水晶碎片合成。
这是一个更具结构化的技术类模组,添加了一个全新的能源系统——Cobalt Energy System(钴能系统)。该系统与红石并行运作,其特点是不兼容红石信号且可被水填充,并具备更多特性,例如最高可达 60 的功率强度。
?️ Defixus: Anti-Cheat and QoL Admin Tool
? The Ultimate Anti-Cheat Mod with Integrity Protection ?
Detect unauthorized resources • Verify file integrity • Monitor live changes • Resource hash analysis • Protect your community
Active Support: Minecraft 26.x and 1.21.11
⚡ ? SHA-256 Verification & Client Inspector ? ⚡
Defixus is a powerful anti-tampering and verification system for Fabric/Quilt and NeoForge servers, with lots of QoL features.
A runtime-behavior anticheat is in development inside Defixus, consider help the project on Ko-fi
Geyser/Floodgate & ViaVersion/ViaBackwards authentication are supported
Unlike traditional "whitelist/blacklist" solutions with mod-id's, Defixus validates not only which mods are loaded, but also checks their integrity through SHA-256 checksum hashing and their behavior inspecting the binary files, ensuring that cheated, disguised or tampered clients cannot bypass server security policies defined by Defixus.
Built for whether large or small communities that require a control over the client environment.
✨ Features
Give whether your SMP or Community clear client rules, share the resources your community needs, and keep useful administration tools close at hand.
- ? Mod and resource-pack rules with Allowlist, Checklist, Denylist and Mustlist.
- ? SHA-256 integrity checks for reference files and the Defixus client.
- ⬇️ Required server resources, prepared with the player's approval before entering the world.
- ? In-game client scans and individual or bulk client → server downloads.
- ? Active resource-pack change reports and an option to block normal pack selection.
- ?️ An in-game settings panel, paginated chat reports and multiplayer server-list indicators.
- ? A two-way Discord console, using your own bot running inside Minecraft (optional one-way Webhook console too).
- ? Discord event alerts, including configured player-issued commands, using Webhooks.
- ? Persistent server and player statistics.
- ? Lot of client message languages, used for alerts, kicks and more.
? Start with installation, or visit the Defixus Wiki for the complete guides.
?️ Why Defixus?
Running a community server often means answering a simple question: which client resources belong here?
Here's a table which answers this question. Its important to understand what here is called ? resource and what are the ? Lists.
- A ? resource is either a ? mod or a ? resource pack.
| ? List |
A ? resource in this list means that |
? Allowlist |
“This resource is welcome to join the server.” No particular file build is required. Uses mod-id for mods and a normalized name for resource packs. |
? Checklist |
“If you use this resource, it must match the relative file bit-by-bit (SHA-256 Checksum), and if it doesn't match, then an automatic kick from the server.” |
? Denylist |
“This resource is prohibited.” Uses mod-id for mods and a normalized name for resource packs. |
? Mustlist |
“Everyone needs this exact mod or resource pack to be active.” It must match the same file, bit-by-bit (SHA-256 Checksum), and if it doesn't, the player can't join the server. Comes with a simple "Sync Mustilist with Server" button, so the clients do not need to install the Must-have resources manually. Perfect choice for ?️ Modpacks. |
-
⚪ Allowed resources: a resource which is present in ? Allowlist and ? Mustlist, or that is present in ? Checklist and matches the file integrity with the server's correspondent resource, is marked as
⚪ Allowed.
-
? Unapproved resources: a resource which is not present in ? Allowlist and ? Checklist, is marked as
? Unapproved. An unapproved resource can be a ⚫ Prohibited one when the settings kick-unapproved-* are enabled.
-
⚫ Prohibited resources: a resource that is present in the ? Checklist and does not match the file integrity, or that is present in ? Denylist, is marked as ⚫ Prohibited, and comes with a kick.
A Checklist reference alone does not require players to install that resource. Use Mustlist when it must be present (Modpack oriented servers).
For ordinary mod rules, Denylist takes priority, followed by Allowlist or recognized libraries, then Checklist. Built-in Allowlist entries and pack exceptions also apply, so review the verification rules when setting up a strict modpack.
In development also a runtime anti-cheat with high success rate, that is not based on ? resources but on behavior runtime checks (like Vulkan and so on). This is a work in progress, and it will be released in the next months. Consider leave a tip on Ko-Fi to help this project.
⚡ Verification Flow
Defixus uses the client's reported loader mod inventory and selected resource packs.
Connect to the server
│
▼
Prepare Mustlist resources, if needed
Review → Approve → Download and check
│
▼
Required mods loaded and packs active?
│
▼
Enter the world and send the verification report
│
▼
Defixus release → Integrity → Ordinary server rules
│
┌────┴─────┐
▼ ▼
Accepted Rejected
or warned with an error code and kicked out
│
▼
Report subsequent pack-selection changes + Runtime checks
Mustlist is checked before ordinary staff and permission bypasses. When mods need changing, the player closes Minecraft to apply them, then restarts through the launcher.
See the verification guide for exceptions and the limits of client reports.
? Resource Pack Protection
Keep your community's resource-pack choices predictable.
| Feature |
Available |
| Pack Allowlist, Checklist and Denylist |
✅ |
| Required, active Mustlist packs |
✅ |
| File and directory fingerprints |
✅ |
| Reports of changes through the normal pack screen |
✅ |
| Block normal in-game pack selection |
✅ |
| Kick for unapproved packs |
Optional; off by default |
block-pack-change defaults to true. Owner, Moderator and explicit pack-change bypass users receive an exemption from the screen block. Required Mustlist packs still apply.
The block controls the normal client interface; it does not independently restore changes made outside that interface. See pack-change behavior.
?? What is Defixus ideal for?
- ? SMPs and small communities that want understandable client rules.
- ? Curated modpacks with required mods and optional approved additions.
- ? RPG and economy servers with shared visual resources.
- ? Private events that need consistent player setups.
- ? Staff teams that want inspection tools, reports and visible administration.
⚙️ A walkthrough in verification process
All verification paths below are relative to config/Defixus-anticheat/verification/.
? Allowlist: allow by identifier
Add mod IDs to mod_allowlist.json and pack names to pack_allowlist.json. These files contain JSON arrays:
["sodium", "iris"]
Allowlist entries accept an identifier without enforcing a version or file hash. Built-in entries are always included, and library-bypass allows recognized library IDs by default.
? Checklist: approve an exact optional file
Put reference mod JARs in checklist/mods/ and resource-pack ZIPs or directories in checklist/packs/.
If a player reports that resource, and it reaches the Checklist check, its hash must match the reference. Missing optional resources are fine unless the option kick-unapproved-* is enabled.
⚠️ For an exact Checklist comparison, review overlapping Allowlist entries and the library bypass. Allowlist approval happens first, so do not put the same mods in more than one list!
? Denylist: prohibit a resource
Add prohibited IDs or pack names to mod_denylist.json or pack_denylist.json. Both start empty.
Denylist takes priority within ordinary list checks. Staff bypasses and the earlier system/mod-provided pack exceptions have their own behavior; the wiki describes the full order.
? Mustlist: resources everyone needs
Want players to use your community's required mod or pack?
- Put required mod JARs for your loader in
mustlist/mods/, or its 1.21.11/, 26.1.x/, 26.2/ and 26.3/ subfolders for different client versions.
- Put required pack ZIPs or directories in
mustlist/packs/.
- Run
/defixus reload.
? Players can prepare the must-have resources just by Joining the server, or click on the icon ↓ next to the server's name in the multiplayer list. The server's multiplayer indicators prepare the client before entering the server world.
When mods need changing, whether different not present or the integrity is corrupted, players choose Download and then Close Minecraft and apply. Eventual replaced files are backed up; launcher-managed or nested installed mods may need a manual update.
Mustlist applies to Java staff too. It requires a minimum set; additional resources follow ordinary rules. A changed Mustlist requests fresh reports from online Java players after reload and disconnects those who no longer meet it.
See player preparation and server setup and limits.
⚠️ Checklist and Mustlist support common mod references plus client-version overrides. For example, verification/mustlist/mods/26.1.x/ selects required files for all three 26.1 patches. Pack references and Allowlist/Denylist stay shared. See versioned references.
? Staff permissions
Ordinary join verification has automatic bypasses for the exact Owner and Moderator permission sets, after the matching Defixus release check. Separate permission nodes can skip mod or pack checks.
These bypasses do not exempt anyone from Mustlist. Owner and explicit pack-change permission users also skip ordinary pack-change verification; Moderator alone only receives the screen-block exemption.
See the permission guide for the precise rules.
? Inspect and download client resources
Authorized staff can inspect an online player's downloadable mod inventory and installed packs:
/defixus scan <player> mods
/defixus scan <player> packs
Reports include hash details on hover and a clickable Download action when permitted. Downloads can also be requested directly:
/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
These commands require an in-game staff player and a compatible online target. Files are saved under config/Defixus-anticheat/downloads/<player-uuid>/; they are not installed automatically. Each file is limited to 256 MiB, and pack folders are transferred as ZIPs.
Bulk downloads show progress and per-file failures. Nested mods and the Java runtime entry are excluded from the downloadable mod inventory. The unapproved* filters use ordinary Allowlist/library and Checklist approval, with Denylist taking priority; they do not consult Mustlist approval.
? Read useful reports
/defixus list mods
/defixus list packs
/defixus stats global
/defixus stats player <player>
/defixus panel
In-game reports use eight rows per page, private navigation and five-minute expiry. The console receives full plain-text output for commands available to console sources.
Scan, statistics, download and panel commands have separate access rules. Open the panel with /dp as a shortcut. See commands and statistics.
? Discord Integration
Console sharing (Discord Bot or Webhooks)
Your own bot turns one Discord text channel into a shared Minecraft console. Authorized users send slash commands; everyone who can read the channel sees the author, command, response and forwarded runtime logs.
/defixus console command:list
/defixus console command:defixus list mods
/defixus status
The bot runs inside Minecraft. Create your own Discord application, keep its token locally on the server, configure allowed users or roles, and restart. No separate bot program, Docker or VPS is needed.
Authorized commands have full console permissions. Commands that require a player entity still need to be run in game.
Eventually, you can setup a one-way Minecraft to Discord console with webhooks, just to dispatch it in a public discord channel (to pursue the anti admin abuse checks).
? Follow the Discord Integration guide for the webhook one-way configuration or for the application creation, token storage and setup of the two-way Discord Bot.
Event alerts (Discord Webhooks)
Independent webhooks can send:
| Event |
Notification |
player_join |
Successful ordinary verification |
operator_join |
Automatic Owner/Moderator join bypass |
operator_change |
Operator grants/removals through the hooked commands |
command_dispatch |
Configured player-issued commands |
player_kick |
Ordinary verification kicks |
mod_warnings, pack_warnings |
Unapproved-content warnings |
pack_changes |
Reported pack changes on applicable paths |
server_start, server_stop |
Server lifecycle alerts |
Configure destinations and switches in discord/webhook.json. fancy-webhooks adds available statistics and hash details. A separate one-way console webhook remains available when the personal bot is disabled.
? Statistics
Defixus keeps persistent global counters and individual player records.
| Server records |
Player records |
| Checked reports and successful verifications |
Name, UUID, first/last seen |
| Verification kicks and categorized detections |
Connection, join and kick counts |
| Disconnects and staff join bypasses |
Recent violations and last observed mod IDs |
| Server starts and stops |
Stored play time, average session time and bypass use |
Reports show the supported counters and violation details; additional session data is stored in the player JSON files. Stored violation history keeps up to ten entries, and the player report displays up to five.
Player-statistics files older than 90 days since last seen are eligible for startup cleanup and /defixus cleanup.
⚙️ A walkthrough on Defixus configurations
The main server files live under 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
The default verification/settings.json is:
{
"config-version": 1,
"language": "en_us",
"library-bypass": true,
"block-pack-change": true,
"kick-unapproved-mods": false,
"kick-unapproved-packs": false,
"unapproved-mod-warning": "",
"unapproved-pack-warning": ""
}
| Setting |
What to expect |
library-bypass |
Recognized libraries can pass ordinary mod approval without individual entries. |
block-pack-change |
Blocks the normal pack screen for players without an exemption; ordinary reported changes are logged and ignored while blocked. Mustlist checks still apply. |
kick-unapproved-mods |
Reject unknown mods instead of warning. |
kick-unapproved-packs |
Reject unknown packs at join and on activation instead of warning. |
language |
Default server-message and Discord event language. |
unapproved-*-warning |
Blank uses translated warning text; nonblank text is displayed verbatim. |
config-version |
Internal configuration schema. Leave it unchanged. |
Denylist decisions and applicable Checklist mismatches already reject resources, independently of the unknown-content kick switches.
Run /defixus reload after editing verification rules or resources. Invalid replacement policies leave the previous active rules in place. Discord file changes require a server restart; panel switches are applied immediately when saving succeeds.
? Back up your configuration before updating. Legacy list paths migrate automatically with backups. The server configuration guide contains examples, migrations and all data locations.
? Installation
Mod requirements
Mandatory requirements
-
For Fabric and Quilt, Fabric API is required. Any version should be fine. Both server and client.
-
For NeoForge nothing is required. Both server and client.
Optional client enhancements
-
For Fabric:
↳
- Mod Menu opens Defixus settings from the mod list.
- Cloth Config provides the enhanced settings screen through Mod Menu.
Both are optional. Without them, use /defixusclient to open the native language screen (it's a beta test setting screen, a better one in development)
-
For NeoForge, just the optional Cloth Config is suggested for the same reason. The native screen and /defixusclient also work without it.
Server setup
- Install your loader and accept Minecraft's EULA.
- Put mod requirements and Defixus in the server's
mods/ folder.
- Start the server to generate configuration files.
- Choose your lists and settings and load your files in mustlist and checklist, then run
/defixus reload.
- Share the matching Defixus release (the Defixus server version) and required setup with your players.
Client setup
- Install the mod requirements, Defixus and consider download also optional client enhancements.
- Join the server, or use ↓ to prepare its Mustlist resources.
- Review requested downloads. If mods change, close Minecraft to apply them, then restart the same profile.
Recognized Bedrock players, authenticated with Geyser/Floodgate protocols are exempt from the Java verification flow.
⚠️ Security Notice and Goals of this Mod
Defixus helps your community apply client-resource rules. Exact file checks can identify mismatches in the inventory the client reports.
A modified client can always falsify that report. Allowlist approval intentionally accepts identifiers without checking their bytes, you can still download them from the client to do a manual check. Defixus does not implement movement or combat analysis (at moment), and pack-screen blocking cannot prevent every local modification.
A runtime-behavior anticheat is in development inside Defixus, consider help the project on Ko-fi
?️ Technical Details & Supported Versions
| Detail |
Last version details |
| Defixus version |
1.1.0-beta.1 |
| Minecraft targets |
1.21.11, 26.1.x, 26.2, 26.3 |
| Platforms |
Shared Fabric/Quilt JAR, separate NeoForge JAR |
| Java |
21 for 1.21.11; 25 for 26.x |
| Hash algorithm |
SHA-256 |
| Networking |
Minecraft configuration and play payloads |
| Discord |
Event webhooks, personal two-way console, optional forwarding |
| UI additions |
Mod Menu and Cloth Config are optional |
Cross-version Defixus connections use protocol 2, a loader-family handshake and eight coordinated artifact fingerprints. Minecraft protocol translation must be provided separately (for example, a suitable ViaVersion/ViaBackwards/ViaFabric setup). Connections across Fabric/Quilt and NeoForge families are rejected. Old builds with the same release string but the previous protocol must be replaced.
❤️ Support
If you enjoy Defixus:
⭐ Star the project on GitHub
? Download on Modrinth
? Report reproducible bugs on GitHub
? Share ideas on GitHub or in my Discord server
? Help shape a better experience for your community
A complete well shaped fork of Freecam, which prevents Hack-like features such as traveling on "solid" blocks and lava, and cave-peeking.
This Mod/Plugin extends all Bedrock Edition Redstone components waterloggable blocks into Java Edition.
This projects extends all Bedrock Edition waterloggable blocks into Java Edition. Comes with a config too!
ViaAlert (ViaVersion Addon) - (1.21.11 - 26.4)
It lets you see when people join into your Fabric server which version are they using, and which client they are from.
This mod allows redstone signals to propagate downwards over a non-conductor relay. A relay is a new block crafted with 4 vanilla block plus an amethyst shard.
This is a more shaped technical mods, which adds a complete new energy system called Cobalt Energy System, which works parallelly to Redstone, being different in the fact that it is not compatible with redstone signals and that it is waterloggable, and even more features, such as an up to 60 power strength.
评论 0
登录后参与评分
还没有评论,来抢沙发吧