AI-admin (АИ админ)

Плагин для серверов Майнкрафт с ИИ-чатом, инструментами модерации и анализом подозрительного поведения игроков. Он собирает сигналы античита и действий на сервере, показывает доказательства персоналу и помогает управлять проверками, ботами и наказаниями.

Возможности

• Игрок может задать личный вопрос ИИ командой ai <текст>, а Smart AI отвечает в общем чате при обращении через @ad или @admin.
• ИИ хранит краткую историю диалога, учитывает задержку между запросами, лимит символов, очередь и повторяющиеся вопросы.
• Для ИИ поддерживаются OpenAI, OpenRouter, Gemini, Groq и DeepSeek, а также несколько ключей API.
• ИИ выполняет только команды из белого списка и проверяет права игрока, от имени которого запускается действие.
• Система подозрений учитывает предупреждения античита, консоль, бой, передвижение, строительство, добычу, Xray и наблюдение камерой. Для каждого сигнала сохраняются время, тип, подробности и координаты.
• Анализируются CPS, дистанция удара, KillAura, CrystalAura, необычное использование тотема бессмертия, полёт, скорость, NoFall, отбрасывание, Scaffold, схемы мостов, добыча скрытых и редких руд, взаимодействия сквозь блоки, спам и запрещённые слова.
• Очки подозрений постепенно снижаются без новых доказательств. Для игроков в творческом режиме или наблюдении, после телепортации и получения ускорения, а также при высоком пинге или лагах действуют послабления.
• В GUI доступны профиль игрока, доказательства, история, сведения об альтернативных аккаунтах и IP, рекомендуемые действия, панель сканирования и активные камеры.
• Наблюдение /ai watch <игрок> on создаёт отдельную камеру вокруг цели; для одного игрока может работать до трёх камер. Персонал может телепортироваться к камере.
• Можно создавать защищённых от урона ботов-манекенов, задавать им внешность, поворот головы, следование, ходьбу, прыжки, самостоятельное исследование и маршруты патруля.
• Дополнительный Protective Layer при входе просит игрока ввести случайное ключевое слово в заданном порядке. Режимы always, time и none определяют частоту или отключение проверки.

Команды

• ai <текст> — личный чат с ИИ.
• /ai help — список доступных команд.
• /ai scan — сканирование сервера; /ai dashboard — панель подозрительных игроков.
• /ai check <игрок> — GUI проверки; /ai explain <игрок> — разбор доказательств и временной шкалы; /ai sus <игрок> — очки подозрений.
• /ai watch <игрок> on|off|mute — начать, остановить наблюдение или исключить игрока из автоматических проверок.
• /ai kick <игрок> [причина], /ai termban <игрок> <причина> <время>, /ai ban <игрок> [причина] — кик и блокировки. Время временной блокировки задаётся, например, как 30m, 12h или 3d.
• /ai camera list, /ai camera dashboard, /ai camera tp <игрок:номер> — управление камерами.
• /ai createbot "<имя>" <id> [female|male], /ai choosebot <id>, /ai bot setup <ключ> <значение> — создание и настройка ботов.
• /ai reload — перезагрузка конфигурации; /ai optimize — анализ состояния сервера; /ai tokens [all|api_key1|api_key2|api_key3] — учтённый расход токенов.
• /ai smartmode on|off|status — управление Smart AI.
• /ai set max-players-per-scan <значение>, /ai set time-scan <значение>, /ai set suspicion <watch|alert|danger|severe> <значение> — параметры сканирования и пороги подозрений.

Права

• aiadmin.use — сканирование, панели и список разрешённых ИИ-команд.
• aiadmin.staff — проверки, наблюдение, камеры, боты, наказания и Smart AI.
• aiadmin.admin — полный доступ, включая /ai set.
• aiadmin.command.* — все разрешённые для ИИ действия.

Список команд, которые ИИ может выполнять для обычных игроков и персонала, задаётся в permission/member.yml и permission/admin.yml. Помимо записи в этом списке игроку требуется соответствующее право команды.

Настройка

Основные параметры находятся в следующих файлах:

• Source/config.yml — Protective Layer, API ИИ, сканирование, подозрения, наказания, база данных и webhook.
• Source/ai_chat.yml — имя и формат чата ИИ, Smart AI, память и инструкции.
• Source/option.yml — пороги детекторов и данные античита.
• Source/bot.yml — боты, камеры, поведение и патрули.
• Source/learning.yml — данные выводов персонала.
• Source/message.yml — сообщения, помощь и текст интерфейсов.

Проверки Protective Layer хранятся по UUID в Data/protective_layer.yml. Для настоящего ИИ-чата нужен настроенный ключ API; текст запросов и инструкции отправляются выбранному поставщику ИИ.

Требования

PlaceholderAPI добавляет плейсхолдеры статистики, например %aiadmin_sustime%, %aiadmin_report%, %aiadmin_kick% и %aiadmin_check%.

LiteBans используется для блокировок при наличии; без него применяется внутренний механизм AI_ban. Поддерживаются интеграции с TAB, ZNPCs или ZNPCsPlus, MySQL, Discord webhook и Velocity при корректной передаче реального адреса игрока. Для более точных сигналов плагин рассчитан на совместную работу со специализированным античитом.