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.
ClientGuard
ClientGuard detects and removes players running blacklisted cheat clients — completely server-side, no client mod required. Vanilla players join without any issues. The detection is fully silent; players have no idea a check is happening.
Ships with tested probes for Wurst, Meteor Client, Freecam, Baritone, XRay Mod, SeedCrackerX, SeedCracker, CrystalCore, ChestESP, 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 never see a sign editor.
Features
- Silent detection — players have no idea a scan is running
- Warn system — 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 |
