Вики

ZahAC — античит на машинном обучении для серверов Minecraft. Плагин записывает повороты головы (углы и их изменения), отметки ударов и замахов и время между ударами, собирает окно 32×7 и отправляет в нейросеть. Модель возвращает вероятность чита: например, «KillAura, 91%».

Каждая проверка — это обращение к API. Запас SU зависит от тарифа: у Free — 45 000 SU в сутки (сброс ежедневно в 00:00 по МСК).

Модель Sylnora AI одна для всех тарифов. Тарифы отличаются суточным лимитом SU и числом серверов: Free — 45 000 SU и 2 сервера, Core — 100 000 и 3, Neural — 300 000 и 10, Apex — без лимита SU и 20 серверов.

Что видит персонал: алерты в чат, монитор, голограммы над подозрительными и меню с досье. Всё настраивается в пресете на сайте.

Требования: Paper или Folia 1.21–1.21.11, Java 21. Spigot и Minecraft ниже 1.21 не поддерживаются. Голограммы на Folia работают: TextDisplay создаётся и обновляется через планировщик сущностей (проверено по коду; на живом сервере не проверяли).

1. Скачайте из панели из панели из панели ZxcAntiHvH-1.3.jar и положите в папку plugins/ сервера.

2. Запустите сервер один раз — плагин создаст plugins/ZxcAntiHvH/config.yml.

3. Откройте панель ZahAC → Серверы → добавьте сервер и выпустите API-ключ.

4. Впишите ключ в config.yml в блок detection (параметр api-key):

api-key: "zah_live_…"

5. Перезапустите сервер или выполните /zah reload, затем проверьте связь командой /zah status. В консоли появится «Пресет загружен с сайта».

В config.yml остаётся только имя пресета: модели, пороги, буфер, наказания, подавление, голограммы и сообщения настраиваются на сайте и подтягиваются без перезапуска.

Ключ выпускается в панели: Серверы → карточка сервера → «Выпустить ключ». Один ключ привязан к одному серверу: статистика и дневные лимиты не смешиваются.

Сырой ключ показывается один раз — скопируйте его сразу. В базе хранится только SHA-256 хэш, восстановить ключ невозможно, можно только выпустить новый.

Статус «плагин на связи» загорается, когда плагин пингует API. Если точка погасла — проверьте ключ и адрес API в config.yml.

Сброс ключа: «Отозвать» в карточке сервера. Старый ключ перестаёт работать сразу, выпустите новый и впишите его в config.yml.

Откройте Конфиги и выберите пресет. Разделы: «Основное», «Сообщения», «Регионы/Миры», «Модели», «Детекция», «Подавление», «Персонал».

Изменения сохраняются автоматически и приезжают на сервер в течение минуты — или сразу после /zah reload.

Пресетов может быть несколько: например, main для выживания и pvp для арены. Сервер берёт тот, который указан в его карточке в разделе Серверы.

Удалили пресет — серверы с ним вернутся к встроенным настройкам, а админы увидят предупреждение в игре.

Astra (Free): 45 000 SU в сутки и 2 сервера; модель и проверки — как на остальных тарифах.

Aether (Core): 100 000 SU в сутки и 3 сервера; проверки те же.

Vortex (Neural): 300 000 SU в сутки и 10 серверов; проверки те же.

Omnix (Apex): без суточного лимита SU и 20 серверов; проверки те же.

В разделе «Модели» пресета включаются галочки, на карточках в Статистике видна доля проверок каждого уровня.

Над игроком видно, насколько модели уверены в читах. Метки видят только игроки с правом на уведомления.

Сами проверки подписываются названием модели: Astra или Nano. Сколько их показывать, задаёт «История» (по умолчанию 5).

В пресете настраиваются: строки метки, формат проверки для каждой модели, пороги цвета «средний/высокий», «Видно с», «Высота», «Показывать без проверок» и 3D-режим (фон, тень, видно сквозь стены, масштаб, поворот к игроку).

В редакторе есть живое превью: правите строку — и сразу видите, как метка будет выглядеть в игре, с цветами &a, &l и HEX &#RRGGBB.

У игрока в наблюдателе метки нет. На Folia голограммы работают: TextDisplay через планировщик сущностей (проверено по коду, на живом сервере не проверяли).

