Client Guard
Blacklist certain mods such as Freecam, hack clients, etc. The only plugin that allows for kicking players with selected mods without a client-side mod.
⬇ Download on Modrinth
ClientGuard
ClientGuard detects and removes players running blacklisted client-side mods. The detection is designed to be quick and mostly silent.
Ships with tested probes for Wurst, Meteor Client, Freecam, Baritone, XRay Mod, and PlayerESP. Additional probes can be added at any time via config or the /cg probe command.
How It Works
Every cheat client registers its keybindings under unique translation keys (e.g. key.wurst.zoom). When a player joins, ClientGuard silently places a hidden sign below them packed with those keys as translatable components, opens the sign editor on the client, and immediately closes it. The client echoes the sign back to the server — if any keys were resolved to readable labels (e.g. Zoom), the mod is present.
The entire exchange happens on the loading screen. Players only see a sign editor for a split second.
Features
- Warn system — optionally warn players on first detection before the action fires; warned state survives reconnects so players cannot relog to reset it
- Configurable actions — run any console command on detection, including commands from other plugins (ban, tempban, etc.)
- Per-probe overrides — set a different action or toggling warnings for individual probes
- Auto re-scan — periodically re-scan all online players on a configurable interval
- Scan on join with a configurable delay to handle high-latency connections
- Manual scan with
/cg scan <player>or/cg scan-allfor the whole server - Scan cooldown to prevent staff from spamming scans on the same player
- Bypass detection — alerts staff when a player's client doesn't respond to the scan
- Detection sound — plays an alert sound to online staff when a dissallowed mod is found
- Exempt permission — trusted staff or builders can be excluded from scanning entirely
- Detection history — every scan result is logged and viewable with
/cg history <player> - Live config — toggle any setting or manage probes in-game without a restart
- Suppression — optional blindness + slowness applied during the scan window (fully configurable)
- No dependencies — runs on any Paper 1.21+ server out of the box
Commands
| Command | Description |
|---|---|
/cg scan <player> |
Manually scan a player |
/cg scan-all |
Scan every online player at once |
/cg history <player> |
View a player's detection log |
/cg history clear <player> |
Wipe a player's history |
/cg status |
Show current plugin status and config |
/cg set <flag> <value> |
Toggle any detection flag live |
/cg probe <list/add/remove/toggle> |
Manage detection probes |
/cg reload |
Reload config.yml |
Notes
There is a bug where you can get stuck with blindness and slowness if you choose to enable this option when doing a scan. I'll try to fix this and also update to 26.1 if I find a chance.
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 1.21.1, 1.21.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as ClientGuard-2.0.0.jar — drop this file into the mods folder
- Download size: 4.6 MB
- Download link checked 30 Aug 2026 — working
These come from our own check of the pack file, not from the source page.