Home›Java›Mods›ClientGuard - Mod Detection
ClientGuard - Mod Detection
ModsJava

ClientGuard - Mod Detection

Java mod listed for Minecraft 26.x. Downloads from the MC Java Mods app on Android.

⬇ Download on Spigot
ClientGuard helps staff identify client mods using the information Minecraft clients expose to the server.

Requires Paper or Purpur 26.2 and Java 25.

Features

• Detect supported clients and mods through client brands, network channels, reported mod lists and join resource checks.
• Review detected mods and available evidence through /cg.
• Allow or block joining with specific mods through config.yml.
• Warning and Critical mods are blocked by default.
• Blocked players receive a message naming the detected mods and asking them to disable them.
• Receive short staff alerts, with a personal notifications toggle.
• Review flagged players after they disconnect. Repeat joins with the same flags update the latest history entry.
• Send optional Discord notifications through a webhook or DiscordSRV.
• Download verified updates automatically and install them at the next server restart.

Installation

  1. Stop your server.

  2. Place ClientGuard.jar in the plugins folder.

  3. Start the server.

  4. Give your staff clientguard.staff.

  5. Open /cg.
Permissions

clientguard.staff — Access the staff GUI and receive notifications.
clientguard.bypass — Exempt from mod join restrictions. Detection records remain private to OPs.
clientguard.skip-probes — Skip join resource checks. Passive detection remains active.

Administration requires OP status. OP players are excluded from monitoring.

Configuration

Join restrictions are configured only in config.yml:

access-control.enabled — Enable or disable join restrictions.
access-control.mods.<rule-id>.allow-join — Allow or block a specific mod.

Use the rule IDs from rules.yml. Apply changes through Reload configuration in the OP menu or restart your server.

Discord is disabled by default. Configure your own destination before enabling it.

Detection limits

ClientGuard detects available signals, not every installed mod. Clients can hide information, and some Wurst and standalone Baritone builds are not reliably detected. A detected mod does not prove that a particular feature is enabled.

Some signals arrive after login. When a blocked mod is recognized, ClientGuard disconnects the player.

Downloads and updates

https://github.com/xDiamondBeerx/ClientGuard-Releases

Commands

Plugin details

Read from the plugin's own plugin.yml.

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

ClientGuard - Mod Detection is a free Minecraft Java mod. Compatible with Minecraft 26.2. Downloaded 18 times (via Spigot). Download it and open it directly in the game.

Explore more