Плагин для серверов Майнкрафт на Paper добавляет личный чат с ИИ прямо в игре и в браузере. Каждый игрок ведёт отдельные диалоги, может сохранять их и продолжать позднее; ответы доступны только участнику беседы.
Возможности
- Работа с Ollama, Unsloth, vLLM, LM Studio и другими сервисами с совместимым API
/v1/chat/completions. - История диалогов хранится отдельно для каждого игрока в SQLite или PostgreSQL.
- Веб-интерфейс позволяет просматривать историю, начинать новые беседы и продолжать старые после привязки игрового аккаунта.
- Номера чатов индивидуальны: чат
#1одного игрока не совпадает с чатом#1другого. - Лимиты задаются на количество новых чатов за скользящие 24 часа, а не на сообщения.
Команды
/newchat— создать личный чат./ai <сообщение>— отправить запрос в активный чат./endchat— завершить активный чат, не удаляя историю./reopenchat <id>— открыть сохранённый чат по его номеру./ailink— получить код для привязки аккаунта к веб-интерфейсу.
Перед /ai нужно создать чат через /newchat либо открыть существующий через /reopenchat <id>.
Права
aicraft.use— доступ к/newchat,/ai,/endchatи/reopenchat.aicraft.web— доступ к/ailink.aicraft.chats.unlimited— неограниченное число новых чатов.aicraft.chats.<n>— лимит новых чатов, напримерaicraft.chats.50.
Плагин поддерживает LuckPerms. Если у игрока есть aicraft.chats.unlimited, этот доступ имеет приоритет над числовым лимитом.
Настройка
В plugins/Aicraft/config.yml укажите адрес API в endpoint, ключ в api-key, название модели в model, текст системной инструкции в system-prompt, время ожидания в timeout-seconds и размер истории в max-history-messages.
В plugins/Aicraft/web.yml настраиваются веб-интерфейс, порт port, адрес прослушивания bind-address, база данных и лимит rate-limits.default-chats-per-day. Для SQLite файл базы создаётся автоматически; для PostgreSQL базу нужно создать заранее и заполнить параметры database.postgres.*.
Для внешнего доступа к веб-интерфейсу откройте выбранный порт. Значение bind-address: "127.0.0.1" ограничивает доступ текущим компьютером; при публикации через обратный прокси можно использовать HTTPS.
Требования
Нужны сервер Paper, Java и доступный сервис ИИ с совместимым API. Spigot не поддерживается. Веб-интерфейс использует порт 8765 по умолчанию, но его можно изменить в web.yml.
