Aegis AC — Documentation
Paper 1.21.x only (or a fork: Purpur/Pufferfish). Java 21. Spigot is not supported.
[HR][/HR]
1. Installation
- Stop your server.
- Drop AegisAC.jar into the plugins/ folder.
- Get a license key (see below) and put it in plugins/AegisAC/license.key.
- Start the server. Aegis boots its packet pipeline and validates the key.
Note: Aegis will not enable without a valid key — this is by design.
2. Getting a key
- Free (Community): join our Discord and run /getkey. You get a free-forever key instantly (1 server).
- Pro (£10, 2 servers) / Network (£25, 5 servers): purchase at aegissec.uk.
Put the token (looks like
AEGIS-XXXX-XXXX-XXXX) into
plugins/AegisAC/license.key and restart.
3. The web panel
Manage your server from the browser — no port-forwarding, no IP to share.
- Create an account / log in at aegissec.uk.
- Claim your access token (the same one in license.key).
- Your server appears automatically once it's online with that key.
Panel pages: Dashboard, Players, Map, Alerts, Bans, Audit Log, Config (toggle checks, set thresholds, punishment, edit config.yml), Statistics, Monitoring, Sub-users, Download, Settings (2FA).
4. Commands
Base command
/aegis — aliases
/ac and
/aegisac.
| Command |
What it does |
| /ac alerts |
Toggle receiving cheat alerts in chat |
| /ac verbose |
Toggle the verbose (every-flag) feed |
| /ac info |
Plugin + license info |
| /ac vl <player> |
Show a player's current violation levels |
| /ac tp <player> |
Teleport to a player |
| /ac freeze <player> |
Freeze / unfreeze a suspect |
| /ac check <player> |
Invisibly spectate a player (run again to return) |
| /ac kick <player> [reason] |
Kick with a styled screen |
| /ac ban <player> [30m|2h|7d|perm] [reason] |
Ban (optional duration) |
| /ac unban <player> |
Remove a ban |
| /ac enable | disable |
Global anticheat on/off kill-switch |
| /ac reload |
Reload config.yml |
5. Permissions
| Permission |
Default |
Grants |
| aegis.command |
op |
Use /aegis |
| aegis.alerts |
op |
Receive cheat alerts |
| aegis.staff |
op |
freeze / check / kick / ban / unban / enable / disable |
| aegis.bypass |
false |
Skip ALL checks (trusted staff) |
| aegis.chat.bypass |
false |
Skip the chat-moderation filters |
6. Checks & thresholds
Every check has two violation-level thresholds:
- alert-vl — VL at which staff start getting alerts.
- max-vl — VL at which the punishment fires ("max detections").
Set both per-check live from the panel's
Config page (Alert / Punish fields), or in
config.yml:
Code (Text):
checks:
killaura:
enabled: true
alert-vl: 6
max-vl: 24