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

📥 Installation & Requirements

Requirements:

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

Steps:

1. Download ACManager.jar
2. Place it into your /plugins folder
3. Restart the server
4. Edit plugins/ACManager/config.yml
5. 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