GuardAC is a server-side plugin whose aim check is powered by the GuardAC API. The plugin observes gameplay, requests a verdict from the service, and handles alerts, violation tracking and punishments on its own. It is built to stay conservative: an alert-only mode lets you evaluate accuracy on your own server before enabling any automatic action.
Additional capabilities include cross-server reputation sharing, configurable punishments with optional animations, a live suspect view, and clean handling of edge cases such as lag, teleports and reconnects.
- Java 17 or newer to run the plugin
- JDK 21 or newer to build from source
- Spigot, Paper, Purpur or Folia - Minecraft 1.16 and newer
- A GuardAC API key if the aim check is enabled
No extra plugins are needed: the packet layer ships inside the jar.
-
Download the latest release from the Releases page.
-
Place
GuardAC-<version>.jarin your server'splugins/directory. -
Start the server once to generate the configuration files.
-
In
plugins/GuardAC/config.yml, set your service address and key:ai: server: "https://guardac.net" api-key: "your-key-here"
Keys are available at https://guardac.net. If you do not have access yet, set
ai.enabled: falseto run the plugin without the aim check. -
Restart the server, or run
/guard reload.
Bedrock players connecting through Geyser are excluded automatically, and specific WorldGuard regions can be excluded via the configuration.
| File | Purpose |
|---|---|
config.yml |
Service connection, alerts, combat handling, cross-server reputation |
monitor.yml |
Layout of the live monitor output |
hologram.yml |
Suspect hologram display |
punishments.yml |
Punishment ladder and animations |
messages/messages_<lang>.yml |
Plugin messages - English, Russian, Kazakh, Vietnamese and Turkish ship with the jar |
| Command | Description |
|---|---|
/guard monitor |
Follow live check output |
/guard menu |
Live combat feed - who is fighting right now |
/guard profile <player> |
Show a player's current profile |
/guard punish <player> [animation] |
Apply the top punishment manually |
/guard reset <player> |
Clear a player's violations, buffer and alert streak |
/guard results <player> |
Recent AI results for a player |
/guard history [player] |
When and why players were punished |
/guard log [player] |
Recent violations |
/guard stats [1h|6h|24h|7d] |
Server-side statistics |
/guard top [1h|6h|24h|7d] |
Most suspicious players |
/guard exempt <player> |
Exempt a player from checks |
/guard alerts |
Toggle alerts for yourself |
/guard health |
Anti-cheat self-diagnostic |
/guard version |
Plugin version and build stamp |
/guard reload |
Reload the configuration |
The complete list is available in game via /guard help. Every subcommand has
its own permission node, guardac.command.<name>; guardac.admin grants all of
them.
If PlaceholderAPI is installed, GuardAC registers its own expansion
automatically - no download, no /papi ecloud step.
| Placeholder | Value |
|---|---|
%guardac_status% |
clean, watched, flagged or exempt |
%guardac_vl% |
Current violation level |
%guardac_buffer% |
Current suspicion buffer |
%guardac_probability% |
Latest verdict, in percent |
%guardac_average% |
Average of the recent verdicts, in percent |
%guardac_peak% |
Highest verdict this session, in percent |
%guardac_detections% |
Detections for this player this session |
%guardac_exempt% |
yes or no |
%guardac_tracked% |
Players currently tracked |
%guardac_suspicious% |
Players currently above the watch threshold |
%guardac_detections_today% |
Detections on this server today |
%guardac_checks_today% |
Checks performed on this server today |
%guardac_backend% |
online, degraded or off |
%guardac_mode% |
enforcing or alert-only |
%guardac_version% |
Plugin version |
%guardac_build% |
Build stamp of the running jar |
The first nine are per-player and resolve for the player they are requested for; the rest describe the server.
git clone https://github.com/PalassCQ/GuardAC.git
cd GuardAC
./gradlew buildThe compiled plugin is written to build/libs/GuardAC-<version>.jar.
- Bug reports: GitHub Issues
- Community and help: https://guardac.net
When reporting a bug, please include your server and Java versions, the plugin version, the relevant configuration values, and any logs or stack traces.
The released jar bundles these libraries:
- PacketEvents (GPL-3.0)
- Adventure (MIT), pulled in by PacketEvents
- Jackson (Apache-2.0)
- sqlite-jdbc (Apache-2.0)
- Kotlin standard library (Apache-2.0)
GuardAC is distributed under the terms of the GNU General Public License v3.0. See the LICENSE file for details.