Перейти к содержимому
Mineforgian

nekostulAICompanion

Adds a player-controlled companion NPC with a structured task system, home mechanics, advanced resource automation, and optional YandexGPT (LLM) integration.

Загрузки
2K
Подписчики
3
Обновлён
9 мая 2026 г.
Лицензия
MIT

Опубликован 17 февраля 2026 г.

Исходный код

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

Ченджлог

2.0Релиз1.20.1 · 9 мая 2026 г.
  • completely reworked player-following behavior: the NPC now moves much more smoothly, behaves closer to a real player, slows down more naturally, and chooses safer paths.
  • improved water behavior: the NPC enters water more reliably, swims after the player more naturally, and gets back onto land more consistently.
  • added custom NPC skins via the mod folder in the game root, with /ainpc skin <name> and /ainpc skin reset commands.
  • added custom NPC nicknames with /ainpc nickname <name> and /ainpc nickname reset, with nickname persistence after rejoining.
  • updated the help system with new skin and nickname command help entries.
  • the NPC’s chunk is now kept force-loaded to prevent the NPC from getting lost due to chunk unloading.
  • if the NPC is at home, it now replies I’m home instead of sending coordinates when asked where are you?.
1.4Релиз1.20.1 · 6 марта 2026 г.
  • bug fixes and improvements
1.3Релиз1.20.1 · 2 марта 2026 г.
  • soft player-style movement learning.
  • temporary in-memory route memory for follow movement (time/size limited, not saved).
  • earlier jumps before obstacles with better momentum preservation.
  • ladder climb assist.
  • periodic no-home reminder after death (every 60s) with in-chat disable.
  • one-time-per-death response when commands are blocked by missing home point.
  • more reliable command handling when the companion is far/unloaded.
  • fixed command handling when the npc is far away and previously did not respond.
1.2Релиз1.20.1 · 23 февраля 2026 г.
  • Updated item icons (axe, pickaxe, shovel, sword)
  • Restricted NPC spawning to one companion per player
  • Added warning message if a companion already exists
1.1Релиз1.20.1 · 21 февраля 2026 г.

Added

  • Coordinate parsing for gathering/mining commands: mine <resource> x y z and x= y= z= formats.
  • Target-position propagation through request/task layers to the gathering controller.
  • Double-door synchronization: when NPC opens one door, the adjacent paired door opens too.
  • Explicit "active house placement phase" flag (used to prevent combat distractions during actual building).
  • House-build start anchor: NPC returns to the original build start area if it drifts away.

Changed

  • Follow behavior is now strictly owner-bound (no fallback to nearest player).
  • Teleport/fallback logic prioritizes owner context instead of arbitrary nearby players.
  • Multi-player NPC spawn handling: spawning one player’s NPC no longer removes another player’s NPC.
  • House building pace: placement is 1 block every 4 ticks (0.2s).
  • During active house placement (after resources are ready), NPC does not switch to combat.
  • While waiting for house resources, NPC can still defend itself and protect the owner.
  • Combat threat radius set to 7 blocks.
  • Mob chase behavior made more aggressive for better target catch-up.

Fixed

  • NPC no longer chases/retaliates against players who hit it.
  • HP recovery after eating is reliable (heals like player-style food healing behavior).
  • Feeding is properly blocked at full hunger (no food consumption, no click animation side-effects via HUNGER_FULL sync flag).
  • Critical low-HP warning (<=4) is emitted once per low-health event, then re-armed only after recovery.
  • Passive-mob hunting is restricted to actual hunger + insufficient food reserves.
  • Loot gratitude from mob drops is disabled (thanks only for items given by players).
  • Ambient/random contextual chatter is disabled (tickAmbientChat no-op).

YandexGPT / AI

  • Conversation memory increased to last 15 messages (oldest entries rotate out).
  • AI reply hard limit set to 256 characters.
  • Prompting adjusted so AI helps the player directly and asks
1.0Релиз1.20.1 · 17 февраля 2026 г.

AI Companion NPC 1.0

Fully functional offline companion NPC for Minecraft.

  • Mines resources, gathers wood and ores
  • Handles inventory and personal chest
  • Follows, fights, eats, and survives
  • Supports home system and house evaluation
  • Optional YandexGPT integration via config (API key required)

Works completely without LLM by default.
LLM integration is optional and disabled unless configured.

Комментарии

Загружаем…