Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
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-ticksnow defaults to1instead of5. 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-rulesentry,result: ANYmatches 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-rulesis 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.ymlandcheckhacks.yml. /chalertshas three states -all,only-detectedandoff. Set the default withalerts.default-mode.- Components V2 fixed - webhooks now send
?with_components=trueand 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
DETECTEDorPROTECTEDresult 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 + letteredge case, and the exploit-preventer logic is checked separately forMETEOR,TRANSLATEandKEYBIND. 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-rulesaccepts any mod id andresult: ANY,DETECTED,NOT_DETECTED,PROTECTEDorSKIPPED. Global commands get a comma-separated list of every flagged hack- Command placeholders:
%player%,%hack%,&hack&,{hack}. With two hacks found,&hack&becomesMeteor, Wurst;tempban %player% 7d Hack &hack&works as expected
๐ Auto Updater
- On startup we check
https://github.com/branduzzo/CheckHacks/releases/latestin the background. If you are offline we just skip it, nothing gets spammed in console - If we find a newer
vX.Y.Z, everyone withcheckhacks.updatewill see a message when they join:CheckHacks 1.3.2 is available! Click here to download.It is already translated in everymessages/*.yml - If they click it, it runs
/checkhacksupdate, downloadsCheckHacks-X.Y.Z.jarintoplugins/, backs up or removes the old jar and saysDownload completed! Restart the server - You need
checkhacks.updateto see the message and to run the command. It is already included incheckhacks.*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-ticksdefaults to1 - 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: truesends a clean Container with your accent color, Text Display blocks, a Separator and a timestamp footer (flags: 32768). Set it tofalsefor 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.ymlfor general settings,checkhacks.ymlfor mods,checklang.ymlfor languages doublecheck: trueruns the second confirmation scan;detect-flag.anticheatslets 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: trueenables the Matrix hook; Grim, Vulcan and Spartan have their own toggles next to itdoublecheckrepeats anyDETECTEDorPROTECTEDbatch once, which is useful on busy serversdiscord.use-components-v2switches between the Components V2 Container and classic embedscommand-rulesis 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:



