- 版权类型
- 原创
- 插件中文名称
- 客户端检测
- 插件英文名称
- ChecksMOD
- 原帖地址
- #
- 支持的核心（服务端）
- Paper
- 语言支持
- 多语言
- 前置组件
- PacketEvents https://modrinth.com/plugin/packetevents
- 适配版本（Java）
- 1.21
- 1.20
[MD]
# ChecksMOD
检测玩家客户端 Mod，踢出黑名单违规 Mod。支持 Paper 1.20 ~ 1.21.5。
---
## 特性
- **品牌检测** — 拦截 `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. 安装 [PacketEvents](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 列表包，仅识别加载器
- 恶意客户端可伪造数据，本插件不能替代反作弊
[/MD]
