?️ 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 连接的 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
?️ ModGuard + Sentinel — Client Verification System
A server plugin + client mod security system that verifies legitimate clients and detects malicious modifications using a secure encrypted handshake — far more reliable than client-brand checks or simple mod name detection.
? Components
? ModGuard — Server Plugin Sends encrypted challenges to connecting players, verifies responses, checks mod IDs against a blacklist, enforces a minimum Sentinel version, and optionally limits total installed mods. Supports cracked servers, Geyser/Floodgate auto-bypass, configurable kick messages, player whitelist, and persistent mod history.
? Sentinel — Client Mod Installed by the player on their Fabric client. Receives the server challenge, collects the full mod list via FabricLoader, encrypts and returns it. Zero configuration. Zero performance impact.
⚙️ How It Works
Player joins
→ Server sends encrypted challenge (RSA-2048 + nonce + HMAC-SHA256 secret)
→ Sentinel collects mod list via FabricLoader
→ Sentinel encrypts response (AES-256-GCM, key wrapped with RSA/OAEP/SHA-256)
→ Server decrypts, verifies HMAC, checks protocol version + Sentinel version
→ Mod list checked against blacklist and optional count limit
→ Player approved or kicked with a configurable message
? Installation
Server:
- Drop
ModGuard.jarintoplugins/ - Restart —
plugins/ModGuard/config.ymlandmodblacklist.jsonare generated automatically
Client:
- Drop the correct
Sentinel-<version>.jarinto.minecraft/mods/ - Launch — no configuration needed
? Security
- RSA-2048 keypair generated fresh per server session — never written to disk
- AES-256-GCM authenticated encryption — ciphertext is tamper-proof
- HMAC-SHA256 payload signing — server secret is never sent to the client
- Nonce included in every challenge — replay attacks are not possible
- Protocol version verified inside the encrypted payload — cannot be spoofed by a fake Sentinel
- Minimum Sentinel version enforcement — kick players running outdated client mods
? Default Blacklisted Mods
Pre-seeded in modblacklist.json on first run:
meteor-client · impact · wurst · liquidbounce · aristois · sigma · thunderhack · wolfram · baritone · freecam · marlows-crystal-optimizer
Add or remove any mod ID via
/modguard blacklist add <modid>or by editingmodblacklist.jsondirectly.
? Commands
Permission: modguard.admin (OP by default)
| Command | Description |
|---|---|
/modguard blacklist <add|remove|list> |
Manage mod blacklist |
/modguard whitelist <add|remove|list> |
Manage player whitelist (bypasses verification) |
/modguard mods <player> |
View a player's verified mod list and last seen time |
/modguard check <player> |
Re-send a verification challenge to an online player |
/modguard status |
Show online players, pending verifications, and plugin info |
/modguard reload |
Reload configuration |
⚙️ Configuration
File: plugins/ModGuard/config.yml
offline-mode: false # set true for cracked servers
allow-floodgate: true # Bedrock players via Geyser bypass verification
challenge-timeout-seconds: 15 # seconds client has to respond
challenge-delay-ticks: 40 # delay before sending challenge after join
min-sentinel-version: "1.0.0" # kick players below this Sentinel version
protocol-version: 1 # must match Sentinel — only change if you update both
enable-mod-count-limit: false
max-mod-count: 50
show-mod-list-in-console: true
highlight-banned-mods: true
kick-messages:
missing-sentinel: "&cSentinel mod is required to join this server."
banned-mod: "&cAccess denied."
outdated-sentinel: "&cYour Sentinel mod is outdated. Please update to &ev{version}&c."
protocol-mismatch: "&cSentinel version mismatch. Please update your Sentinel mod."
timeout: "&cVerification timed out."
mod-count-exceeded: "&cToo many mods installed. Maximum allowed: &e{max}"
? Compatibility
| Scenario | Behavior |
|---|---|
| Fabric client with Sentinel | Full verification |
| Vanilla client (no mods) | Handled automatically — no Sentinel required |
| Bedrock / Geyser | Bypassed automatically |
| Cracked / offline server | Supported via offline-mode: true |
| Forge / NeoForge | Not supported |
| Whitelisted player | Skips verification |
? Requirements
- Paper / Spigot 1.21.x · Java 21+
- Geyser + Floodgate (optional, for Bedrock auto-bypass)
? Join our Discord for support, downloads, and updates ? More plugins by Treamhiler ? GitHub
下载 Sentinel&ModGuard
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Sentinel&ModGuard
下载 Sentinel&ModGuard
下载 Sentinel&ModGuard
下载 Sentinel&ModGuard
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Sentinel&ModGuard
下载 Sentinel&ModGuard
下载 Sentinel&ModGuard
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Sentinel&ModGuard
下载 Sentinel&ModGuard
ModGuard — 更新日志
v1.0.0 — 初始版本
功能
- 加密握手验证 — 每次会话都会生成新的 RSA-2048 密钥对(永不写入磁盘)。挑战包含随机数 (nonce)、HMAC 密钥和公钥。客户端响应使用 AES-256-GCM 进行加密,AES 密钥使用 RSA (OAEP/SHA-256) 进行封装。服务器解密后验证 HMAC-SHA256,并检查模组列表
- Sentinel 客户端模组 — 接收挑战,通过 FabricLoader 收集模组列表并进行加密返回。零配置,零性能影响
- 模组黑名单 —
modblacklist.json包含预置条目:meteor-client、impact、wurst、liquidbounce、aristois、sigma、thunderhack、wolfram、baritone、freecam、marlows-crystal-optimizer - 玩家白名单 — 允许特定名称或 UUID 的玩家跳过验证 (
whitelist.json) - 模组历史记录 — 已验证的模组列表按玩家保存至
mod-history.json,可通过/modguard mods <player>查看 - 协议版本控制 — 客户端和服务器必须就协议版本达成一致。Sentinel 版本不匹配时,玩家将被踢出,并显示可配置的消息
- 最低 Sentinel 版本强制要求 — 可配置的
min-sentinel-version会踢出运行过时客户端模组的玩家 - 最大模组数量限制 — 可选的已安装模组总数上限 (
enable-mod-count-limit,max-mod-count) - Geyser / Floodgate 自动绕过 — Bedrock 玩家自动跳过验证 (
allow-floodgate: true) - 离线/破解服务器支持 —
offline-mode: true跳过依赖 UUID 的检查 - 可配置踢出消息 — 分别为
missing-sentinel(缺少 Sentinel)、banned-mod(被禁模组)、outdated-sentinel(过期的 Sentinel)、protocol-mismatch(协议不匹配)、timeout(超时)、mod-count-exceeded(超出模组数量限制)设置独立消息 - 挑战超时 — 可配置的秒数,客户端在此时间内未响应则被踢出 (
challenge-timeout-seconds) - 命令:
/modguard blacklist <add|remove|list>、/modguard whitelist <add|remove|list>、/modguard mods <player>、/modguard check <player>、/modguard reload、/modguard status
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