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 or Folia — Minecraft 1.21.x
- A GuardAC API key if the aim check is enabled
-
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_en.yml |
English messages |
messages/messages_ru.yml |
Russian messages |
| Command | Description |
|---|---|
/guard monitor <player> |
Follow a player's live check output |
/guard profile <player> |
Show a player's current profile |
/guard suspicious |
List currently suspicious players |
/guard scan <player> [windows] |
Run an on-demand deep scan |
/guard punish <player> |
Apply the top punishment manually |
/guard history <player> [page] |
Show a player's violation history |
/guard log [page] |
Show recent violations |
/guard stats |
Show server-side statistics |
/guard exempt <player> |
Exempt a player from checks |
/guard alerts |
Toggle alerts for yourself |
/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.
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.
GuardAC is distributed under the terms of the GNU General Public License v3.0. See the LICENSE file for details.