CheckMOD

# ChecksMOD A server-side anti-cheat plugin that detects client-side mods and kicks players using blacklisted cheats. Supports Paper 1.20 - 1.21.11 | Requires PacketEvents 2.7.0+ 检测玩家客户端 Mod，踢出黑名单违规 Mod。支持 Paper 1.20 ~ 1.21.11。 需要PacketEvents 2.7.0+以上版本 反馈BUG等问题联系作者QQ:1464670605 (记得备注来意) --- # CheckMOD ### English **A server-side anti-cheat plugin that detects client-side mods and kicks players using blacklisted cheats.** **Compatibility:** Paper 1.20 – 1.21.11 **Requirement:** PacketEvents 2.7.0+ **Language:** Currently Simplified Chinese only (Multi-language support coming soon). #### Features * **Brand Detection:** Intercepts the `minecraft:brand` channel to identify client brands. * **Forge Mod Detection:** Parses the FML classic handshake mod list (1.20–1.20.1). * **FML3 Detection:** Scans `fml:loginwrapper` for blacklisted mods (1.20.2+). * **Fabric Detection:** Identifies the Fabric loader. * **Channel Blacklist:** Supports wildcard (`*`) matching for network channels. * **Brand Whitelist/Blacklist:** Fine-grained control over client brands. * **Vanilla-Only Mode:** Restricts access to pure vanilla clients only. * **Channel Tracking:** Logs all channels used by a client for diagnostics. * **Single-Pass Detection:** Performs checks once on join to minimize performance overhead. #### Commands | Command | Description | | :--- | :--- | | `/cm reload` | Reload the configuration. | | `/cm check <player>` | View mod and channel info for a player. | | `/cm recheck <player>` | Reset detection status; re-detects upon reconnection. | | `/cm list` | List all detected players. | | `/cm stats` | Show plugin statistics. | #### Installation 1. Install **PacketEvents 2.9.4+**. 2. Download CheckMOD and place it in the `plugins/` folder. 3. Restart the server. 4. Edit `plugins/ChecksMOD/config.yml`. 5. Run `/cm reload`. #### Configuration (`config.yml`) ## 简体中文描述 ## 特性 - **品牌检测** — 拦截 `minecraft:brand` 通道，识别客户端品牌 - **Forge Mod 检测** — 解析 FML 经典握手 Mod 列表（1.20~1.20.1） - **FML3 检测** — 扫描 `fml:loginwrapper` 黑名单 Mod（1.20.2+） - **Fabric 检测** — 识别 Fabric 加载器 - **通道黑名单** — 支持 `*` 通配符匹配网络通道 - **品牌黑白名单** — 精细控制客户端品牌 - **Vanilla-only 模式** — 仅允许纯原版客户端 - **通道追踪** — 记录客户端所有通道，辅助诊断 - **单次检测** — 加入时检测一次，无性能开销 ## 命令 | 命令 | 说明 | |------|------| | `/cm reload` | 重载配置 | | `/cm check <玩家>` | 查看 Mod 和通道信息 | | `/cm recheck <玩家>` | 重置检测，重连后重新检测 | | `/cm list` | 已检测玩家列表 | | `/cm stats` | 统计信息 | ## 安装 1. 安装 (https://modrinth.com/plugin/packetevents) 2.9.4+ 2. 下载 ChecksMOD 放入 `plugins/` 3. 重启服务器 4. 编辑 `plugins/ChecksMOD/config.yml` 5. 执行 `/cm reload` ## 配置 ```yaml # KICK(踢出) / WARN(仅记录) mode: KICK # 仅允许原版客户端 vanilla-only: false # 品牌黑名单 brand-blacklist: - "liquidbounce" - "meteor" - "wurst" # Mod ID 黑名单 mod-blacklist: - "xray" - "baritone" - "wurst-client" # 通道黑名单 (支持 *) channel-blacklist: - "wurst:*" - "xray:*" ``` ## 依赖 - **PacketEvents** 2.9.4+（必备） - **Paper** 1.20 ~ 1.21.5 - **Java** 21 ## 已知限制 - 独立作弊客户端不主动上报 Mod 信息，检测依赖品牌/通道特征 - FML3（Forge 1.20.2+）Mod 列表以压缩 NBT 发送，扫描范围有限 - Fabric 无标准 Mod 列表包，仅识别加载器 - 恶意客户端可伪造数据，本插件不能替代反作弊