ACManager 🛡️

The intelligent review & control layer for your Anti-Cheat.

ACManager is not an anti-cheat. It is the missing control and review layer that anti-cheats don’t provide.

Originally designed for Vulcan Anti-Cheat, ACManager aggregates, correlates, and scores violation data from your anti-cheat(s), turning noisy alerts into clear, actionable intelligence for your staff.

Vulcan is fully supported, with additional support for other popular anti-cheats via reflective hooks.

🚀 Why use ACManager?

Raw anti-cheat alerts are noisy and lack context. Lag, ping spikes, or server TPS drops can easily produce false positives.

ACManager shifts the focus from catching cheaters to managing them. It correlates alerts over time, evaluates server conditions, and assigns a Confidence Score so your staff only reviews players that actually matter.

🔥 Key Features

🔌 Multi Anti-Cheat Support

Native Vulcan integration (deepest support)
Reflective hook support for:
- GrimAC
- Matrix
- Negativity
- Other compatible anti-cheats
Hooks are dynamically registered via config.yml
Vulcan is now a soft dependency — the plugin can start without it installed

🧠 Intelligent Confidence Engine

Instead of raw violation levels, ACManager calculates a 0–100% Confidence Score based on:

Check Correlation: Multiple cheats triggering together
Violation Frequency: How fast flags are occurring
Ping & TPS Stability: Automatically lowers confidence during lag

📋 Staff Review GUI

The /acreview command opens a visual suspect review menu:

Suspect Heads: Displays players with active confidence scores
Teleportation: Left-click to spectate a suspect
Dismissal: Right-click to clear a player
Pagination: Navigate large queues easily
Live Updates: Open GUIs refresh automatically in real time

📉 Confidence Decay System

Confidence scores now decay over time to prevent stale data:

Gradual confidence decay
Automatic removal below a configurable threshold
Fully configurable decay rate and interval

💬 Discord Webhooks

Stay informed even when offline. High-confidence alerts are sent to Discord with rich embeds including:

Player name & UUID
Check / cheat type
Confidence percentage
Ping and server TPS
Held item and player state

💾 High-Performance Database

Designed for large servers:

Asynchronous batched writes
Buffered in memory
Saves every 10 seconds (configurable)
Zero TPS impact, even during mass cheating

🛡️ Supported Anti-Cheats

ACManager is designed to work with multiple anti-cheats, aggregating and correlating their alerts into a single review system.

Vulcan Anti-Cheat – Native & deepest integration (recommended)
GrimAC – Supported via reflective hooks
Matrix Anti-Cheat – Supported via reflective hooks
Negativity – Supported via reflective hooks
Other Anti-Cheats – Partial support via configurable reflective hooks when compatible

Reflective hooks are automatically detected and can be enabled or disabled via config.yml. Vulcan is optional but provides the most complete data and feature set.

🛠️ Commands & Permissions

Command	Permission	Description
`/acreview`	`acmanager.review`	Opens the staff review GUI.
`/acreload`	`acmanager.admin`	Reloads configuration and webhooks.
`/actest`	`acmanager.admin`	Generates test alerts.

📥 Installation & Requirements

Requirements:

Java 21 (required for 1.21+)
PacketEvents
Vulcan Anti-Cheat (recommended for full integration)

Steps:

Download ACManager.jar
Place it into your /plugins folder
Restart the server
Edit plugins/ACManager/config.yml
Run /acreload

⚙️ Configuration

discord-webhook-url: "YOUR_URL" discord-min-confidence: 85.0 review-min-confidence: 80.0 db-save-interval: 10 alert-expiry-minutes: 5 review-decay-per-minute: 1.0 review-decay-interval-seconds: 60 review-decay-remove-below: 10.0