Client Guard

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-all for 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

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.