OverWatch-ML

---

OverWatch-ML is a next-generation anti-cheat for Paper 1.21+ that combines classical heuristic analysis with trained Machine Learning models to catch what traditional anti-cheats miss.

Most anti-cheats look at individual packets. OverWatch-ML looks at behavior — building a persistent profile for every player and analyzing patterns across Combat, Movement, Xray, and World Interactions using dedicated ML models.

---

How It Works

At its core is a Detection Orchestrator — a centralized engine that weighs signals from internal ML analysis alongside data from external anti-cheats (Grim, Vulcan, Matrix, Spartan). No single flag triggers a punishment. The system reasons about the full picture.

Player Actions → Behavioral Profiler → ML Models → Orchestrator → Verdict
                                                 ↑
                                    External AC Scores (Grim, Vulcan...)

---

Features

🧠 Machine Learning Detection

Every player builds a persistent behavioral profile over time. CPS, movement speed, mining efficiency, and dozens of other signals are tracked continuously and fed into dedicated ML models for Combat, Movement, Xray, and World Interactions.

📡 Detection Orchestrator

A centralized "brain" that coordinates internal ML analysis with violation scores from external anti-cheats. Intelligent signal weighting means fewer false positives and smarter verdicts.

💻 Staff Control Panel

A fully GUI-driven management interface. Monitor flagged players, stream live behavioral data, and issue punishments — no config editing required.

🔔 Real-time Staff Alerts

Instant notifications with one-click teleportation to the suspect. Your staff acts fast, every time.

🛡️ Smart Mode Detection

Built-in bypass logic for Creative and Spectator mode players. Zero false positives from your own team.

⚡ Zero TPS Impact

All ML inference runs fully asynchronously on Java 21. Heavy computation never touches the main thread.

---

Integrations

OverWatch-ML is designed to complement your existing anti-cheat stack, not replace it.

---

Requirements

Requirement	Version
Server Software	Paper / Spigot 1.21+
Java	21 or newer
Dependency	ProtocolLib

---

Commands & Permissions

Command	Description
/owml	Open the Staff Control Panel
/owml player <name>	View a player's ML profile
/owml staff	Open staff management menu

Permission	Access
owml.staff	Staff menu and live alerts
owml.admin	Full configuration and ML system access

---

Compatibility

Minecraft Version	Status
1.21.x	✅ Fully Supported

---