Compatibility
Minecraft: Java Edition
1.21.x
1.20.x
Platforms
Tags
Creators
Details
Licensed MIT
Published last week
Updated last month
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:brandchannel to identify client brands. - Forge Mod Detection: Parses the FML classic handshake mod list (1.20–1.20.1).
- FML3 Detection: Scans
fml:loginwrapperfor 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
- Install PacketEvents 2.9.4+.
- Download CheckMOD and place it in the
plugins/folder. - Restart the server.
- Edit
plugins/ChecksMOD/config.yml. - 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 |
统计信息 |
安装
- 安装 PacketEvents 2.9.4+
- 下载 ChecksMOD 放入
plugins/ - 重启服务器
- 编辑
plugins/ChecksMOD/config.yml - 执行
/cm reload
配置
# 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 列表包,仅识别加载器
- 恶意客户端可伪造数据,本插件不能替代反作弊


