Solver (Солвер)

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

Возможности

• Анализирует отчёты о сбоях, ошибки запуска плагинов, исключения в консоли, зависания и падение TPS; объясняет возможную причину, например проблемный плагин, нехватку памяти или повреждённый чанк.
• Проверяет чат с учётом контекста беседы, а не только списка запрещённых слов. Для нарушения выводятся категория, серьёзность и уверенность ИИ; категории задаются в tags.yml.
• Для модерации можно выбрать уведомление персонала, личное предупреждение игроку либо автоматическое предупреждение, мут или кик. Автоматическое действие требует достаточной уверенности и серьёзности либо подтверждения фильтрами.
• Ведёт историю предупреждений, мутов, киков и банов с идентификаторами; бан действует при повторном входе. Команда проверки пользователя показывает аккаунты с общим IP и активные наказания.
• Игроки могут подавать внутриигровые апелляции и жалобы, а персонал — разбирать их через список или меню.
• Добавляет режим персонала: обычный и строгий невидимый режим, заморозку игрока, чат персонала, просмотр выполняемых команд, полёт, неуязвимость, случайную телепортацию к игроку и изъятие предметов из инвентаря или эндер-сундука.
• Сообщения настраиваются в messages.yml с поддержкой MiniMessage. Есть русский язык: выберите ru_RU в параметре localization.
• Поддерживает PlaceholderAPI: например, %solver_muted%, %solver_warns% и %solver_active_sanctions%.

Команды

Основная команда — /solver; её псевдоним — /as. Группы команд можно разрешить и без префикса /solver через standalone-commands в config.yml.

• Диагностика: /solver help, /solver reload, /solver analyze-last, /solver crashme <exception|deadlock|oom|dry-run>, /solver moderation status, /solver moderation test <message>.
• Наказания: /solver warn <player> <reason>, /solver mute <player> <reason>, /solver tempmute <player> <duration> <reason>, /solver kick <player> <reason>, /solver ban <player> <reason>, /solver tempban <player> <duration> <reason>, /solver unban <player>, /solver unmute <player>, /solver unwarn <player>.
• История и проверка: /solver history <player>, /solver check <id>, /solver note <player> <text>, /solver checkuser <player>, /solver sanctions <player>.
• Апелляции и жалобы: /solver appeal <id> <reason>, /solver appeal list|accept|reject <id>, /solver report <player> <reason>, /solver reports, /solver reports claim|close|reopen <id> [reason], /solver reports gui.
• Инструменты персонала: /solver vanish [strict], /solver freeze <player> [message], /solver staffchat [message], /solver commandspy, /solver staffmode <profile>, /solver fly, /solver god, /solver rtp, /solver inspect <player>, /solver enderchest <player>.

Права

• solver.admin — полный доступ; по умолчанию есть у оператора.
• solver.notify — уведомления об ошибках и результатах модерации; по умолчанию есть у оператора.
• solver.moderation.bypass — исключение игрока из проверки чата.
• solver.diagnostics.*, solver.sanctions.*, solver.reports.*, solver.staffmode.* — доступ ко всем командам соответствующей группы.
• Для отдельных действий используются права с теми же названиями: например, solver.sanctions.ban, solver.reports.manage, solver.staffmode.vanish и solver.staffmode.inspect.
• solver.sanctions.appeal и solver.report по умолчанию доступны всем игрокам; solver.sanctions.appeal.manage позволяет рассматривать апелляции.

Настройка

В config.yml выберите ИИ-провайдера в ai-provider.provider: anthropic, google или other, затем укажите модель и ключ доступа. Вариант other рассчитан на совместимые с OpenAI сервисы и локальные модели через other-url.

Для диагностики доступны автоматический разбор исключений, срок ожидания, сохранение отчётов, каталог reports-directory, срок хранения и уведомления администраторам. Параметр chat-moderation.enabled включает анализ чата; режим работы, размер контекста, частота проверок, категории, реакции и пороги уверенности настраиваются в блоке chat-moderation.

Причины наказаний можно сократить шаблонами в punishments.reason-templates: запись вида #name подставляет заданный текст. В warn-escalation задаётся действие после выбранного количества предупреждений. История хранится локально в SQLite или в общей MySQL-базе для сети серверов.

Профили режима персонала настраиваются в staff-mode.profiles; они могут одновременно включать невидимость, защиту от заморозки, полёт, неуязвимость и временную очистку инвентаря. Для commandspy задаются отслеживаемые команды, исключённые игроки и права.

Требования

Работает на серверах Paper, Folia, Purpur и их сборках. Для функций ИИ необходим ключ Anthropic Claude, Google Gemini либо совместимого с OpenAI сервиса. Нужна Java 17 или новее.

Для модерации чата требуется Paper с событием AsyncChatEvent; Spigot не поддерживается. PlaceholderAPI подключается по желанию. Если установлен EssentialsX, его команда /enderchest сохраняется, а просмотр эндер-сундука через плагин доступен как /solver enderchest.