Мод для Майнкрафт на Fabric, который добавляет в обычный чат ИИ-помощника. Он отвечает на вопросы игрока и при необходимости получает актуальные данные о мире, персонаже, предметах, крафтах и окружении; работает в одиночной игре и на выделенном сервере, а подключаться к серверу можно с ванильного клиента.
Возможности
- Поддерживает OpenAI, OpenRouter, LM Studio, Ollama, Anthropic и другие сервисы с совместимым интерфейсом OpenAI.
- Можно создать несколько подключений к разным моделям и переключаться между ними.
- Помощник может узнать измерение, здоровье, голод, опыт, режим игры, координаты, биом, время, погоду, сложность и активные эффекты.
- Доступны сведения об инвентаре, броне, предметах в руке, зачарованиях, достижениях, статистике, игроках на сервере и ближайших сущностях.
- Помощник ищет предметы, блоки и рецепты, включая предметы из других модов по идентификатору
namespace:item. - Он читает текст табличек и книг, содержимое сундуков, бочек, шалкеров, воронок, эндер-сундуков и вагонеток с сундуком, а также может искать ближайший блок заданного типа.
- По желанию помощник выполняет команды Майнкрафт, но только с уровнем прав самого игрока.
Как пользоваться
Для настройки облачного сервиса используются команды:
/llm configure cloud— создать и выбрать подключение./llm set cloud apikey YOUR_API_KEY— указать ключ API./llm test— проверить подключение./llm ask <message>— отправить вопрос помощнику.
Для локальной модели в LM Studio или Ollama:
/llm scan <url> [api_key]— определить интерфейс сервиса и доступные модели./llm configure <id> <url> <model> [api_key]— создать подключение к своему адресу./llm select <id>— выбрать созданное подключение./llm set <id> model list— вывести список моделей в книге игры.
Дополнительные команды:
/llm delete <id>— удалить подключение./llm info— показать сведения о профиле и выбранном подключении./llm upload <url> <message>— отправить ссылку на медиафайл вместе с вопросом./llm clearmemory— очистить историю и сохранённое резюме беседы./llm mode PRIVATE|GLOBAL— выбрать, кому будут видны ответы./llm global— направлять весь свой чат помощнику./llm commands— разрешить или запретить помощнику использовать команды от имени игрока.
Настройки
Общие параметры находятся в config/viperllm.json; после изменения файла нужен перезапуск сервера.
defaultProvider,defaultModel,defaultUrl,defaultApiKeyзадают сервис, модель, адрес и резервный ключ по умолчанию.defaultMaxTokens,defaultTemperature,defaultTopPуправляют длиной и характером ответов.contextPlayerData,contextInventory,contextRecipes,contextMaxRecipesопределяют, какие игровые данные передавать помощнику.allowCommandExecutionвключает или отключает выполнение команд для всего сервера.allowPrivateNetworkScanningиallowPrivateNetworkScanningForOperatorsуправляют поиском сервисов в локальной сети.findBlockRadiusзадаёт радиус поиска блоков.
Для отдельного подключения можно менять адрес, модель, ключ, инструкцию, температуру, тайм-аут, префикс и цвет ответа через /llm set <id> ....
Требования и совместимость
Нужен Fabric Loader; Fabric API не требуется. Ключи API хранятся открытым текстом в профилях игроков по пути world/viperllm/players/<UUID>.json, поэтому доступ к папке мира и резервным копиям следует ограничить.
