Core Companion

Core Companion

Core Companion добавляет в Minecraft привязанного к владельцу ИИ-компаньона. Компаньон может общаться с игроком, помнить контекст, реагировать на мир, использовать инвентарь, выполнять задачи на выживание, показывать эмоции, использовать опциональные функции голоса/TTS/зрения и выполнять действия в мире на базе Baritone.

Цель — сделать компаньона постоянным персонажем в вашем мире, а не простым питомцем или командным ботом. Он может следовать за вами, оставаться рядом, помогать с задачами, реагировать на события, управлять предметами, выполнять цели планировщика, строить отношения со временем и настраиваться через внутриигровые параметры. При первом входе он настраивается автоматически — выбирает и скачивает локальную ИИ-модель, подходящую вашему железу — так что от установки до говорящего компаньона можно дойти, не редактируя ни одного файла конфигурации.

Статус разработки

Core Companion — ранний релиз. Некоторые функции экспериментальны и могут меняться по мере улучшения мода.

Предупреждение о железе для локального ИИ

CoreCompanion запускает языковую модель Ollama параллельно с Minecraft, поэтому обе программы должны делить память вашей видеокарты.

12 ГБ выделенной VRAM — минимум, рекомендуемый для нормального опыта, а 16 ГБ предпочтительнее. Примеры: RTX 3060 12 ГБ, RTX 4070, RTX 5070, RX 7700 XT, RTX 4060 Ti 16 ГБ, RTX 5060 Ti 16 ГБ и RX 7800 XT.

Видеокарты с 6–8 ГБ VRAM ограничены лёгкой ИИ-моделью и могут не справляться при использовании шейдерпаков, текстурпаков высокого разрешения, функций зрения или требовательных настроек Minecraft.

Пожалуйста, проверьте точный объём VRAM перед скачиванием.

Это требование относится только к запуску ИИ локально. Игрокам, использующим совместимого облачного ИИ-провайдера, видеокарта с поддержкой локального ИИ не нужна.

Основные функции

• Спавн, удаление, отзыв, поиск и автоспавн вашего компаньона при входе
• Постоянная привязанная к владельцу личность компаньона
• Варианты настройки компаньона женского и мужского пола
• Выбор режима старта для каждого мира: сразу связаться с партнёром или встретить несвязанных деревенских компаньонов и заслужить их доверие через общение и еду
• Компаньон может быть целью ванильных команд через заданное имя или псевдоним
• Инвентарь рюкзака и экипировки, экран инвентаря компаньона и вращаемый 3D-предпросмотр компаньона
• Удержание предметов, использование экипировки, передача предметов, выбрасывание, складывание и сортировка
• Подбирает ваши выпавшие предметы после смерти — она идёт к месту вашей смерти, забирает ваши вещи (полный NBT нетронут) и приносит их обратно
• Orb of Binding и поддержка яиц спавна связанных/несвязанных компаньонов
• Ношение на плече, спешивание, держание за руку, привязка/отвязка/притягивание поводком игрока и очистка состояния парных эмоций

Настройка и первый запуск

При первом входе Core Companion настраивается автоматически — никаких файлов конфигурации редактировать не нужно.

• Выбор модели с учётом железа: он проверяет память, которую ваша машина реально может отдать ИИ-модели — выделенную VRAM видеокарты, объединённую память Apple Silicon или системную RAM — резервирует несколько ГБ для самого Minecraft, чтобы ничего не выгружалось и не тормозило, и скачивает наиболее подходящую локальную модель: лёгкую (dolphin-phi), сбалансированную (dolphin3) или самую крупную (dolphin-mixtral). Он сообщает, какую выбрал для ваших характеристик, так как на больших моделях ответы становятся чётче.
• Скачивание в реальном времени, затем появление: полоса прогресса над хотбаром отслеживает разовое скачивание, и ваш компаньон появляется только после того, как её модель скачана и прогрета — она никогда не спавнится неспособной говорить.
• Дружелюбно к чистым машинам: если локальный ИИ-сервис (Ollama) ещё не установлен, вместо сырой ошибки появляется понятное внутриигровое руководство по настройке — а следование, добыча и строительство продолжают работать и без него.
• Всегда настраиваемо: выбранная модель, провайдер, характер и всё остальное остаются редактируемыми позже на внутриигровом экране конфигурации, а модель, заданная вами вручную, всегда учитывается.

ИИ и чат

Core Companion поддерживает обычные ответы в чате и действия с помощью ИИ через команду /corecompanion.

