download Установка

OculusAI — это плагин для Paper.

Требования

• Paper (или форк Paper) на Minecraft 1.16+.
• ProtocolLib — обязательная зависимость.
• Запущенный сервис OculusAI и API-ключ.

Установка

1. Скачай jar плагина со страницы релизов.
2. Кинь его в plugins/ вместе с ProtocolLib.
3. Запусти сервер один раз, затем открой plugins/OculusAI/config.yml.
4. Укажи api.url в конфиге.
5. Напиши /oai connect на сервере и открой выданную ссылку под своим аккаунтом. Ключ и IP сервера пропишутся сами.
6. Руками: вставь ключ в api.key, а IP сервера впиши во вкладке Настройки. Без адреса ключ не работает и анализа нет.
7. Выполни /oai reload, а в игре — /oai guide.

Состояние сервиса, включая прошлые сбои, открыто на странице Статистика.

tune Настройка

Всё лежит в plugins/OculusAI/config.yml. Главное:

api

api:
  url: ""        # адрес сервиса, например https://твойсайт.example
  key: ""        # API-ключ твоего сервера
  timeout-ms: 1500

analysis

Как нарезаются и оцениваются боевые окна.

analysis:
  window-ticks: 20
  min-attacks: 1
  combat-ticks: 40
  min-rotation: 5.0

buffer

Подозрение копится в буфер; пороги решают — алерт или наказание.

buffer:
  suspicion: 0.5
  gain: 1.5
  decay: 1.4
  max: 10.0
  alert-at: 1.7
  punish-at: 5.0

punishment

punishment:
  enabled: true
  command: "kick %player% &cUnfair aim"
  kick-animation: "EXPLODE"

Держи enabled: false, пока сам не убедишься, что модель права на твоём сервере.

terminal Команды

Команда — /oai (алиасы /oculusai, /ai). Полный список: /oai help.

С чего начать

Команда	Что делает
/oai connect	Привязать сервер к аккаунту одной ссылкой.
/oai guide	Как пользоваться античитом, в один экран.
/oai monitor	Живой список подозрительных. Красная точка — за порогом наказания.
/oai npc	Заспавнить манекен и проверить на себе.
/oai diag [игрок]	Почему окна игрока анализируются или нет.

Наблюдение и действия

Команда	Что делает
/oai prob <игрок>	Следить за аимом игрока в реальном времени.
/oai history <игрок>	Прошлые показания, хранятся на диске и переживают рестарт.
/oai player <игрок>	Буфер и история игрока.
/oai journal	Живой журнал подозрений.
/oai forget <игрок>	Сбросить подозрение игрока.
/oai vanish	Скрытое наблюдение в спектаторе.

Обучающие данные

Команда	Что делает
/oai data add cheater|legit <игрок>	Записать игрока для записи.
/oai data train	Начать запись (окна берутся, пока он дерётся).
/oai data stop	Остановить и отправить записи в сервис.
/oai data list	Показать текущий ростер.

Запиши обе метки, потом обучи модель в /oai dashboard.

key Права

Выдавай через LuckPerms или любой другой плагин прав.

Право	Зачем
oculusai.command	Использовать /oai.
oculusai.alerts	Получать алерты и смотреть чтения.
oculusai.journal	Открывать журнал подозрений.
oculusai.vanish	Скрытое наблюдение.
oculusai.data	Записывать и метить обучающие данные.
oculusai.npc	Спавнить тренировочных болванчиков.
oculusai.connect	Команда /oai connect (по умолчанию у оператора).
oculusai.diag	Команда /oai diag (по умолчанию у оператора).
oculusai.bypass	Никогда не анализироваться. Осторожно с вайлдкардами: группа стаффа с * получает и это право, и такие игроки перестают проверяться вообще.

sell Тарифы и квоты

Каждый тариф ограничен дневной квотой запросов, считается за скользящие 24 часа. Pro можно взять бесплатно на три дня, один раз на аккаунт — кнопка на карточке Pro.

Тариф	Запросов / день	Закрепление модели
Free	400	—
Starter	5 000	—
Pro	60 000	да
Unlimited	безлимит	да

IP сервера привязывается к ключу во вкладке Настройки панели. Ключ без адреса не работает нигде, так что это обязательный шаг, а не опция. Порт игнорируется — сервис всегда проверяет только IP сервера, — а менять адрес можно раз в 2 часа.

badge Ключ и панель

У аккаунта один API-ключ. Ключ — это то, что шлёт плагин: он хранит твой тариф, разрешённый адрес сервера и переключатели того, что плагину позволено делать.

• Использование — дневная квота и когда она сбросится.
• Ключи — пауза предикта, закрепление версии модели.
• Настройки — указать единственный IP, с которого разрешён этот ключ.
• Исключения AI — миры и регионы WorldGuard, которые модель должна игнорировать.
• Настройки — вебхук Discord: кики, алерты и жалобы дублируются в один канал.

Строка ключа не меняется при смене тарифа, так что в config.yml ничего править не нужно.

Что отвечает сервис, когда что-то не так

Код	Значение
001	Запрос пришёл с адреса, который этот ключ не разрешает.
002	У ключа ещё не указан IP сервера.
008	Дневная квота тарифа израсходована; плагин отступает и повторит позже.
009	Аккаунт забанен.
010	Адрес заблокирован оператором.