ChecksMOD v1.1.0 更新说明

发布日期：2026-07-05 | 作者：YuHongChen(LiquidTeam)

---

🆕 新增内容

1. Paper 1.21.5 支持

• Paper API 升级至 1.21.5-R0.1-SNAPSHOT
• 兼容 Paper 1.20 ~ 1.21.5 全版本

2. PacketEvents 2.9.4+

• PacketEvents 升级至 2.9.4，支持最新的 Minecraft 协议变更

3. 通道追踪

• 记录玩家加入时发送的所有网络通道
• /cm check <玩家> 会显示通道列表，黄色标记的 §e[未知] 通道即为可疑
• 帮助管理员快速发现未知客户端特征

4. 品牌空值检测

• 原版客户端不会向服务端发送 minecraft:brand 通道
• 只要客户端发送了该通道（即使内容为空），即可判定为非原版客户端
• 空品牌显示为 空品牌(可疑)

---

🔧 修复问题

问题	原因	修复
LiquidBounce 无法拦截	品牌内容为空字符串，未被判定为违规	空品牌也触发检测
退出重进不检测	checkedPlayers 未在退出时清除	新增 PlayerQuitEvent 清除状态
Forge 通道被误标为 Fabric	fml: 在 Fabric 通道前缀中	分离出独立的 Forge 通道检测
Configuration 阶段包被跳过	Bukkit.getPlayer() 在该阶段返回 null	改用 event.getPlayer()

---

⚠️ 注意事项

运行环境

要求	说明
Java 21	Paper 1.21.5 强制要求 JDK 21
PacketEvents 2.9.4+	必须安装对应版本的 PacketEvents 插件
Paper 服务端	不支持 Spigot / CraftBukkit

兼容性说明

• Paper 1.20 ~ 1.21.1 → 需要 PacketEvents 2.7.0+（包括 2.9.4）
• Paper 1.21.2 ~ 1.21.5 → 需要 PacketEvents 2.9.4+ + Java 21
• 迁移前请先在测试环境验证 PacketEvents 版本兼容性

已知限制

1. 独立作弊客户端拦截有限

   • 如 LiquidBounce 虽然能被空品牌检测捕获，但仍有部分静默客户端无法检测
   • 建议配合反作弊插件使用

2. FML3 Mod 列表解析有限

   • Forge 1.20.2+ 的 Mod 列表以压缩 NBT 发送，目前仅能扫描黑名单 Mod
   • 不影响踢出功能，仅影响 /cm check 显示的 Mod 列表完整度

3. Fabric 无完整 Mod 列表

   • Fabric 没有标准 Mod 列表包，只能检测是否使用了 Fabric 加载器

4. 客户端可伪造数据

   • 检测依赖客户端主动上报，恶意客户端可伪造/屏蔽
   • 本插件不能替代反作弊系统

---

📦 安装步骤

1. 下载 PacketEvents 2.9.4+ → plugins/
   • 下载地址：Modrinth 或 CodeMC
2. 下载 ChecksMOD-1.1.0.jar → plugins/
3. 重启服务器
4. 编辑 plugins/ChecksMOD/config.yml 配置黑名单
5. 执行 /cm reload 重载配置

---

📋 命令速查

命令	权限	说明
/cm reload	checksmod.reload	重载配置
/cm check <玩家>	checksmod.check	查看 Mod/通道信息
/cm recheck <玩家>	checksmod.check	重置检测状态
/cm list	checksmod.check	已检测玩家列表
/cm stats	checksmod.check	统计信息

---

🔄 从 1.0.0 升级

• config.yml 完全兼容，无需修改
• 只需替换 jar 文件
• 如使用 Paper 1.21.2+，请确保：
  • 服务端已升级到 Java 21
  • PacketEvents 已升级到 2.9.4+
• 升级后执行 /cm reload