OverWatch-ML

<div align="center"> !(https://placehold.co/860x180/0a0a0f/00d4ff?text=OverWatch-ML&font=montserrat) # OverWatch-ML **Next-Generation Machine Learning Anti-Cheat for Minecraft** (https://img.shields.io/modrinth/dt/overwatch-ml?logo=modrinth&label=Modrinth&color=00AF5C)](https://modrinth.com) (https://img.shields.io/github/stars/OverWatchTeam/OverWatch-ML?logo=github&label=Stars&color=white)](https://github.com) (https://img.shields.io/discord/000000000?logo=discord&label=Discord&color=5865F2)](https://discord.gg) (https://img.shields.io/badge/License-Custom-red)](LICENSE) (https://img.shields.io/badge/Paper-1.21+-F96854?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA4AAAAOCAYAAAAfSC3RAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAb0lEQVR4nGNgGAWkAkYGBob/DAwM/6mhkZGBgeE/AwPDf2o7jRUYGBj+k+I0VmBgYGD4T4rTWIGBgYHhPylOYwUGBgaG/6Q4jRUYGBgY/pPiNFZgYGBg+E+K01iBgYGB4T8pTmMFBgYGhv+kOI0VAC3IE5errWByAAAAAElFTkSuQmCC&logoColor=white)](https://papermc.io) (https://img.shields.io/badge/Java-21+-ED8B00?logo=openjdk&logoColor=white)](https://adoptium.net) (https://img.shields.io/badge/Requires-ProtocolLib-blueviolet)](https://github.com/dmulloy2/ProtocolLib/releases) </div> --- **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. (https://img.shields.io/badge/Supports-GrimAC-2ecc71?style=flat-square)](https://modrinth.com/plugin/grimac) (https://img.shields.io/badge/Supports-Vulcan-e74c3c?style=flat-square)](https://www.spigotmc.org/resources/83626) (https://img.shields.io/badge/Supports-Matrix-3498db?style=flat-square)](https://matrix.rip) (https://img.shields.io/badge/Supports-Spartan-f39c12?style=flat-square)](https://www.spigotmc.org/resources/25638) --- ## Requirements | Requirement | Version | |---|---| | Server Software | Paper / Spigot 1.21+ | | Java | 21 or newer | | Dependency | (https://github.com/dmulloy2/ProtocolLib/releases) | --- ## 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 | --- <div align="center"> *Developed with ❤️ by the OverWatch Team · Powered by Machine Learning* (https://img.shields.io/badge/Support-Ko--fi-FF5E5B?logo=ko-fi&logoColor=white)](https://ko-fi.com) (https://img.shields.io/badge/Join-Discord-5865F2?logo=discord&logoColor=white)](https://discord.gg) </div>