CheatDetector ??️
CheatDetector 是一款针对 Paper/Spigot 服务器的先进客户端作弊检测工具。它利用独特的零绕过混合文本翻译检查、Netty 数据包拦截以及绝对移动锁定,来揭露玩家的作弊行为(如 Meteor Client、Wurst、Freecam、ItemScroller、Tweakeroo 等)。
✨ 功能特性
- 零绕过翻译扫描: 强制客户端解析隐藏的翻译组件和键位绑定,立即暴露作弊特有的语言注册表。
- 绝对 Tick-0 锁定: 在玩家加入后的第一个游戏刻就冻结移动、致盲视野、阻止聊天/命令/传送门的使用,以防止其逃脱。
- 裸装物品栏模式: 在扫描期间备份并完全清空物品栏,以 100% 的物品安全性阻止绕过漏洞(例如右键点击 DeluxeMenus 指南针)。
- Netty 管道拦截器: 在网络底层捕获玩家响应数据包,防止 Spigot/Paper 或反作弊引擎阻止或忽略数据包。
- NoSignGUI 绕过保护: 如果玩家使用 NoSignGUI/AntiSignExploit 模组,将在 5 秒超时后自动踢出,并提供清晰的故障排除说明。
- 传送前后选项: 可在扫描前将玩家传送到安全坐标进行检查(可选择在完成后将其送回),或在扫描成功后将玩家传送到出生点/大厅位置。
?️ 工作原理(机制)
CheatDetector 利用客户端渲染行为,静默且安全地向玩家客户端查询作弊注册表。
1. 混合文本翻译检查
Minecraft 使用本地语言文件在客户端侧翻译翻译键(例如 key.meteor-client.open-gui)和键位绑定。
- 原版玩家: 无法解析该键。客户端会显示备用键或文本并将其返回。
- 模组玩家: 会立即将其解析为可读名称(例如
"打开点击 GUI")。客户端将解析后的纯文本发送回服务器。CheatDetector 匹配此字符串并标记作弊。
2. 低层数据包捕获 (Netty)
Paper 引擎如果世界中不存在物理告示牌方块,则会丢弃告示牌更新数据包。CheatDetector 在世界中放置一个持续 4 个游戏刻的临时告示牌,打开编辑器,并通过向玩家发送 AIR 方块更改来隐藏它。Netty 拦截器会在 Paper 评估之前捕获传入的响应数据包,从而避免数据包丢弃和绕过。
? 安装与设置
- 将
CheatDetector.jar 放入服务器的 plugins 文件夹中。
- 重启服务器。
- 打开
plugins/CheatDetector/config.yml 以自定义设置、检查和消息。
- 在游戏中或控制台运行
/cd reload 以应用更改。
? 配置 (config.yml)
该插件生成高度可定制的配置文件:
# Cheat Detector - Configuration
settings:
# 扫描开始前的延迟(以游戏刻为单位)。(20 ticks = 1 秒)
# 建议设置为 40 ticks,以便先加载大厅物品。
scan-delay: 40
# 启用/禁用文本翻译检查系统。
sign-detect: true
# 通过将临时告示牌放置在玩家视线之外来隐藏其放置
hide-check-location: true
behind-player-distance: 3
below-player-min-offset: 2
below-player-max-offset: 4
# 在检查开始前将玩家传送到安全位置
tp-before-check:
enabled: false
world: "world"
x: 0.0
y: 100.0
z: 0.0
yaw: 0.0
pitch: 0.0
restore-old-location: true # 在干净扫描完成后恢复其原始位置
# 在干净扫描完成后将玩家传送到此处
after-check-tp-to-here:
enabled: false
world: "world"
x: 0.0
y: 100.0
z: 0.0
yaw: 0.0
pitch: 0.0
# 当确认作弊时执行的命令。
# %player% -> 玩家名称, %client% -> 模组名称, %warning% -> 警告信息
punish-commands:
- "kick %player% %warning%"
# 检查类型:KEYBIND(用于键位绑定)或 TRANSLATABLE(用于翻译键)
sign-checks:
meteor_client_1:
mode: "TRANSLATABLE"
key: "key.meteor-client.open-gui"
fallback: "key.meteor-client.open-gui"
warning: "禁止使用 Meteor Client!"
freecam_standard_1:
mode: "KEYBIND"
key: "key.freecam.toggle"
warning: "禁止使用 Freecam Mod!"
# [配置文件中列出了更多检查项...]
# 完全可定制的消息(支持颜色代码)
messages:
timeout-kick: "&c[CheatDetector] 未收到扫描响应!\n\n&7如果您没有作弊,这可能是由以下原因引起的:\n&e- 使用了 NoSignGUI、AntiSignExploit 或阻止告示牌的模组。\n&e- 遇到高延迟或连接问题。\n\n&a解决方案:请禁用关闭告示牌屏幕的模组并重新连接。"
timeout-admin-log: "&8[&bCheatDetector&8] &e%player% &7未对告示牌数据包做出响应(超时/NoSignGUI)。"
cheat-found-admin-log: "&8[&bCheatDetector&8] &c%player% &7被标记为:&e%cheat%"
player-clean-admin-log: "&8[&bCheatDetector&8] &a%player% &7是干净的(原版)。"
op-bypass-message: "&c[CheatDetector] &7由于您是 OP,您绕过了超时,但您的客户端未做出响应。"
chat-blocked: "&c扫描期间您无法聊天!"
command-blocked: "&c扫描期间您无法使用命令!"
➕ 如何添加自定义检查
您可以通过在 config.yml 的 sign-checks 部分添加自己的自定义检查,轻松扩展检测库。
1. 查找模组键位
使用压缩工具(如 WinRAR 或 7-Zip)打开目标模组的 .jar 文件,导航至 assets/<mod-id>/lang/en_us.json(或 .toml 语言文件),并找到以下内容的翻译键:
- 键位绑定(例如
key.modname.toggle_fly):将模式设置为 KEYBIND。
- GUI 标题 / 可翻译文本(例如
modname.menu.title):将模式设置为 TRANSLATABLE。
2. 添加到 config.yml
在 sign-checks 下插入你的新定义:
my_custom_mod_check:
mode: "KEYBIND" # 可以是 KEYBIND 或 TRANSLATABLE
key: "key.custommod.gui" # 确切的翻译文本或按键绑定键位
fallback: "key.custommod.gui" # (可选)备用文本(在 KEYBIND 模式下被忽略)
warning: "Custom Mod is forbidden!" # 显示给玩家的信息 / 惩罚指令
? 故障排除
- 玩家因“No response to scan!”(无扫描响应)被踢出:
- 当客户端使用如
NoSignGUI 或 AntiSignExploit 等优化/辅助模组,完全阻止了告示牌编辑界面时,会出现此情况。告知玩家移除这些模组以通过大厅扫描。
- 检查服务器连接。高网络丢包率/延迟可能导致响应数据包超出 5 秒的超时窗口。
- 特定模组未被检测到:
- 仔细检查该模组使用的是
KEYBIND 还是 TRANSLATABLE 检测。如果它在模组代码中注册为按键绑定,请确保在 config.yml 中将 mode 设置为 KEYBIND。
- 玩家在扫描后丢失大厅物品:
- 确保
config.yml 中的 scan-delay 至少设置为 40(即 2 秒),以便大厅插件有足够的时间在 CheatDetector 备份之前交付物品。
CheatDetector ??️
CheatDetector is an advanced client-side cheat detection utility for Paper/Spigot servers. It exposes player hacks (like Meteor Client, Wurst, Freecam, ItemScroller, Tweakeroo, etc.) using a unique zero-bypass hybrid sign-translation check, Netty packet interception, and absolute movement lockdown.
✨ Features
- Zero-Bypass Translation Scan: Forces the client to resolve hidden translation components and keybinds, exposing cheat-specific language registers instantly.
- Absolute Tick-0 Lockdown: Freezes movement, blinds vision, blocks chat/commands/portals from the very first tick they join to prevent escaping.
- Naked Inventory Mode: Backs up and completely clears inventories during scans, stopping bypass exploits (like right-clicking DeluxeMenus compasses) with 100% item safety.
- Netty Pipeline Interceptor: Captures player response packets at a low network level, preventing Spigot/Paper or anti-cheat engines from blocking or ignoring packets.
- NoSignGUI Bypass Protection: Kicks players automatically after a 5-second timeout if they use NoSignGUI/AntiSignExploit mods, providing clear troubleshooting instructions.
- Pre/Post Teleportation Options: Teleports players to a secure inspection coordinate before the scan (optionally sending them back after), or teleports them to a spawn/hub location after a successful scan.
?️ How It Works (The Mechanics)
CheatDetector utilizes client-side rendering behaviors to query the player's client for cheat registries silently and securely.
1. Hybrid Sign-Translation Check
Minecraft translates translation keys (e.g. key.meteor-client.open-gui) and keybinds on the client side using local lang files.
- Vanilla Player: Cannot resolve the key. The client displays the fallback key or text and returns it.
- Modded Player: Instantly resolves it to a readable name (e.g.
"Open Click GUI"). The client sends the resolved plain text back to the server. CheatDetector matches this string and flags the cheat.
2. Low-Level Packet Capture (Netty)
Paper engines drop sign update packets if a physical sign block doesn't exist in the world. CheatDetector places a temporary sign in the world for 4 ticks, opens the editor, and hides it by sending an AIR block change to the player. The Netty interceptor captures the incoming response packet before Paper evaluates it, avoiding packet drops and bypasses.
? Installation & Setup
- Drop
CheatDetector.jar into your server's plugins folder.
- Restart the server.
- Open
plugins/CheatDetector/config.yml to customize settings, checks, and messages.
- Run
/cd reload in-game or console to apply changes.
? Configuration (config.yml)
The plugin generates a highly customizable config file:
# Cheat Detector - Configuration
settings:
# Delay in ticks before the scan starts. (20 ticks = 1 second)
# 40 ticks is recommended to allow lobby items to load first.
scan-delay: 40
# Enable/disable the sign translation check system.
sign-detect: true
# Hide the temporary sign placement by putting it out of player's sight
hide-check-location: true
behind-player-distance: 3
below-player-min-offset: 2
below-player-max-offset: 4
# Teleport the player to a secure location before the check starts
tp-before-check:
enabled: false
world: "world"
x: 0.0
y: 100.0
z: 0.0
yaw: 0.0
pitch: 0.0
restore-old-location: true # Restore their original location upon clean scan completion
# Teleport the player here after a clean scan completes
after-check-tp-to-here:
enabled: false
world: "world"
x: 0.0
y: 100.0
z: 0.0
yaw: 0.0
pitch: 0.0
# Command executed when a cheat is verified.
# %player% -> Player Name, %client% -> Mod Name, %warning% -> Warning message
punish-commands:
- "kick %player% %warning%"
# Check types: KEYBIND (for key bindings) or TRANSLATABLE (for translation keys)
sign-checks:
meteor_client_1:
mode: "TRANSLATABLE"
key: "key.meteor-client.open-gui"
fallback: "key.meteor-client.open-gui"
warning: "Meteor Client is forbidden!"
freecam_standard_1:
mode: "KEYBIND"
key: "key.freecam.toggle"
warning: "Freecam Mod is forbidden!"
# [More checks listed in config...]
# Fully customizable messages (Color codes supported)
messages:
timeout-kick: "&c[CheatDetector] No response to scan!\n\n&7If you are not hacking, this could be caused by:\n&e- Using NoSignGUI, AntiSignExploit, or mods blocking signs.\n&e- Experiencing high ping or connection issues.\n\n&aSolution: Please disable mods that close sign screens and reconnect."
timeout-admin-log: "&8[&bCheatDetector&8] &e%player% &7did not respond to the sign packet (Timeout/NoSignGUI)."
cheat-found-admin-log: "&8[&bCheatDetector&8] &c%player% &7was flagged for: &e%cheat%"
player-clean-admin-log: "&8[&bCheatDetector&8] &a%player% &7is clean (Vanilla)."
op-bypass-message: "&c[CheatDetector] &7You bypassed the timeout because you are OP, but your client did not respond."
chat-blocked: "&cYou cannot chat during the scan!"
command-blocked: "&cYou cannot use commands during the scan!"
➕ How to Add Custom Checks
You can easily expand the detection library by adding your own custom checks inside the sign-checks section of the config.yml.
1. Finding Mod Keys
Open the target mod's .jar file using a zip tool (like WinRAR or 7-Zip), navigate to assets/<mod-id>/lang/en_us.json (or .toml lang files), and find the translation keys for:
- Keybindings (e.g.
key.modname.toggle_fly): Set the mode to KEYBIND.
- GUI Titles / Translatable Text (e.g.
modname.menu.title): Set the mode to TRANSLATABLE.
2. Adding to config.yml
Insert your new definition under sign-checks:
my_custom_mod_check:
mode: "KEYBIND" # Either KEYBIND or TRANSLATABLE
key: "key.custommod.gui" # The exact translation or keybind key
fallback: "key.custommod.gui" # (Optional) Fallback text (ignored in KEYBIND mode)
warning: "Custom Mod is forbidden!" # Warning shown to player / punisher command
? Troubleshooting
- Players are getting kicked for "No response to scan!":
- This happens when a client uses optimization/utility mods like
NoSignGUI or AntiSignExploit which block sign editing screens entirely. Inform players to remove these mods to pass the lobby scan.
- Check the server connection. High network packet loss/ping might delay the response packet beyond the 5-second timeout window.
- A specific mod is not being detected:
- Double-check if the mod uses a
KEYBIND or TRANSLATABLE check. If it is registered as a keybind in the mod's code, ensure mode is set to KEYBIND in config.yml.
- Players lose lobby items after scan:
- Ensure the
scan-delay in config.yml is set to at least 40 (2 seconds) so lobby plugins have enough time to deliver items before CheatDetector backs them up.
评论 0
登录后参与评分
还没有评论,来抢沙发吧