Sentinel&ModGuard

一个结合Mod+Plugin来检测和封禁非法模组的项目,这也通过使用ModiD添加来控制你想从列表中添加/移除哪些模组

管理

🛡️ ModGuard + Sentinel — 客户端验证系统

一个 服务端插件 + 客户端模组的安全系统,通过安全加密握手验证合法客户端并检测恶意修改——比客户端品牌检查或简单的模组名称检测可靠得多。

Discord Modrinth GitHub


📦 组件

🔌 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 版本
  → 模组列表对照黑名单和可选的数量限制进行检查
  → 玩家被批准或以可配置消息被踢出

🚀 安装

服务端:

  1. 将 ModGuard.jar 放入 plugins/ 目录
  2. 重启——plugins/ModGuard/config.yml 和 modblacklist.json 会自动生成

客户端:

  1. 将正确的 Sentinel-<version>.jar 放入 .minecraft/mods/ 目录
  2. 启动——无需配置

🔒 安全性

  • 每个服务器会话生成全新的 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