Client Guard

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

- No dependencies — players have no idea a scan is running - No dependencies — warn players on first detection before the action fires; warned state survives reconnects so players cannot relog to reset it - No dependencies — run any console command on detection, including commands from other plugins (ban, tempban, etc.) - No dependencies — set a different action or toggling warnings for individual probes - No dependencies — periodically re-scan all online players on a configurable interval - No dependencies with a configurable delay to handle high-latency connections - No dependencies with `/cg scan <player>` or `/cg scan-all` for the whole server - No dependencies to prevent staff from spamming scans on the same player - No dependencies — alerts staff when a player's client doesn't respond to the scan - No dependencies — plays an alert sound to online staff when a dissallowed mod is found - No dependencies — trusted staff or builders can be excluded from scanning entirely - No dependencies — every scan result is logged and viewable with `/cg history <player>` - No dependencies — toggle any setting or manage probes in-game without a restart - No dependencies — 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 |