Sentinel&ModGuard

插件

· 作者 Treamhiler

一个结合 Mod 与插件的项目,用于检测并封禁非法模组。此外,它还允许你通过 ModiD 添加或移除列表中的模组,从而控制哪些模组可以被加入或排除。

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

需要前置:Floodgate

最新 ModGuard-1.21.x · 1.21.11 · Paper / Spigot

一键开服(送7天)

?️ 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 版本
  → 将模组列表与黑名单及可选的数量限制进行比对
  → 批准玩家或将其踢出并显示可配置的消息

? 安装

服务器端:

  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 连接的 Bedrock 玩家跳过验证

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 客户端 完整验证
Vanilla 客户端(无模组) 自动处理 —— 无需 Sentinel
Bedrock / Geyser 自动绕过
破解 / 离线服务器 通过 offline-mode: true 支持
Forge / NeoForge 不支持
白名单玩家 跳过验证

? 要求

  • Paper / Spigot 1.21.x · Java 21+
  • Geyser + Floodgate (可选,用于 Bedrock 自动绕过)

? 加入我们的 Discord 获取支持、下载和更新 ? Treamhiler 的其他插件 ? GitHub

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源