Sentinel&ModGuard
一个结合Mod+Plugin来检测和封禁非法模组的项目,这也通过使用ModiD添加来控制你想从列表中添加/移除哪些模组
查看大图🛡️ ModGuard + Sentinel — 客户端验证系统
一个 服务端插件 + 客户端模组的安全系统,通过安全加密握手验证合法客户端并检测恶意修改——比客户端品牌检查或简单的模组名称检测可靠得多。
📦 组件
🔌 ModGuard — 服务端插件 向连接的玩家发送加密挑战,验证响应,对照黑名单检查模组 ID,强制最低 Sentinel 版本,并可选择限制已安装模组总数。支持破解服务器、Geyser/Floodgate 自动绕过、可配置的踢出消息、玩家白名单以及持久化模组历史记录。
🧩 Sentinel — 客户端模组 由玩家安装在他们的 Fabric 客户端上。接收服务器挑战,通过 FabricLoader 收集完整模组列表,加密并返回。零配置。零性能影响。
⚙️ 工作原理
玩家加入
→ 服务器发送加密挑战(RSA-2048 + nonce + HMAC-SHA256 密钥)
→ Sentinel 通过 FabricLoader 收集模组列表
→ Sentinel 加密响应(AES-256-GCM,密钥使用 RSA/OAEP/SHA-256 封装)
→ 服务器解密,验证 HMAC,检查协议版本 + Sentinel 版本
→ 模组列表对照黑名单和可选的数量限制进行检查
→ 玩家被批准或以可配置消息被踢出
🚀 安装
服务端:
- 将
ModGuard.jar放入plugins/目录 - 重启——
plugins/ModGuard/config.yml和modblacklist.json会自动生成
客户端:
- 将正确的
Sentinel-<version>.jar放入.minecraft/mods/目录 - 启动——无需配置
🔒 安全性
- 每个服务器会话生成全新的 RSA-2048 密钥对——从不写入磁盘
- AES-256-GCM 认证加密——密文防篡改
- HMAC-SHA256 载荷签名——服务器密钥从不发送给客户端
- 每个挑战都包含 nonce——重放攻击不可能发生
- 协议版本在加密载荷内部验证——无法被伪造的 Sentinel 欺骗
- 强制最低 Sentinel 版本——踢出运行过时客户端模组的玩家
🚫 默认黑名单模组
首次运行时预置于 modblacklist.json 中:
meteor-client · impact · wurst · liquidbounce · aristois · sigma · thunderhack · wolfram · baritone · freecam · marlows-crystal-optimizer
通过
/modguard blacklist add <modid>或直接编辑modblacklist.json来添加或移除任何模组 ID。
💻 命令
权限:modguard.admin(默认 OP)
| 命令 | 描述 |
|---|---|
/modguard blacklist <add|remove|list> |
管理模组黑名单 |
/modguard whitelist <add|remove|list> |
管理玩家白名单(绕过验证) |
/modguard mods <player> |
查看玩家已验证的模组列表和最后在线时间 |
/modguard check <player> |
向在线玩家重新发送验证挑战 |
/modguard status |
显示在线玩家、待验证玩家和插件信息 |
/modguard reload |
重新加载配置 |
⚙️ 配置
文件:plugins/ModGuard/config.yml
offline-mode: false # 破解服务器设为 true
allow-floodgate: true # 通过 Geyser 连接的基岩版玩家绕过验证
challenge-timeout-seconds: 15 # 客户端响应挑战的秒数
challenge-delay-ticks: 40 # 加入后发送挑战前的延迟
min-sentinel-version: "1.0.0" # 踢出低于此 Sentinel 版本的玩家
protocol-version: 1 # 必须与 Sentinel 匹配——仅在你同时更新两者时更改
enable-mod-count-limit: false
max-mod-count: 50
show-mod-list-in-console: true
highlight-banned-mods: true
kick-messages:
missing-sentinel: "&c需要 Sentinel 模组才能加入此服务器。"
banned-mod: "&c访问被拒绝。"
outdated-sentinel: "&c你的 Sentinel 模组已过时。请更新到 &ev{version}&c。"
protocol-mismatch: "&cSentinel 版本不匹配。请更新你的 Sentinel 模组。"
timeout: "&c验证超时。"
mod-count-exceeded: "&c已安装的模组过多。最大允许数量:&e{max}"
📋 兼容性
| 场景 | 行为 |
|---|---|
| 带 Sentinel 的 Fabric 客户端 | 完整验证 |
| 原版客户端(无模组) | 自动处理——不需要 Sentinel |
| 基岩版 / Geyser | 自动绕过 |
| 破解 / 离线服务器 | 通过 offline-mode: true 支持 |
| Forge / NeoForge | 不支持 |
| 白名单玩家 | 跳过验证 |
🔧 要求
- Paper / Spigot 1.21.x · Java 21+
- Geyser + Floodgate (可选,用于基岩版自动绕过)
💬 加入我们的 Discord 获取支持、下载和更新 🔗 Treamhiler 的更多插件 🐙 GitHub
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。