Мод для Майнкрафт, который добавляет на сервер ИИ-помощника для общения с игроками. Он следит за чатом и игровыми событиями, поддерживает контекст беседы и может выполнять команды, если ему разрешено.
Возможности
- отвечает в чате через API, совместимые с OpenAI, включая Azure OpenAI и локальные языковые модели;
- реагирует на вход и выход игроков, смерти и другие события сервера;
- проверяет, стоит ли отвечать на конкретное сообщение, чтобы не засорять чат;
- запоминает заданное число предыдущих сообщений и учитывает их в ответе;
- может выполнять команды Майнкрафт через вызов функций, с учётом настроек прав;
- позволяет менять модель, характер ответов, цвет сообщений бота, часовой пояс и язык служебных сообщений.
Как пользоваться
Укажите ключ API и адрес сервиса, затем игроки смогут обращаться к помощнику в общем чате. Проверка намерения включается параметром useIntentionChecker; для неё можно задать отдельные модель, ключ и адрес API. Параметр responseProbabilityThreshold определяет, насколько вероятным должно быть обращение к помощнику для ответа.
Если включён inheritCmdSourcePermission, помощник выполняет команды с правами игрока, вызвавшего ответ. Контекст беседы задаётся параметром contextSize, а системные инструкции для поведения помощника — intentionCheckingSystemMessage и responseGenerationSystemMessage.
Настройки
Файл настроек находится по пути:
- Fabric, Forge и NeoForge:
config/serverchan.yaml; - Spigot:
plugins/ServerChan/config.yml.
Для работы нужны openaiApiKey и openaiBaseUrl; в адресе API должен присутствовать путь /v1. Среди полезных параметров: model, temperature, botColor, timeZone, locale, enableGameEvents, enableJoinLeaveEvents и enableDeathEvents.
Требования и совместимость
Работает на серверных платформах Fabric, Forge, NeoForge и Spigot/Paper; доступность зависит от используемой версии игры и загрузчика. Нужен ключ API OpenAI либо совместимого провайдера.