Алерты летят в чат персонала и в консоль. Формат каждой строки задаётся в разделе «Сообщения» — там же живое превью чата.

Монитор в action bar показывает шанс чита ближайшего игрока над хотбаром — включается в разделе «Персонал».

Досье игрока: история проверок, средний и максимальный шанс, кики и баны. Открывается через меню персонала.

Совет: посмотрите, сколько было детектов и на какой модели. Одна вспышка и десятки проверок за дни выглядят совсем по-разному.

В разделе «Регионы» пресета можно перечислить миры и регионы WorldGuard, где проверки не работают и подавление не применяется: спавн, мини-игры, креатив.

Пустые списки — ограничений нет: проверяются все миры. Имена — по правилам Minecraft: латиница, цифры, - и _.

У каждой детекции свой вес. Сумма — VL игрока. При достижении порога шага срабатывает наказание: команда, кик, бан или срез урона.

Команды поздних этапов выполнятся в своё время, даже если игрок вышел. Сбежать от отложенного бана выходом не получится.

Выполняются только команды наказаний: ванильные ban, ban-ip, kick, pardon, бан, мут, кик, варн, джейл и разбан из LiteBans, AdvancedBan, BanManager, Essentials, CMI, LibertyBans и MaxBans, а также команды ZahAC и broadcast. Всё остальное — только если вы сами разрешили это в config.yml.

Пример с нашего тестового сервера: «Got VL 13», потом «Suppression (Flag 13, stage 1/1): cmd ban», и игрок улетает в бан с анимацией.

В плагине три встроенные анимации: Classic (по умолчанию — вспышка и звук), Dramatic (затемнение и гром) и Rainbow (разноцветные частицы).

В пресете, раздел «Детекция», у шага с баном выберите анимацию в списке — там описание каждой. Свои анимации добавить нельзя, только встроенные.

/zah animation list покажет установленные, /zah animation reload перезагрузит их.

Сделали /zah reload прямо во время анимации? Бан не выполнится, а игрок получит вещи обратно и разморозится.

Вместо мгновенного бана модель сначала снижает урон читеру. Окно — за сколько секунд считать детекции; ступени — «сколько детекций → на сколько процентов срезать урон и на сколько секунд».

Пример по умолчанию: 3 детекции за 10 секунд → урон −30% на 8 секунд; 6 детекций → −60% на 15 секунд; 10 → −90% на 30 секунд.

Игроку в чат приходит сообщение «Урон снижен на N%» — текст настраивается в разделе «Сообщения».

Каждый сервер — карточка в разделе Серверы: статус, версия и ядро, проверки за всё время, запросы за сегодня и последний пинг плагина.

Зелёная точка значит, что плагин на связи: он пингует API и подтягивает пресет.

В карточке: выпуск и отзыв API-ключа, привязка пресета, удаление сервера вместе с историей.

На «Обзоре» — счётчики и лента последних проверок. В Статистике — динамика по дням, разбивка по типам наказаний и по моделям.

Средний шанс чита по всем проверкам показывает, насколько горячий у вас сервер: зелёный — до 60%, жёлтый — до 90%, красный — выше.

/zah status — статус плагина, API и моделей. Право: zahac.staff.

/zah reload — перезагрузить пресет с сайта. Право: zahac.admin.

/zah menu — меню персонала: игроки, проверки, кики. Право: zahac.staff.

/zah profile <игрок> — досье игрока. Право: zahac.staff.

/zah check <игрок> — принудительная проверка. Право: zahac.staff.

/zah punish <игрок> — выдать максимальное наказание из лестницы. Право: zahac.admin.

/zah animation list | reload — анимации бана. Право: zahac.admin.

/zah data save | restore <игрок> — инструменты персонала (плагин 2.0.4+). Право: zahac.admin.

В config.yml только связь с панелью: api-key, api-url, имя пресета и адреса основного и запасного API.

Модели, порог, буфер, наказания, подавление, голограммы, сообщения — всё это в пресете на сайте.

Там же можно разрешить дополнительные команды для лестницы наказаний (по умолчанию — только команды наказаний).

Ядра: Paper, Folia. Версии: 1.21–1.21.11. Java 21+.

Плагины наказаний: LiteBans, AdvancedBan, BanManager, Essentials, CMI, LibertyBans, MaxBans.

Ограничения: на Folia не работают голограммы; у игрока в наблюдателе метки нет.