Skip to content

Repository files navigation

React

Античит только под aim, для Paper и Folia. С опциональным слоем AI-вердиктов.

Java Paper Folia License AI Server


English version

Что это

React делает одну вещь: смотрит, как игрок целится, и решает, мог ли человек выдать именно такую траекторию.

Здесь нет проверок на брейки блоков, нет инвентарных чеков, нет пятнадцати модулей "для комплексности", которые никак не связаны друг с другом. Каждая проверка в этом репозитории отвечает на один вопрос: физически ли правдоподобен паттерн вращения. Дельты ускорения, GCD-ошибка, квантованное сравнение ротаций вместо статичных порогов, которые ломаются от первой же смены чувствительности мыши.

Сам плагин бесплатный и распространяется под MIT. Запускаете как есть и получаете рабочий эвристический пайплайн из коробки. Нужно второе мнение — подключаете AI Verdict Server: отдельный сервис, который принимает выборки ротаций, прогоняет через модель и возвращает уверенность в вердикте. Эта часть платная и работает как хостинг. Но она не привязывает вас намертво: свою модель, свой инференс-эндпоинт, свои пороги подставить можно, React не диктует, чья именно AI должна стоять за плечом.


Как устроена детекция

  • Эвристический слой (open source, локально). Все проверки крутятся на сервере в реальном времени, без внешних запросов. Сравнение по GCD, отслеживание дельт ускорения и усреднённая по режимам квантизация ротаций пришли на смену старому попарному GCD-подходу — тот сыпал ложными срабатываниями каждый раз, когда частота опроса мыши игрока не попадала аккуратно в тиковые границы игры.
  • AI-слой (хостинг, опционально). История ротаций пакуется и уходит на сервер вердиктов, тот возвращает оценку и уверенность. Размер батча, окно выборки и порог уверенности настраиваются — вы сами решаете, сколько веса дать мнению AI против эвристики.
  • Вердикт, не бан-молот. React выдаёт оценку и цепочку рассуждения. Что делать с помеченным игроком — мут, кик, бан, тихий лог — решаете вы, плагин это не зашивает в код.

Почему не просто больше порогов

Большинство чеков в стиле GrimAC ломаются одинаково: жёсткий порог, откалиброванный под один клиент, одну чувствительность и один FPS-кап, разваливается везде за пределами этой комбинации. Эвристический слой React пересобран вокруг усреднённого по режимам квантового сравнения вместо цепочки попарных GCD-вычислений — конкретно затем, чтобы убить нестабильность, ложные срабатывания от квантования и протечку NaN, которыми страдают наивные GCD-проверки аима. AI-слой закрывает то, что эвристика структурно не видит: паттерны, легальные по отдельности, но нечеловеческие в сумме.


Бесплатно vs платно

Плагин (ядро) AI Verdict Server
Лицензия MIT, open source Платный хостинг
Где работает На вашем сервере В облаке или у вас, со своей моделью
Что делает Эвристические проверки аима, конфиг, алерты Вердикты по паттернам ротации через ML
Обязателен? Да Нет — плагин полностью самодостаточен без него

Поддерживаемые платформы

Платформа Версия Java
Paper 1.16.5+ 17+
Folia 1.20.6+ 21+

Структура проекта

Модуль Описание
common Общая логика проверок, процессоры, утилиты
paper Реализация под Paper
folia Реализация под Folia

Возможности

  • Анализ аима на GCD-ошибке и дельтах ускорения
  • Усреднённое по режимам квантовое сравнение ротаций, без попарной цепочки GCD
  • Накопление нарушений сериями, с затуханием
  • Опциональный AI-слой вердиктов: хостинг или своя модель
  • Полностью асинхронно, минимум аллокаций, под Java 21
  • Пороги настраиваются per-check, без пересборки ради тюнинга чувствительности
  • Алерты на Adventure с фильтрацией по правам

Сборка

Нужны: Java 21+, Gradle 9+

./gradlew build

AI Verdict Server

AI-сервер — отдельный компонент, не часть этого репозитория, за деталями настройки в его собственную документацию. Он принимает выборки ротаций через простой endpoint и отдаёт объект вердикта: оценку, уверенность, теги причин. Можно подключить хостинг провайдера, а можно поднять свою модель за тем же API-контрактом.

Контрибьюция

Issues и PR приветствуются. Прежде чем лезть в архитектуру — заведите issue, сэкономит переделку и вам, и мне.

Лицензия

Плагин React распространяется под MIT — см. LICENSE. AI Verdict Server — отдельный платный сервис, под эту лицензию не подпадает.

About

AI-powered Minecraft anti-cheat focused on aim assistance detection using deterministic heuristics and cloud-based behavioral inference. Supports custom ML models through configurable inference endpoints.

Topics

Resources

Code of conduct

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages