ScarAI (Скар АИ)

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

Возможности

• Ответы в чате после упоминания слова-триггера в любом месте сообщения; для каждого игрока сохраняется отдельная история диалога.
• Игроки могут через чат запрашивать телепортацию к другому игроку с подтверждением, время, TPS и сведения об игроках, личные точки, офлайн-сообщения и телепортацию на спавн.
• Операторы могут поручать помощнику выполнять консольные команды; опасные команды из списка блокировки не запускаются.
• Напоминания с личным звуком, сохраняющиеся после перезапуска сервера.
• Ежедневная сводка активности сервера: самые активные игроки, число смертей и наиболее загруженный час.
• Проверка чата на токсичность, защита от повторяющегося спама, подсветка упоминаний игроков и звук личного уведомления.
• Меню /scarai, где игрок выбирает модель, стиль ответа «Fast» или «Detailed» и очищает свою историю.

Команды

• /scarai — открывает меню.
• /scarai setkey <key> — задаёт ключ API.
• /scarai trigger <word> — меняет слово-триггер.
• /scarai model <id> — выбирает модель по умолчанию для сервера.
• /scarai reload — перечитывает конфиг.
• /scarai clearmemory — удаляет историю всех игроков.
• /scarai recap [YYYY-MM-DD] — публикует сводку за день.
• /scarai info — показывает состояние плагина.
• /spawn или /scaraispawn — телепортирует на спавн с задержкой.
• /setspawn или /scaraisetspawn — задаёт точку спавна.
• /tpaccept и /tpdeny — принять или отклонить запрос телепортации.

Права

• scarai.admin — административные подкоманды /scarai.
• scarai.setspawn — использование /setspawn.
• scarai.combat-bypass — использование команд во время боевой метки.

Настройка

Параметры находятся в config.yml; изменения применяются командой /scarai reload.

• api-url и api-key задают совместимый с OpenAI адрес API и ключ; ключ также можно передать переменной окружения NVIDIA_API_KEY.
• trigger задаёт слово для вызова помощника.
• models содержит до 14 моделей с идентификатором, названием и материалом значка.
• allowed-commands, op-exec.enabled и blocked-commands определяют доступные действия и ограничения для команд.
• rate-limit.max-per-minute, history, reminders, toxicity-monitor и stats управляют лимитами, памятью, напоминаниями, модерацией и сводками.
• system-prompt и server_rules задают инструкции помощника и правила сервера.
• spawn-warmup и combat-tag настраивают задержку телепортации и боевой режим.

Требования

Нужны сервер Paper или Spigot и Java 21. Требуется ключ от API, совместимого с OpenAI. Обязательных зависимостей нет; для мутов и предупреждений плагин выполняет заданные команды mute и warn, поэтому подойдёт EssentialsX или другой плагин с такими командами.