nekostulAICompanion

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 является необязательной.