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. 安装 PacketEvents 2.9.4+
2. 下载 ChecksMOD 放入 plugins/
3. 重启服务器
4. 编辑 plugins/ChecksMOD/config.yml
5. 执行 /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 列表包，仅识别加载器
• 恶意客户端可伪造数据，本插件不能替代反作弊