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 World Interactions, World Interactions, World Interactions, 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 World Interactions, World Interactions, World Interactions, 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.

GrimAC

Vulcan

Matrix

Spartan

---

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 |

---