Kilacraft-AI (Килакрафт аи)

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

Возможности

• Ответы ИИ выводятся в чат, над хотбаром, в боковой панели, верхней полосе или по центру экрана; способ вывода задаётся для разных сценариев.
• База знаний берётся из файлов Markdown и TXT в plugins/Kilacraft-AI/knowledge/: в них можно разместить правила, описание механик и ответы на частые вопросы. Помощник ищет подходящие сведения и указывает использованный материал.
• Для каждого игрока может собираться профиль: стиль игры, интересы, предпочтительный стиль общения, упомянутые места и другие сведения из диалогов. Также учитываются связи между игроками и события, произошедшие в их отсутствие, для персональных приветствий.
• Можно задать характеры ИИ в personalities.yml. При наличии MythicMobs это позволяет делать диалоги с NPC с отдельной историей общения.
• Игрок создаёт задания наблюдения обычной фразой: например, получить уведомление о входе другого игрока, смерти моба, созревании урожая, переплавке или изменении здоровья. Одновременно доступно одно такое задание на игрока.
• ИИ может запрашивать сведения об игроке, мире и сервере, ванильную статистику, а при наличии дополнений — дома, варпы, телепорты и рынок. Права на каждый тип действий выдаются отдельно.
• Администраторам доступны диагностика производительности, анализ активности игроков и журнал использования навыков. При наличии Spark плагин отслеживает TPS, MSPT и нагрузку, умеет запускать профилирование и сохраняет отчёты в plugins/Kilacraft-AI/reports/.

Команды

• /kilacraft <сообщение> — задать вопрос ИИ; также работают /kila, /ai и /zm.
• /kilacraft chat — включить или выключить постоянный режим диалога.
• /kilacraft clear — очистить свою историю чата.
• /kilacraft clear <игрок> — очистить историю указанного игрока.
• /kilacraft knowledge reload — перечитать базу знаний.
• /kilacraft personalities reload — перечитать настройки характеров.
• /kilacraft reload — перезагрузить конфигурацию.
• /kilacraft afk — посмотреть задания наблюдения; /kilacraft afk cancel — отменить его.
• /kilacraft profile start [секунды], /kilacraft profile status, /kilacraft profile stop — управление профилированием сервера.

Права

• kilacraft.clear.self и kilacraft.clear.other — очистка истории.
• kilacraft.reload, kilacraft.knowledge, kilacraft.personalities — перезагрузка соответствующих данных.
• kilacraft.afk — просмотр и отмена заданий наблюдения.
• kilacraft.api.* — запросы к данным Bukkit; kilacraft.cmi.* — возможности CMI.
• kilacraft.bukkit_stats — ванильная статистика; kilacraft.bukkit_fx — звуки и частицы.
• kilacraft.command.execute — выполнение команд от лица игрока.
• kilacraft.admin.health, kilacraft.admin.player, kilacraft.admin.audit — диагностика, анализ игроков и журнал навыков; kilacraft.admin.* выдаёт все административные права.

Настройка

Для работы помощнику нужны данные совместимого с OpenAI поставщика языковой модели в plugins/Kilacraft-AI/llm.yml: адрес API, ключ и имя модели. В этом же файле задаётся сбор профилей игроков; вид вывода и звук ответа настраиваются в output.yml, а сведения для приветствий — в greeting.yml.

История диалогов, профили, отношения и события хранятся во встроенной базе H2 либо в MySQL. Срок хранения указывается в database.yml.

Требования

Плагин работает на серверных ядрах Paper, Purpur, Leaf, Folia и совместимых с Bukkit/Spigot. Для общения требуется доступ к API языковой модели, совместимому с OpenAI.

Необязательные интеграции: CMI для домов, варпов и телепортов, GlobalMarketPlus для рынка, MythicMobs для NPC, Vault для нескольких валют и Spark для подробного анализа производительности. При отсутствии этих плагинов связанные возможности отключаются, а чат с ИИ продолжает работать.