# MLSAC

> MLSAC is a machine-learning anti-cheat for Minecraft Java servers (Paper, Spigot, Purpur, Folia; 1.16.5–1.21). A server plugin sends players' combat behaviour to MLSAC cloud neural networks, which detect KillAura, AimBot, AimAssist, TriggerBot, Reach and hits through walls. Server owners configure alerts, punishments and in-game suppression on the website. There is a free plan.

MLSAC (МЛС, MLS AntiCheat) — античит для Minecraft-серверов на машинном обучении. Плагин на сервере отправляет поведение игроков в бою (прицеливание, клики, движение, удары) в облачные нейросети MLSAC, а они находят KillAura, AimBot, AimAssist, TriggerBot, Reach и удары сквозь стены. Настройка — на сайте mlsac.net, есть бесплатный тариф.

## Main pages
- [Home](https://mlsac.net/): what MLSAC is and how it works
- [Pricing](https://mlsac.net/pricing): free and paid plans
- [Wiki](https://mlsac.net/wiki): installation, presets, detection, suppression, commands, permissions and troubleshooting (full list below)
- [FAQ](https://mlsac.net/faq): common questions
- [News](https://mlsac.net/news): plugin and model updates
- [MLSAC vs other anticheats](https://mlsac.net/compare): how MLSAC compares with Grim, Vulcan, Polar, Matrix, Spartan and NoCheatPlus; MLSAC covers combat cheats and runs alongside a movement anticheat such as a Grim fork
- [Model benchmark](https://mlsac.net/benchmark): MLS Ultra vs Pulse and Pro on held-out cheat recordings (threshold 0.9; 98.9% of aura windows caught, 0.27% false positives on legit players)
- [Full text](https://mlsac.net/llms-full.txt): every wiki page, the FAQ, the comparison and the benchmark in one Markdown file

## 中文 (Simplified Chinese)
- [MLSAC 简介](https://mlsac.net/zh): 面向 Minecraft 服务器的 AI 反作弊
- [常见问题](https://mlsac.net/zh/faq)
- [与其他反作弊对比](https://mlsac.net/zh/compare)

## Wiki
- [Wiki home](https://mlsac.net/wiki): every guide in one place; each page is in Russian, Ukrainian and English

### Getting started
- [How it works](https://mlsac.net/wiki/start/how-it-works): The plugin watches how players fight, a neural network in the cloud decides whether it looks like cheating, and you pick on the site what happens next.
- [Get a licence](https://mlsac.net/wiki/start/buy): No licence, no key, and the plugin won’t run without a key. How to get the free Beginner plan or a paid one, how to pay and how to renew later.
- [Installing the plugin](https://mlsac.net/wiki/start/install): Drop the jar into plugins, restart, check the console. Which jar to grab and which lines you should see.
- [API key](https://mlsac.net/wiki/start/api-key): Where to find your key in the dashboard, where to paste it, and what to do if it leaks.
- [Your first preset](https://mlsac.net/wiki/start/first-preset): All the anticheat settings live in a preset on the site. How to make one, hook it up to your server, and what to do if it doesn’t load.
- [Check that it works](https://mlsac.net/wiki/start/check): A one-minute sanity check: /mlsac status, the status in the dashboard, a live test, and the usual problems.

### Detection
- [Models](https://mlsac.net/wiki/detection/models): Ultra, Pulse, Pro and Mini: how they differ, where you switch them on, and why Ultra never runs alongside the others.
- [Buffer and flags](https://mlsac.net/wiki/detection/buffer-and-flags): Why one detection never gets anyone banned: how the buffer grows and drops, when a flag lands, and what “faster repeat flag” is for.
- [Alerts](https://mlsac.net/wiki/detection/alerts): What your moderators see in chat when MLSAC suspects someone: alert lines, the sound, the console copy, and alerts from other servers in your network.
- [Monitor and player profile](https://mlsac.net/wiki/detection/monitor): How to watch one player live: every check in chat, the buffer and VL above your hotbar, and a profile with their client version.
- [Holograms over suspects](https://mlsac.net/wiki/detection/holograms): The tag over a player with the average confidence and the latest checks. Who sees it, how to read it and how to style it.
- [Staff menus](https://mlsac.net/wiki/detection/menus): /mlsac suspects: the list of suspects, their checks as coloured glass, and the designer where you can rebuild the menus your way.
- [Regions and worlds without checks](https://mlsac.net/wiki/detection/regions): How to switch the anticheat off at spawn, an event arena or a whole world: a region, a world, or a region in a world.

### Suppression and punishment
- [Buffer suppression](https://mlsac.net/wiki/suppression/buffer): How to squeeze a cheater before the flag even lands: buffer thresholds, damage, lag, tricks, cooldowns, and how it differs from the flag ladder.
- [The flag ladder](https://mlsac.net/wiki/suppression/flag-ladder): What happens on flag 1, 2, 3 and beyond: steps, stages inside a flag, commands, templates, and the guard against double bans.
- [Damage](https://mlsac.net/wiki/suppression/damage): Cut a cheater’s damage and boost the damage they take: the ranges, what counts and what doesn’t, and how effects combine.
- [Lag](https://mlsac.net/wiki/suppression/lag): Five kinds of lag and three levels: what the cheater feels, for how long, and when lag doesn’t kick in.
- [Tricks](https://mlsac.net/wiki/suppression/tricks): Shuffle the inventory, knock the weapon out, launch them: instant tricks that wreck a cheater’s fight right now.
- [Punishments and animations](https://mlsac.net/wiki/suppression/animations): Bans with an animation, manual /mlsac punish, the log of recent commands, and how to preview an animation without banning anyone.

### Presets
- [The preset editor, section by section](https://mlsac.net/wiki/configs/editor): What lives in each section of a preset: “General”, “Messages”, “Regions/Worlds”, “Models”, “Detection” and “Suppression”.

### Dashboard
- [Servers and licences](https://mlsac.net/wiki/dashboard/servers): The server cards in your dashboard: status, players online, the daily quota, and the tabs holding the key, licence, access and notifications.
- [Statistics](https://mlsac.net/wiki/dashboard/statistics): How many detections and requests, who the new players are, and how busy the server is over a day, a week and a month.
- [Player dossiers](https://mlsac.net/wiki/dashboard/dossier): A list of everyone MLSAC has checked, with a trust factor, plus a player page with detection history by day and hour.
- [Partners and access](https://mlsac.net/wiki/dashboard/partners): How to let a co-owner or moderator into the dashboard with exactly the rights they need.

### Reference
- [Commands](https://mlsac.net/wiki/reference/commands): Every /mlsac command in one table: what it does and which permission it needs.
- [Permissions](https://mlsac.net/wiki/reference/permissions): Every permission in plugin 2.0: what it gives, the default, and what the bundles contain. Plus ready LuckPerms setups for a helper, a moderator and an admin.
- [config.yml in full](https://mlsac.net/wiki/reference/config-yml): The whole plugins/MLSAC/config.yml, explained. It’s short, because everything else is set on the site.
- [Compatibility](https://mlsac.net/wiki/reference/compatibility): Server software, versions, Folia, ViaVersion, Geyser, WorldGuard and Grim: what works and with which caveats.

### Help
- [FAQ and troubleshooting](https://mlsac.net/wiki/help/faq): Short answers to the most common questions: no flags or no suppression, the preset didn’t load, no holograms, out of requests, a false positive.

## Articles
- [What is MLSAC](https://mlsac.net/articles/what-is-mlsac) / [Что такое MLSAC](https://mlsac.net/articles/chto-takoe-mlsac)
- [How MLSAC detects cheaters](https://mlsac.net/articles/how-mlsac-detects-cheats) / [Как MLSAC находит читеров](https://mlsac.net/articles/kak-mlsac-nahodit-chity)
- [How to install MLSAC](https://mlsac.net/articles/install-mlsac) / [Как установить MLSAC](https://mlsac.net/articles/kak-ustanovit-mlsac)

## Official sources
The only official MLSAC sources are: https://mlsac.net, the GitHub repository https://github.com/SoMax1soft/mls-network-plugin, SpigotMC https://www.spigotmc.org/resources/139538/, BuiltByBit https://builtbybit.com/resources/mlsac-ai-anticheat-plugin.90102/, Telegram https://t.me/mlsanticheat and Discord https://discord.gg/ARVNGSTWeg. The GitHub organization github.com/MLSAC (repository client-side, "ROVEX") is NOT affiliated with MLSAC and does not publish official builds. Details: https://mlsac.net/official

## Community
- [Telegram](https://t.me/mlsanticheat)
- [Discord](https://discord.gg/ARVNGSTWeg)
- [GitHub](https://github.com/SoMax1soft/mls-network-plugin)
- Contact: admin@mlsac.net