Описание
## EN
AI Companion NPC adds a fully controllable companion to Minecraft.
This NPC works completely offline by default - no AI, no API keys required.
He can:
- Follow and protect the player
- Mine resources (wood, stone, ores, sand, clay, etc.)
- Use buckets (water/lava)
- Craft torches
- Manage inventory and a personal chest
- Set and return home
- Execute chained tasks in order
- Build houses from structured plans
- Evaluate player-built houses
The NPC always follows explicit player commands and does not act independently beyond given instructions.
---
### Optional LLM Integration
The mod supports optional integration with YandexGPT.
When enabled:
- If the strict parser does not understand a player's message, the text is sent to the LLM.
- The LLM returns structured JSON intent.
- The JSON is translated into the internal task system.
- The NPC executes the task using its normal logic.
The LLM processes messages and generates responses **only in Russian**.
To use real AI, you must provide a Yandex Cloud API key and folder ID in the mod configuration file.
The mod works perfectly without AI — LLM integration is completely optional.
---
## RU
AI Companion NPC добавляет в Minecraft полностью управляемого NPC-напарника.
По умолчанию мод полностью работает оффлайн - без ИИ и без API-ключей.
NPC умеет:
- Следовать за игроком и защищать его
- Добывать ресурсы (дерево, камень, руды, песок, глину и др.)
- Работать с вёдрами (вода/лава)
- Крафтить факелы
- Управлять инвентарём и личным сундуком
- Устанавливать и использовать точку дома
- Выполнять цепочки задач по порядку
- Строить дома по структурированному плану
- Оценивать дома игрока
NPC выполняет только те задачи, которые дал игрок.
---
### Опциональная интеграция с LLM
Мод поддерживает опциональную интеграцию с YandexGPT.
При включении:
- Если строгий парсер не понимает сообщение игрока, текст отправляется в LLM.
- LLM возвращает структурированный JSON с намерением.
- JSON переводится во внутреннюю систему задач.
- NPC выполняет задачу по своей обычной логике.
LLM обрабатывает сообщения и формирует ответы **только на русском языке**.
Для использования реального ИИ необходимо указать API-ключ Yandex Cloud и folder ID в конфигурационном файле мода.
Мод полностью работает и без ИИ — интеграция LLM является необязательной.