通过模组追踪黑客。100% 服务端,无需客户端模组。
它利用了告示牌翻译漏洞(MC-265322),与 DonutSMP 用来抓捕作弊者的技巧相同。一个虚拟告示牌会被发送在玩家上方或下方,并在同一刻内打开并关闭编辑器,而不会在世界中放置真实的告示牌。
🆕 1.3.2 新增内容
- 隐形告示牌探测 - 假告示牌放置在玩家上方或下方的空中,远离正常视野,并且编辑器会在同一刻内关闭。这消除了以往导致 GUI 可见的一刻延迟。
- 更快的扫描 -
between-sign-ticks 现在默认为 1 而不是 5。使用 DoubleCheck 进行完整检查现在只需几秒钟即可完成。
- Minecraft 26.3 和 1.21.x 打包在同一个 jar 中 - 在 26.x 版本上,虚拟告示牌通过 PacketEvents 2.14 发送;在 1.21.x 上,相同的包通过小型 NMS/Netty 桥接器发送。不会放置真实的告示牌方块,编辑器会在同一刻内打开并关闭。
- 内置 PacketEvents - 您不需要单独安装它。在 26.x 上,它需要随服务器提供的 Adventure 版本;1.21.x 桥接器没有外部依赖。
- 规则是通用的 - 任何模组都可以拥有
command-rules 条目,result: ANY 匹配所有结果,并且可以从 Web 编辑器创建、编辑和删除规则。
- 配置合并器 - 新键和新默认检测会添加到现有文件中,而不会触碰您的值。
command-rules 由用户拥有,永远不会被重新添加。
- Material 3 Web 编辑器 - 新的 Material 3 界面,包含浅色和深色主题,以及与服务端前缀匹配的黄色/绿色 CheckHacks 配色板,还有 Rules 页面和 Settings 页面,用于写入
config.yml 和 checkhacks.yml。
/chalerts 有三种状态 - all、only-detected 和 off。使用 alerts.default-mode 设置默认值。
- Components V2 已修复 - Webhook 现在发送
?with_components=true 并读取真实的 Discord 错误,因此 HTTP 400 错误已消失。
- 玩家众多时更快 - 缓存反射、缓存告示牌组件、单个 webhook 队列、异步数据库写入和不可变配置快照。
❓ 那么 CheckHacks 是什么?
CheckHacks 是一个服务端反作弊插件,可以在玩家无需安装任何内容的情况下判断他们正在运行哪些模组。它是通过利用告示牌翻译漏洞(MC-265322)来实现的。
实际操作流程如下:
- 您启动检查,或者当有人加入或您的反作弊系统标记他们时自动开始
- 插件选择玩家上方或下方的空气方块,并向该位置发送一个虚拟告示牌,而不改变世界
- 在该告示牌上写入特殊的翻译键
- 他们的客户端打开告示牌编辑器,服务器在同一刻内关闭它
- 我们读取他们客户端返回的内容,并还原原始的客户端方块
每个模组都会注册自己的翻译键,因此原版客户端和模组客户端会有不同的响应。这种差异告诉我们确切安装了什么。
👀 加入扫描在地形加载期间运行并保持隐形。在游戏内扫描在正常情况下也是隐形的,因为编辑器会在同一刻内打开并关闭;在严重卡顿的客户端上,仍然可能出现一帧闪烁。
💡 一个告示牌最多可以检查 3 个模组。如果您有更多,我们只是依次发送它们。您可以自行设置延迟。
✨ 功能
🔍 检测
- 完全在服务器端运行,你的玩家无需下载任何内容
- 假告示牌放置在玩家上方或下方的空气中,而不是在其正常视线范围内
- 编辑器在同一刻(tick)内打开并关闭,因此告示牌无法被阅读
- 三种模式:
METEOR、TRANSLATE、KEYBIND,每个模组会自动使用正确的模式
- 如果有人启用了漏洞保护,他们会显示为 PROTECTED,而不是被错误地标记为干净(并非所有模组都适用此规则)
- 如果有人完全不响应,他们也会被标记为 PROTECTED。他们可能正在屏蔽数据包
- DoubleCheck 系统会对每个
DETECTED 或 PROTECTED 的结果进行二次扫描复查,从而减少误报
- 开箱即用的更多检测 - Trouser Streak、Trouser Streak NewerNewChunks/AnHero、Ui Utils、SeedCrackerX、Simple World Downloader、Glazed、Litematica、Item Scroller、Xaero's Minimap、Baritone、LiquidBounce、Wurst 等均在下方表格中列出
- 更少的误报 - 响应解析器处理空回复和
key + letter 的边界情况,并且针对 METEOR、TRANSLATE 和 KEYBIND 分别检查防漏洞逻辑。对 Bedrock、Geyser 和 Floodgate 的跳过也更可靠
- 你可以在
checkhacks.yml 中添加自定义模组以进行检测
- 如果 Bedrock 玩家的名称以你设置的前缀(如
. 或 *)开头,则会自动跳过
⚡ 自动化
- 加入时自动检查,可配置延迟,并提供仅首次加入时运行的选项
- 自动语言检查同理,同样提供仅首次加入时运行的选项
- 直接挂钩到 Grim, Vulcan, Spartan 和 Matrix。如果它们标记了某人,我们会立即检查该玩家。
- 每位玩家独立的冷却时间,避免自动检查造成刷屏
- 你可以为普通检查、加入检查和反作弊检查设置不同的作弊列表
- 当有人被 DETECTED、PROTECTED 或判定为干净时,执行你自己的命令;此外还支持按模组设置的 command-rules 并附带结果过滤器
command-rules 接受任何模组 ID 以及 result: ANY、DETECTED、NOT_DETECTED、PROTECTED 或 SKIPPED。全局命令会获得一个逗号分隔的所有被标记作弊的列表
- 命令占位符:
%player%、%hack%、&hack&、{hack}。如果找到两个作弊,&hack& 将变为 Meteor, Wurst;tempban %player% 7d Hack &hack& 可按预期工作
🔄 自动更新器
- 启动时,我们会在后台检查
https://github.com/branduzzo/CheckHacks/releases/latest。如果你处于离线状态,我们只会跳过检查,控制台不会发送任何垃圾信息
- 如果发现更新的
vX.Y.Z 版本,拥有 checkhacks.update 权限的玩家在加入时会看到一条消息:CheckHacks 1.3.2 is available! Click here to download. 该消息已在所有 messages/*.yml 文件中翻译完毕
- 如果他们点击链接,系统将运行
/checkhacksupdate,将 CheckHacks-X.Y.Z.jar 下载到 plugins/ 目录,备份或删除旧 jar 包,并提示 Download completed! Restart the server
- 你需要
checkhacks.update 权限才能查看消息并运行该命令。它已包含在 checkhacks.* 中,因此服务器管理员默认拥有此权限
⚡ 性能
- 比 1.3.0 之前的调度程序快约 3 倍:告示牌的处理效率更高,且
between-sign-ticks 默认值为 1
- SQLite with WAL,单个数据库连接,缓存的消息和缓存的反射对象,异步 Webhook 和异步数据库写入
- 不可变配置快照,防止重载导致正在进行的检查中途更改
- 针对 1.21.4 及以上版本 的 NMS 修复,使旧版桥接保持兼容,无需额外设置
📢 警报与结果
- 结果发送给所有拥有
checkhacks.alerts 权限的玩家,任何人都可以通过 /chalerts 切换显示
- 如果你启动了检查但没有警报权限,你仍会在私聊中收到结果,以免遗漏
- 每一行都会告诉你模组名称及发生的情况:
DETECTED、NOT_DETECTED、PROTECTED、SKIPPED
- 我们还会显示是谁启动了检查以及原因,例如手动检查、加入检查或反作弊标记
🌐 Web 和 Discord
- 内置 SQLite。每次扫描都会被保存,你无需进行任何设置
- Web 编辑器直接在服务器上运行。你可以浏览历史扫描记录、查询玩家并从浏览器发起新的检查
- 登录使用来自
/cheditor 的一次性令牌,无需记住密码
- 两个独立的 Discord Webhook,一个用于作弊检查,一个用于语言检查,均启用 Components V2 开关
discord.use-components-v2: true 会发送带有强调色、Text Display 方块、分隔线和时间戳页脚的整洁 Container(flags: 32768)。设置为 false 则使用经典嵌入样式
- 我们现在读取 Discord 的真实错误响应并发送
?with_components=true,从而消除旧的 HTTP 400 错误
- 可用的 Webhook 占位符:
&name& &checker& &reason& &hacks& &results& &lang&
🎨 自定义
- 配置文件清晰分离:
config.yml 用于常规设置,checkhacks.yml 用于模组,checklang.yml 用于语言
doublecheck: true 运行第二次确认扫描;detect-flag.anticheats 允许独立启用 Grim、Vulcan、Spartan 和 Matrix
- 每条消息都在其单独的文件中,你只需在配置中修改一行即可切换语言
- 所有内容均支持 MiniMessage、自定义前缀和 PlaceholderAPI
- 包含 9 种语言以及所有更新器字符串:
update-available、update-downloading、update-complete、update-restart-required、update-failed、update-no-update
🌍 Languages included (click to expand)
en.yml · it.yml · de.yml · es.yml · fr.yml · pt.yml · br.yml · ru.yml · lolcat.yml · uwu.yml
🔍 Detected Mods
| 模组 |
模式 |
| Meteor Client |
METEOR |
| LiquidBounce |
TRANSLATE |
| Freecam |
KEYBIND |
| Wurst Client (-1.21) |
KEYBIND |
| Aristois |
TRANSLATE |
| XRay (Fabric) |
KEYBIND |
| ChestESP |
KEYBIND |
| KillAura (Fabric) |
KEYBIND |
| AutoFish |
KEYBIND |
| Lumina |
KEYBIND |
| AutoSwitch |
KEYBIND |
| BleachHack |
TRANSLATE |
| Coffee Client |
TRANSLATE |
| World Downloader |
TRANSLATE |
| AutoClicker (Fabric) |
TRANSLATE |
| AntiAFK |
TRANSLATE |
| Baritone |
TRANSLATE |
| Auto Clicker (p1k0chu) |
KEYBIND |
| Trouser Streak |
TRANSLATE |
| Trouser Streak (NewerNewChunks) |
TRANSLATE |
| Trouser Streak (AnHero) |
TRANSLATE |
| Ui Utils |
TRANSLATE |
| SeedCrackerX |
TRANSLATE |
| Simple World Downloader |
TRANSLATE |
| Glazed |
TRANSLATE |
| Litematica |
TRANSLATE |
| Item Scroller |
TRANSLATE |
| Xaeros Minimap |
TRANSLATE |
➕ 希望我们添加某个模组?加入我们的 Discord 并打开工单,我们会处理。
🎬 展示
▶️ 点击缩略图在 YouTube 上观看(3:13)。
⌨️ 命令
| 命令 |
功能 |
/checkhacks <player> |
检查你配置的所有模组 |
/checkhacks <player> meteor-client,freecam |
仅检查你列出的模组 |
/checklang <player> |
尝试通过告示牌判断其客户端语言 |
/checklang <player> en_us,it_it |
仅检查这些语言 |
/cheditor |
给你一个一次性链接以访问网页编辑器 |
/chalerts |
循环切换警报:all -> only-detected -> off (也支持 /checkalerts、/alerts 或 /chalerts only-detected) |
/checkhacksupdate |
获取 GitHub 上的最新 CheckHacks 版本 (需要 checkhacks.update 权限) - 只需点击更新消息即可 |
/chreload |
重新加载所有配置,无需重启服务器 |
🔑 权限
| 权限 |
用途 |
checkhacks.check |
允许你运行作弊检测 |
checkhacks.checklang |
允许你运行语言检测 |
checkhacks.reload |
允许你重新加载配置 |
checkhacks.alerts |
允许你接收警报并切换它们的状态 |
checkhacks.editor |
允许你创建网页编辑器的令牌 |
checkhacks.update |
允许你查看更新通知并运行 /checkhacksupdate |
checkhacks.* |
授予以上所有权限 |
⚙️ 配置
plugins/CheckHacks/
├── config.yml # 常规设置、alerts.default-mode、Discord、网页编辑器
├── checkhacks.yml # 作弊检测、自定义模组列表、detect-flag、command-if-*、command-rules、doublecheck、matrix
├── checklang.yml # 语言检测 + discord.use-components-v2
├── messages/
│ ├── en.yml # 英文消息以及所有 update-* 键
│ ├── it.yml # 意大利文
│ └── ... # de, es, fr, br, ru, lolcat, uwu
└── database.db # 扫描历史,它会自动生成
你实际会用到的内容
# config.yml and checklang.yml
discord:
use-components-v2: true # false 给你经典嵌入框,true 给你新的 Components V2 容器
alerts:
default-mode: "all" # all, only-detected 或 off
# checkhacks.yml
detect-flag:
anticheats: { grim: true, vulcan: true, spartan: true, matrix: true }
doublecheck: true
timeout-ticks: 200
between-sign-ticks: 1 # 1 是最快;仅在服务器需要时增加此值
command-if-positive: { enabled: false, command: "tempban %player% 14d Cheating &hack&" }
command-rules:
meteorclient1: { mod: meteorclient, result: DETECTED, command: "tempban %player% 31d Meteor &hack&" }
freecam1: { mod: freecam, result: ANY, command: "alert %player% freecam" }
# mod 可以是任何作弊 ID,result 可以是 ANY, DETECTED, NOT_DETECTED, PROTECTED 或 SKIPPED
# 你可以使用 %player%, %hack%, &hack&, {hack}, {player} - 它们都有效
detect-flag.anticheats.matrix: true 启用 Matrix 钩子;Grim、Vulcan 和 Spartan 在旁边有各自的开关
doublecheck 会重复执行一次任何 DETECTED 或 PROTECTED 的批量检测,这在繁忙的服务器上很有用
discord.use-components-v2 在 Components V2 容器和经典嵌入框之间切换
command-rules 可以从网页编辑器完全编辑,因此你不必为了针对特定模组的惩罚而修改 YAML
🖥️ 网页编辑器
网页编辑器直接运行在你的服务器上,你不需要将其托管在其他地方。
- 📊 浏览所有的旧扫描记录和结果
- 👤 查找你之前检查过的玩家
- ▶️ 直接从浏览器启动新的检测
- 🌍 同时检查语言检测结果
- 📜 创建、编辑和删除命令规则,无需触碰 YAML
- ⚙️ 更改警报、检测和 Discord 设置
- 🔐 它被锁定在一次性令牌之后,来自
/cheditor,因此没有共享密码
⚠️ 注意
模组开发者可以随时修补他们的客户端并试图阻止这种技巧。如果他们这样做,对该特定客户端的检测可能会暂时失效。我们会持续追踪补丁,寻找绕过方法,并在模组推出时添加新的检测。
这是一场猫鼠游戏,而不是一次性修复。
☕ 支持我
CheckHacks 将永远免费。如果它帮助你的服务器免受作弊者侵害,并且你想表示感谢,你可以在 PayPal 上请我喝咖啡。每一笔捐赠都能让这个项目继续下去,并帮助我在那些模组补丁面前保持领先。
📜 致谢与支持
由 Branduzzo 制作。
需要帮助、想要请求功能或需要添加模组?来 Discord 逛逛:
如果 CheckHacks 正在帮助你的服务器,请在仓库中留下一个 ⭐,这意义重大!
Catch hackers by their mods. 100% server side, no client mod needed.
It uses the Sign Translation Vulnerability (MC-265322), the same trick DonutSMP uses to catch cheaters. A virtual sign is sent above or below the player and its editor is opened and closed in the same tick, without placing a real sign in the world.
🆕 What is new in 1.3.2
- Invisible sign probe - the fake sign is placed in air above or below the player, away from the normal view, and the editor is closed in the same tick. This removes the one-tick delay that used to make the GUI visible.
- Faster scans -
between-sign-ticks now defaults to 1 instead of 5. A full check with DoubleCheck now finishes in a couple of seconds.
- Minecraft 26.3 and 1.21.x in the same jar - on 26.x the virtual sign is sent through PacketEvents 2.14; on 1.21.x the same packets are sent through a small NMS/Netty bridge. No real sign block is placed, and the editor is opened and closed in the same tick.
- PacketEvents is bundled - you do not need to install it separately. On 26.x it needs the Adventure version shipped with that server; the 1.21.x bridge has no external dependency.
- Rules are generic - any mod can have a
command-rules entry, result: ANY matches every result, and rules can be created, edited and deleted from the web editor.
- Config merger - new keys and new default detections are added to existing files without touching your values.
command-rules is user owned and is never re-added.
- Material 3 web editor - new Material 3 interface with light and dark themes, a yellow/green CheckHacks palette matching the server prefix, a Rules page and a Settings page that writes
config.yml and checkhacks.yml.
/chalerts has three states - all, only-detected and off. Set the default with alerts.default-mode.
- Components V2 fixed - webhooks now send
?with_components=true and read the real Discord error, so the HTTP 400 is gone.
- Faster with many players - cached reflection, cached sign components, one webhook queue, async database writes and immutable config snapshots.
❓ So what is CheckHacks?
CheckHacks is a server side anticheat that can tell which mods a player is running without them having to install anything. It works by using the Sign Translation Vulnerability (MC-265322).
Here is how it works in practice:
- You start a check, or it starts automatically when someone joins or your anticheat flags them
- The plugin picks an air block above or below the player and sends a virtual sign there, without changing the world
- It writes special translation keys on that sign
- Their client opens the sign editor and the server closes it in the same tick
- We read what their client sent back and restore the original client block
Every mod registers its own translation keys, so a vanilla client and a modded client will respond differently. That difference is what tells us exactly what they have installed.
👀 Join scans run during terrain loading and stay invisible. In-game scans are invisible in normal conditions because the editor is opened and closed in the same tick; on a heavily lagging client a one-frame flash is still possible.
💡 One sign can check up to 3 mods. If you have more, we just send them one after another. You can set the delay yourself.
✨ Features
🔍 Detection
- Fully server side, your players do not need to download anything
- The fake sign is placed in air above or below the player, not in their normal line of sight
- The editor is opened and closed in the same tick, so the sign cannot be read
- Three modes,
METEOR, TRANSLATE, KEYBIND, and each mod automatically uses the right one
- If someone has exploit protection, they show up as PROTECTED instead of being marked as clean by mistake (not with all mods)
- If someone does not respond at all, they are also marked as PROTECTED. They are probably blocking packets
- The DoubleCheck system rechecks every
DETECTED or PROTECTED result with a second scan, which cuts down on false positives
- More detections out of the box - Trouser Streak, Trouser Streak NewerNewChunks/AnHero, Ui Utils, SeedCrackerX, Simple World Downloader, Glazed, Litematica, Item Scroller, Xaero's Minimap, Baritone, LiquidBounce, Wurst and more are in the table below
- Fewer false flags - the response parser handles empty replies and the
key + letter edge case, and the exploit-preventer logic is checked separately for METEOR, TRANSLATE and KEYBIND. Bedrock, Geyser and Floodgate skipping is also more reliable
- You can add your own custom mods to detect in
checkhacks.yml
- Bedrock players are skipped automatically if their name starts with your prefix like
. or *
⚡ Automation
- Auto check on join, with a delay you can configure and an option to run only on first join
- Same for auto language check, also with a first join only option
- Hooks directly into Grim, Vulcan, Spartan and Matrix. If they flag someone, we check that player right away.
- Cooldown per player so you do not get spammed with automatic checks
- You can set different hack lists for normal checks, join checks and anticheat checks
- Run your own commands when someone is DETECTED, PROTECTED or clean, plus per mod command-rules with a result filter
command-rules accepts any mod id and result: ANY, DETECTED, NOT_DETECTED, PROTECTED or SKIPPED. Global commands get a comma-separated list of every flagged hack
- Command placeholders:
%player%, %hack%, &hack&, {hack}. With two hacks found, &hack& becomes Meteor, Wurst; tempban %player% 7d Hack &hack& works as expected
🔄 Auto Updater
- On startup we check
https://github.com/branduzzo/CheckHacks/releases/latest in the background. If you are offline we just skip it, nothing gets spammed in console
- If we find a newer
vX.Y.Z, everyone with checkhacks.update will see a message when they join: CheckHacks 1.3.2 is available! Click here to download. It is already translated in every messages/*.yml
- If they click it, it runs
/checkhacksupdate, downloads CheckHacks-X.Y.Z.jar into plugins/, backs up or removes the old jar and says Download completed! Restart the server
- You need
checkhacks.update to see the message and to run the command. It is already included in checkhacks.* so server operators have it by default
⚡ Performance
- Roughly 3 times faster than the pre-1.3.0 scheduler: signs are handled more efficiently and
between-sign-ticks defaults to 1
- SQLite with WAL, a single database connection, cached messages and cached reflection, async webhooks and async database writes
- Immutable config snapshots so a reload cannot change an in-flight check halfway through
- NMS fixes for 1.21.4 and up, so the legacy bridge stays compatible without extra setup
📢 Alerts and Results
- Results go to everyone with
checkhacks.alerts, and anyone can toggle them with /chalerts
- If you started the check but do not have the alerts permission, you still get the result in private so you do not miss it
- Every line tells you the mod and what happened:
DETECTED, NOT_DETECTED, PROTECTED, SKIPPED
- We also show who started the check and why, like manual check, join check or anticheat flag
🌐 Web and Discord
- SQLite is built in. Every scan gets saved, you do not need to set anything up
- Web editor runs right on your server. You can browse old scans, look up players and start new checks from your browser
- Login is a one time token from
/cheditor. No passwords to remember
- Two separate Discord webhooks, one for hack checks and one for language checks, both with the Components V2 toggle
discord.use-components-v2: true sends a clean Container with your accent color, Text Display blocks, a Separator and a timestamp footer (flags: 32768). Set it to false for classic embeds
- We now read Discord's real error response and send
?with_components=true, so the old HTTP 400 is gone
- Webhook placeholders you can use:
&name& &checker& &reason& &hacks& &results& &lang&
🎨 Customization
- Configs are split up cleanly:
config.yml for general settings, checkhacks.yml for mods, checklang.yml for languages
doublecheck: true runs the second confirmation scan; detect-flag.anticheats lets you enable Grim, Vulcan, Spartan and Matrix independently
- Every message is in its own file, you can switch language with one line in the config
- Everything supports MiniMessage, your own prefix and PlaceholderAPI
- 9 languages included plus all the updater strings:
update-available, update-downloading, update-complete, update-restart-required, update-failed, update-no-update
🌍 Languages included (click to expand)
en.yml · it.yml · de.yml · es.yml · fr.yml · pt.yml · br.yml · ru.yml · lolcat.yml · uwu.yml
🔍 Detected Mods
| Mod |
Mode |
| Meteor Client |
METEOR |
| LiquidBounce |
TRANSLATE |
| Freecam |
KEYBIND |
| Wurst Client (-1.21) |
KEYBIND |
| Aristois |
TRANSLATE |
| XRay (Fabric) |
KEYBIND |
| ChestESP |
KEYBIND |
| KillAura (Fabric) |
KEYBIND |
| AutoFish |
KEYBIND |
| Lumina |
KEYBIND |
| AutoSwitch |
KEYBIND |
| BleachHack |
TRANSLATE |
| Coffee Client |
TRANSLATE |
| World Downloader |
TRANSLATE |
| AutoClicker (Fabric) |
TRANSLATE |
| AntiAFK |
TRANSLATE |
| Baritone |
TRANSLATE |
| Auto Clicker (p1k0chu) |
KEYBIND |
| Trouser Streak |
TRANSLATE |
| Trouser Streak (NewerNewChunks) |
TRANSLATE |
| Trouser Streak (AnHero) |
TRANSLATE |
| Ui Utils |
TRANSLATE |
| SeedCrackerX |
TRANSLATE |
| Simple World Downloader |
TRANSLATE |
| Glazed |
TRANSLATE |
| Litematica |
TRANSLATE |
| Item Scroller |
TRANSLATE |
| Xaeros Minimap |
TRANSLATE |
➕ Want us to add a mod? Join our Discord and open a ticket, we will take care of it.
🎬 Showcase
▶️ Click the thumbnail to watch it on YouTube (3:13).
⌨️ Commands
| Command |
What it does |
/checkhacks <player> |
Checks every mod you have configured |
/checkhacks <player> meteor-client,freecam |
Only checks the mods you list |
/checklang <player> |
Tries to figure out their client language using signs |
/checklang <player> en_us,it_it |
Only checks those languages |
/cheditor |
Gives you a one time link to the web editor |
/chalerts |
Cycles alerts: all -> only-detected -> off (also /checkalerts, /alerts, or /chalerts only-detected) |
/checkhacksupdate |
Gets the latest CheckHacks from GitHub (needs checkhacks.update) - just click the update message |
/chreload |
Reloads all configs, no restart needed |
🔑 Permissions
| Permission |
What it is for |
checkhacks.check |
Lets you run hack checks |
checkhacks.checklang |
Lets you run language checks |
checkhacks.reload |
Lets you reload configs |
checkhacks.alerts |
Lets you get alerts and toggle them |
checkhacks.editor |
Lets you create web editor tokens |
checkhacks.update |
Lets you see update notices and run /checkhacksupdate |
checkhacks.* |
Gives all of the above |
⚙️ Configuration
plugins/CheckHacks/
├── config.yml # General, alerts.default-mode, Discord, web editor
├── checkhacks.yml # Hack checks, your custom mods, detect-flag, command-if-*, command-rules, doublecheck, matrix
├── checklang.yml # Language checks + discord.use-components-v2
├── messages/
│ ├── en.yml # English messages plus all the update-* keys
│ ├── it.yml # Italian
│ └── ... # de, es, fr, br, ru, lolcat, uwu
└── database.db # Scan history, it just shows up by itself
Stuff you will actually use
# config.yml and checklang.yml
discord:
use-components-v2: true # false gives you classic embeds, true gives you the new Components V2 Container
alerts:
default-mode: "all" # all, only-detected or off
# checkhacks.yml
detect-flag:
anticheats: { grim: true, vulcan: true, spartan: true, matrix: true }
doublecheck: true
timeout-ticks: 200
between-sign-ticks: 1 # 1 is the fastest; increase it only if your server needs it
command-if-positive: { enabled: false, command: "tempban %player% 14d Cheating &hack&" }
command-rules:
meteorclient1: { mod: meteorclient, result: DETECTED, command: "tempban %player% 31d Meteor &hack&" }
freecam1: { mod: freecam, result: ANY, command: "alert %player% freecam" }
# mod can be any hack id, result can be ANY, DETECTED, NOT_DETECTED, PROTECTED or SKIPPED
# you can use %player%, %hack%, &hack&, {hack}, {player} - they all work
detect-flag.anticheats.matrix: true enables the Matrix hook; Grim, Vulcan and Spartan have their own toggles next to it
doublecheck repeats any DETECTED or PROTECTED batch once, which is useful on busy servers
discord.use-components-v2 switches between the Components V2 Container and classic embeds
command-rules is fully editable from the web editor, so you do not have to touch YAML for per-mod punishments
🖥️ Web Editor
The web editor runs right on your server, you do not need to host it somewhere else.
- 📊 Scroll through every old scan and result
- 👤 Look up players you checked before
- ▶️ Start new checks right from your browser
- 🌍 Check language results too
- 📜 Create, edit and delete command rules without touching YAML
- ⚙️ Change alerts, detection and Discord settings
- 🔐 It is locked behind one time tokens from
/cheditor, so no shared password
⚠️ Heads up
Mod developers can patch their clients whenever they want and try to block this trick. If they do, detection for that specific client might stop working for a while. We keep chasing patches, finding bypasses and adding new mods as they come out.
It is a cat and mouse game, not a one time fix.
☕ Support Me
CheckHacks will always be free. If it saved your server from cheaters and you want to say thanks, you can buy me a coffee on PayPal. Every donation keeps this project going and helps me stay ahead of those mod patches.
📜 Credits and Support
Made by Branduzzo.
Need help, want to request a feature or need a mod added? Come hang out on Discord:
If CheckHacks is helping your server, drop a ⭐ on the repo, it means a lot!
评论 0
登录后参与评分
还没有评论,来抢沙发吧