Nova Quantum

Nova Quantum

От Seidr Labs — мод на Fabric, который добавляет в ваш мир Minecraft управляемого голосом ИИ-компаньона.

Quantum — это мод на Fabric для Minecraft 1.21.11. Она присоединяется к вашему миру как настоящая сущность, слушает голосовые команды и играет рядом с вами — добывает ресурсы, крафтит, строит и защищает — при этом соблюдая те же ванильные правила, что и вы.

Quantum — это незавершённый преемник оригинального мода Nova AI Minecraft Friend (~30 тыс. строк, заархивирован 2026-05-11). Это чистая пересборка с учётом уроков того проекта — меньше площадь поверхности, строгая модульная архитектура, соответствие ванильным правилам и устойчивость к смене версий Minecraft.

Требуется: ваш собственный API-ключ OpenAI

Голосовые и ИИ-функции Quantum обращаются к API OpenAI, используя ключ, который предоставляете вы. Мод запускается и загружается и без него, но компаньон будет молчать и не сможет понимать голосовые команды, пока вы не укажете ключ.

При первом запуске мод создаёт config/quantum/secrets.json с заглушкой. Замените REPLACE_WITH_YOUR_KEY на ключ со страницы https://platform.openai.com/api-keys.

Вы платите OpenAI напрямую за использование. Никакого промежуточного сервера Seidr Labs, никакого прокси, никакого общего ключа. Расходы зависят от того, сколько вы говорите — типичная сессия с активным голосовым общением обходится в несколько центов.

Сеть и приватность

Мод обращается ровно к одному внешнему сервису, когда используются ИИ-функции:

Это полный список исходящих сетевых обращений.

• Никакой телеметрии Seidr Labs. Ничего не отправляется на seidrlabs.online или любой другой сервер под контролем Seidr. Мод не стучится домой.
• Никакой сторонней аналитики. Ни Sentry, ни Google Analytics, ни сборщиков отчётов о крашах.
• Ваше аудио и запросы уходят в OpenAI. Это неизбежно при использовании их API. Вы платите им, вы отправляете им данные — так же, как если бы пользовались ChatGPT напрямую.
• Память диалога хранится локально. Последние несколько реплик сохраняются в папке вашего сохранения Minecraft, а не в каком-либо облаке.
• API-ключ никогда не покидает вашу машину, кроме как внутри заголовка Authorization: Bearer ... в перечисленных выше вызовах.

Возможности

Голосовое управление

Запись по push-to-talk по умолчанию привязана к настраиваемой клавише. Записанное аудио (≥500 мс) расшифровывается через OpenAI Whisper, расшифровка проходит через небольшой набор быстрых встроенных правил определения намерений, а всё, что не обработано локально, отправляется в модель chat-completions для понимания естественного языка. Пороги уверенности не дают ей действовать по неоднозначным указаниям. Примеры, которые работают уже сейчас:

• «найди мне десять алмазов» → она отправляется под землю, безопасно спускается по схеме лестницы и начинает копать
• «следуй за мной через эту пещеру» → она идёт за вами, используя ванильную навигацию
• «защити меня» → переключается на набор с мечом/луком и атакует враждебных мобов рядом с вами
• «открой инвентарь» / «возьми это» → открывает своё меню, чтобы вы могли дать ей инструменты, еду, блоки

Добыча и сбор ресурсов

Прокладка пути спуском по лестнице для безопасного вертикального перемещения. Распознаёт подобранный каталог ванильных блоков и мобов (загружается из JSON; никакой зашитой в код магии). Прокапывает туннели, обходит препятствия и останавливается, когда запрос выполнен или её инвентарь заполнен.

Бой

• Автоматически меняет оружие на лучшее из имеющегося под ситуацию (ближний бой → меч, дальний → лук)
• Блокирует щитом с реалистичным расходом прочности
• Поведение «кайтинга крипера»: отходит, когда крипер начинает взрываться
• Сначала атакует ближайшую реальную угрозу, переключается, если появляется кто-то ближе
• Никакого аимбота, никаких ударов сквозь стены и прочих нарушений ванильных правил

Цепочки безопасности

Небольшая библиотека «цепочек безопасности» — поведений, которые прерывают текущую задачу, когда происходит что-то опасное:

• FoodChain (готово) — ест из своего инвентаря, когда голодна
• FallSafetyChain (готово в v0.8.112) — ставит ведро воды под собой в точке приземления, если падает больше трёх блоков и ведро есть под рукой. Ведёт себя как игрок в MLG.
• LowHpFleeChain (в разработке) — выходит из боя и восстанавливается, когда здоровье падает ниже порога
• MobDefenseChain (в разработке) — упреждающе атакует nearby угрозы во время небоевых задач
• EmergencyUnstuckChain (в разработке) — поведение восстановления, когда её путь застревает на рельефе

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

Память разговора

Quantum помнит последние несколько реплик разговора между сессиями. Состояние сохраняется при выходе и восстанавливается при входе. Хранится в вашей локальной папке сохранений, никуда не загружается.

Инвентарь, безопасный при деспавне

Когда она исчезает (вы выходите, она умирает, чанк выгружается), её инвентарь сохраняется и восстанавливается при возрождении. Ничего не теряется.

Аудио

Ответы в формате text-to-speech генерируются через эндпоинт OpenAI /v1/audio/speech, а затем воспроизводятся через существующий контекст OpenAL в Minecraft — так её голос звучит через то же аудиоустройство, что использует ваша игра.

Внутриигровое меню

Отдельное меню на клавишу G открывает статус Quantum, инвентарь и настройки поведения, не выходя из мира.

Установка

1. Установите Fabric Loader 0.18.1+ для Minecraft 1.21.11
2. Установите Fabric API
3. Положите quantum-X.X.X.jar в папку .minecraft/mods/
4. Запустите Minecraft один раз, чтобы создать config/quantum/secrets.json
5. Откройте этот файл и замените REPLACE_WITH_YOUR_KEY на ваш ключ OpenAI API
6. Запустите снова — теперь Quantum умеет говорить

Мод загружается и с ключом API, и без него. Без ключа вы всё равно увидите сущность и меню на G, но голосовые и ИИ-функции будут неактивны.

Требования

• Minecraft 1.21.11 (Fabric)
• Fabric Loader 0.18.1 или новее
• Fabric API
• Java 21+
• И клиент, и сервер (для мультиплеера мод нужен с обеих сторон)
• Ключ OpenAI API для голосовых и ИИ-функций

Статус проекта

Quantum находится в активной предрелизной разработке (текущая сборка v0.8.x). Основные системы — маршрутизация голоса, навигация, добыча, бой, еда, безопасность при падении, восстановление после деспавна, память разговора, аудио, меню на G — работают и протестированы в непрерывных игровых сессиях. Оставшиеся цепочки безопасности (LowHpFlee, MobDefense, EmergencyUnstuck) сейчас портируются из оригинальной кодовой базы Nova и появятся в серии v0.8.x → v0.9.x.

Играть можно уже сегодня, всё работает, но ожидайте частых обновлений версий и occasional изменения поведения по мере завершения порта.

О Seidr Labs

Seidr Labs — небольшая студия, выпускающая сфокусированные инструменты для Minecraft, которые поддерживает один разработчик. Никаких обязательных сервисов со стороны Seidr. Никакой телеметрии. Разумные настройки по умолчанию. Тестируется в продакшене перед публичным релизом.

Соседний проект: NovaSync — серверная админ- и сетевая основа для Paper 1.21+.

Ссылки

• Домашняя страница проекта: https://nova-ai.online
• Студия: https://seidrlabs.online
• Сообщество / Discord: https://discord.gg/9CwtGJsznq
• Patreon: https://www.patreon.com/c/Nova_AI_Companion
• YouTube (девлоги / демо): @Nova_Ai_MC_Mods