Мод для Майнкрафт на Fabric, который добавляет в игру ИИ-помощника. Через чат можно задавать ему вопросы, выбирать настроенную модель и при необходимости дать ИИ доступ к данным сервера, белому списку и другим инструментам.
Возможности
- Ответы ИИ в игровом чате с сохранением истории диалога отдельно для каждого игрока и каждой модели.
- Несколько профилей ИИ: для каждого задаются адрес API, модель, ключ, системная инструкция, имя в чате и дополнительные параметры запроса.
- Встроенные инструменты для ИИ: список игроков онлайн, чтение и изменение белого списка, поиск по Minecraft Wiki, калькулятор, подсчёт предметов в стаках и шалкерах.
- Общая база SQLite в формате «ключ — значение». ИИ и администратор могут читать, дописывать, изменять и удалять её записи.
- Дополнительные знания для ИИ из Markdown-файлов навыков и пользовательские инструменты на Groovy.
- Экран настройки в игре, который открывается клавишей
F6; клавишу можно изменить в разделе «Настройки» → «Управление» → «Разное».
Как пользоваться
/ask <текст>— задать вопрос ИИ из профиля по умолчанию./ask -m <модель> <текст>— обратиться к указанному профилю ИИ./ask -n <текст>— задать вопрос без использования истории диалога; флаги можно сочетать./c-ask <текст>— задать вопрос ИИ на стороне клиента, без прав на серверные команды; доступны также флаги-mи-n./gamesai help— открыть справку./gamesai history clear— очистить свою историю диалогов.
Администратор с уровнем прав 4 может применить изменения командой /gamesai reload, очистить всю историю через /gamesai history clearall, выбрать профиль по умолчанию командой /gamesai config defaultAi <aiID> и задать длину истории через /gamesai config maxHistory <число>.
Для работы с общей базой используются команды /gamesai data write <ключ> <значение>, /gamesai data add <ключ> <значение>, /gamesai data read <ключ>, /gamesai data del <ключ> и /gamesai data list.
Настройки
Основной файл находится по пути config/games_ai/config.json. В нём задаются префикс ответов prefix, число сохраняемых сообщений max_history, список профилей all_ai и профиль по умолчанию default_ai.
В каждом профиле укажите base_url, ai_model и api_key. Поле prompt задаёт инструкцию ИИ; вместо длинного текста можно сослаться на файл из config/games_ai/prompt/ значением вида > имя_файла.md.
Файлы навыков размещаются в config/games_ai/skills/, а их список — в config/games_ai/skills/skills.json. Пользовательские инструменты на Groovy нужно положить в config/games_ai/tools/ и затем выполнить /gamesai reload.
Требования и совместимость
Нужны Fabric Loader, Fabric API и Java 21 или новее. Мод работает только с Fabric.
