🛡️ ACManager

The Intelligent Review & Correlation Layer for Anti-Cheats

ACManager works best with Vulcan Anti-Cheat, and also supports other popular anti-cheats via reflective hooks when present.

---

⚡ The Problem

Anti-cheats are excellent at detecting patterns — but they lack context.

• They spam staff chat with raw alerts
• They don’t explain why a player flagged (lag? sprinting? item in hand?)
• Staff burn out, alerts get ignored, and cheaters slip through

---

🚀 The Solution

ACManager sits between your anti-cheat(s) and your staff.

It silently collects alerts, correlates checks (for example: Speed + KillAura within 30 seconds), and calculates a Confidence Score (0–100%) so staff only review high-signal suspects.

Less noise. Better decisions.

---

🔥 Key Features

🔌 Multi Anti-Cheat Support

• Native Vulcan integration
• Reflective hook support for:
  • GrimAC
  • Matrix
  • Negativity
  • Other compatible anti-cheats
• Hooks are automatically detected and configurable via config.yml

---

🧠 Confidence Engine

A weighted scoring system that analyzes:

• Violation Frequency – how fast are flags happening?
• Check Variety – multiple checks or just one?
• Ping & TPS Stability – lag vs real cheats

Results in a clear 0–100% confidence score.

---

📋 Staff Review GUI

Run /acreview to open the live suspects menu.

• Heads Display – see high-confidence players instantly
• Color-Coded – red (high priority), yellow (low priority)
• One-Click Actions
  • Left-click: teleport / spectate
  • Right-click: dismiss

Includes pagination and live updates while the GUI is open.

---

💬 Discord Integration

Send high-confidence alerts straight to Discord.

• Clean embeds with:
  • Player name
  • Check type
  • Confidence %
  • Ping
• Fully configurable confidence thresholds to prevent spam

---

💾 Performance-First Database

Designed to be invisible to your TPS.

• Asynchronous batched writes
• Logs buffered in memory
• Saves every 10 seconds (configurable)
• Handles mass cheating with zero TPS impact

---

🔍 Contextual Logging

Stores information most anti-cheats don’t provide:

• Held item
• Sprinting / gamemode state
• Player ping
• Exact violation location

---

📥 Installation

1. Download ACManager.jar
2. Install dependencies:
   • PacketEvents
   • Vulcan Anti-Cheat (recommended)
3. Place the jar in your /plugins folder
4. Restart the server
5. (Optional) Configure plugins/ACManager/config.yml
6. Run /acreload

⚠️ Vulcan provides the deepest integration, but ACManager can also aggregate data from other supported anti-cheats when detected.

---

⚙️ Configuration

discord-webhook-url: "INSERT_WEBHOOK_URL_HERE"
discord-min-confidence: 85.0

db-save-interval: 10

alert-expiry-minutes: 5
review-min-confidence: 80.0

⌨️ Commands & Permissions

Command	Permission	Description
/acreview	acmanager.review	Opens the staff suspect review GUI
/acreload	acmanager.admin	Reloads config and webhook settings
/actest	acmanager.admin	Generates fake alerts for testing