• /corecompanion ask — поговорить с компаньоном
• Локальный приоритет и гибкость провайдеров: по умолчанию работает на локальной модели Ollama, но можно подключить любую конечную точку, совместимую с OpenAI (OpenAI, xAI/Grok, совместимая с OpenAI конечная точка Gemini, LM Studio, сервер llama.cpp и другие)
• Локальный запуск без настройки: при первом входе автоматически выбирается и скачивается локальная модель под ваше железо, а затем она прогревается до появления компаньона (см. Настройка и первый запуск)
• Провайдер, конечная точка, API-ключ и модель задаются в игровом экране настроек
• Настраиваемые характер, история, temperature, длина токенов и параметры ответов
• Внутренние директивы действий ИИ для действий Baritone, целей планировщика и социальных действий
• Детерминированные обработчики для вопросов о местоположении, блоке под взглядом и действий с ним, голода/еды, ближайшей деревни, сна, «отведи меня на базу/ферму» и социальных запросов
• Несколько строк действий ИИ можно ставить в очередь и обрабатывать

Прямые глаголы действий

Компаньон поддерживает множество команд прямых действий и действий, запускаемых ИИ.

• Управление и статус: stop, stay, recall, where, status
• Режимы: role, care_mode, combat_mode
• Навигация: follow, surface, sleep_routine, explore, goto, goto_memory, go_home, go_farm, locations, locate_village
• Память: remember_location
• Предметы и логистика: collect_items, eat, give_item, drop_item, inventory_intent, deposit_items, sort_inventory
• Добыча, бой и фермерство: mine, defend, attack_hostiles, hunt, harvest, replant
• Строительство: place, preview_template, build_line, structures, build_template

Автоматизация планировщика

Детерминированная автоматизация планировщика для обычных задач выживания. Запросы на естественном языке могут превращаться в очереди планов, позволяя компаньону выполнять многошаговые задачи.

Текущие цели планировщика: get_wood, get_food, get_torches, farm_cycle, tend_remembered_farm, farm_cycle_deposit, prepare_mining_trip, prepare_toolkit, build_shelter, patrol_base, light_area, maintain_base, restock_base, wood_run, mining_expedition, return_and_deposit, torch_path, recover_death_drops, smelt_ores, tend_livestock, fish, make_camp.

Помимо сбора ресурсов и поддержания базы, она умеет ходить на рыбалку, плавить руду, ухаживать за скотом, разбивать лагерь, а после неудачного вылазки — подбирать ваши вещи после смерти и приносить их вам. Бонусы отношений могут увеличивать некоторые объёмы поставок планировщика.

Социальные функции и отношения

Меню взаимодействия включает действия компаньона, быстрые задачи, параметры отношений и служебные элементы управления: доступ к инвентарю, экран отношений, доска заданий, меню структур, очередь действий, follow/stay/status/stop/clear-queue, сортировку и складирование, пресеты охраны/фермы/патруля/факелов/древесины/добычи, управление памятью базы и фермы, кнопки ролей и социальные действия.

Встроенные эмоции: Wave, High five, Sit, Lean, Hug, Kiss.

Сон вместе: ночью ласковая компаньонка может улечься рядом с вами спать — на своей кровати поблизости, на месте, придвинутом ближе, или на вашей кровати — с несколькими сердечками. Поцелуи, держание за руки и общая интенсивность ласки настраиваются, так что вы сами решаете, насколько она инициативна.

Отношения развиваются через разговоры и кормление и проходят по уровням — Stranger, Acquaintance, Friend, Close, Dating, Bonded — открывая больше социальных действий и более тёплое поведение:

• Stranger / Acquaintance — сдержанна; базовые действия и high five
• Friend — наклоняется, носит вас, держит за руки; авто-защита и помощь едой, когда вы ранены
• Close — объятия, поцелуй
• Dating / Bonded — открыто ласкова; даёт вам золотое яблоко, когда вы вот-вот падёте, и иногда дарит небольшой подарок

Некоторые парные взаимодействия срабатывают только тогда, когда это позволяют состояние компаньона и позиция игрока — так анимации не выглядят нелепо или некорректно.

Режимы автономии и безопасности

Настройки роли, заботы и боя позволяют компаньону вести себя по-разному в зависимости от ситуации.

• Роли: Idle, Guard, Farmer, Miner, Hauler
• Режимы заботы: Passive, Balanced, Guard, Retreat, Full
• Политика боя: Passive, Defend, Assist
• Безопасность изменения мира: переключатель, можно ли ей ломать или ставить блоки в твоём мире

