Configuration wiki

The key from your dashboard. Paste it in and the plugin works.

The GuardAC cloud address. No need to touch it.

true - staff get alerts, nobody is punished automatically. false - the punishment ladder from punishments.yml is live.

Keep it true for the first couple of days and just watch the alerts. Happy with the detections? Turn punishments on.

Language of every plugin message: en or ru.

This server's name - shown in your dashboard, in staff alerts and in cross-server messages. Give each server its own name (e.g. survival or bedwars-1). Empty = srv-<port>.

A hit alert only fires when the model is at least this confident.

One message per N suspicious hits (x3, x6, x9) so staff chat doesn't drown. A lone random spike stays silent.

Also print alerts to the server console.

The alert sound for staff. Any Bukkit sound name works; volume and pitch are configured right next to it.

A separate file with the punishment ladder by violation level (VL): VL1 just alerts, VL2 kicks with an animation, VL3+ ban. The "[ban] 30d reason" action bans through your ban system (LiteBans / AdvancedBan / vanilla) on any server; an "[animation]" line adds a show (delete it to remove); your own console commands work too.

Animations (pig, explosion, meteor, cage...) are set by an "[animation]" line in punishments.yml - by default on VL2 (kick) and on bans. Delete the line and that level has no show. The flag itself forces a random animation on every level at once; off by default.

Old violations slowly burn off, so a flag from long ago doesn't haunt a player forever.

The plugin remembers how a player normally moves the mouse and tells staff when the style shifts sharply mid-session: a cheat got toggled, or someone else is on the account. Never bans by itself.

Carefully weaken a suspect right in combat instead of an instant ban. Everything recovers on its own; off by default.

Bans issued from the web dashboard: the server picks the command up within a minute. Disable if you only moderate in-game.

Shared alerts between your servers on one key: a detection on one is shown to staff on all. No proxy needed.

Global reputation: if a player was caught on other GuardAC servers, you'll know when they join.

Skip phone/console players (Bedrock via Geyser) - their aim works differently.

The plugin downloads new versions from the official releases by itself and updates on server restart.