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