Она следит и за собой, и за тобой: ест и пьёт зелья лечения при низком здоровье, автоматически надевает лучшую броню и достаёт лучшее оружие перед боем, отступает к тебе — или к запомненной базе, если ты далеко — когда сильно ранена, и просит еды, когда у неё её нет. Дружелюбный компаньон также может проявлять инициативу: предложить сделать факелы, когда стемнеет, или принести еды, когда ты голодаешь. Если она погибнет, то оставит recoverable spawn-egg keepsake, чтобы ты мог вернуть её с сохранённой связью.

Память и восприятие

Постоянная память может отслеживать предпочтения игрока, недавние чаты, события, смерти, добычу ресурсов, исследование, биомы, запомненные базы/фермы/координаты, запомненные планы, настроение/текущую цель и сводки.

Контекст мира может включать измерение, позицию, биом, время, погоду, уровень освещения, сущности поблизости, запомненные места, контекст звука/слуха и физическое состояние. Её текущее настроение влияет на поведение — хрупкое настроение заставляет её отступать раньше, а защитное — держать строй и охранять тебя. Она также осмысляет недавние события вместе, связывая их, а не реагируя на каждое по отдельности.

Пассивные реакции могут охватывать получение предметов, держание за руку, переноску, социальные действия, события под руководством игрока, урон, голод, добычу ресурсов, строительство, бой, путешествия, моменты бездействия, опасность и — при включённом зрении — заметные вещи, которые она видит на экране.

Голос, зрение и клиентский интерфейс

Необязательные клиентские функции для голоса, TTS, зрения, HUD, оверлеев и рендеринга:

• Захват голосового ввода с поддержкой локального speech-to-text / whisper.cpp
• Воспроизведение text-to-speech с голосами OpenAI или ElevenLabs (настраивается в игре)
• Необязательный захват зрения через framebuffer с помощью локальной vision-модели Ollama, с захватом по запросу и визуальными сводками, передаваемыми в контекст компаньона
• Status HUD, debug HUD и оверлей пути Baritone
• Экран настроек в игре в стиле ванильных меню, включая раздел AI Providers для эндпоинтов, моделей и API-ключей
• Слои рендеринга компаньона для формы тела, кошачьих ушей, хвоста, визуалов под руководством игрока, брони и предметов в руках

Данные и расширяемость

• Встроенные и загружаемые из конфига наборы взаимодействий
• Встроенные и загружаемые из конфига шаблоны структур, а также входящие данные укрытий/шаблонов
• Команды перезагрузки для наборов и шаблонов
• Инструменты под debug-флагом для выгрузки промптов, статуса/сбоев Baritone, проверок паритета, тестирования выражений, видеосценариев и записи держания за руку

Примечание о приватности / AI-сервисах

Core Companion построен вокруг AI-сервисов, настраиваемых пользователем. Чат может работать через локальную модель Ollama или любой совместимый с OpenAI эндпоинт, который ты настроишь. Необязательные функции голоса, text-to-speech и зрения зависят от сервисов, которые настроит игрок. Использование облачного LLM или TTS-провайдера отправляет твой текст (а для зрения — контекст скриншота) этому провайдеру; запуск всего локально оставляет данные на твоей машине. Проверь свою конфигурацию перед включением этих функций.

Команды

Основная команда: /corecompanion

Подкоманды: ask, spawn, remove, recall, where, help, setup female, setup male, start bonded, start village, carry, dismount, playerlead, reload. Дополнительные debug- и developer-команды доступны при включённых опциях отладки.

Нужна помощь с установкой?

Если у вас возникли проблемы с установкой CoreCompanion, ИИ-ассистент, такой как ChatGPT, Claude или Gemini, может помочь объяснить сообщения об ошибках и провести вас через настройку.

Для наилучшей помощи укажите вашу версию Minecraft, версию Fabric Loader, список установленных модов, видеокарту, операционную систему и соответствующий раздел latest.log.

Никогда не делитесь API-ключами, токенами доступа, паролями или полным файлом конфигурации. Инструкции, сгенерированные ИИ, могут быть неверными, поэтому сделайте резервную копию вашего инстанса перед изменением или удалением файлов.

Требования

• Fabric API
• GeckoLib
• Mod Menu (необязательно — открывает экран настроек в игре)
• Совместимая версия Minecraft / Fabric
• Ollama (или другой локальный сервис моделей) для локального ИИ, либо API-ключ, совместимый с OpenAI, для облачного ИИ — для локального ИИ подходящая по размеру модель скачивается автоматически при первом запуске