Об этом проекте

虚幻盒子（UE Box）— это открытое настольное приложение, позиционируемое как AI Agent для непосредственной работы с редактором Unreal. После настройки поставщика модели оно через плагин UnrealAgentLink подключается к работающему редактору Unreal и с помощью более ста инструментов движка и 25 встроенных навыков выполняет задачи: размещение Actor, изменение Blueprint, соединение материалов, компиляция C++ и т. д. Обычные операции выполняются сразу, рискованные приостанавливаются в ожидании подтверждения пользователя; после завершения задачи Agent с помощью инструментов только для чтения проверяет изменения в движке и по пунктам отвечает на выявленные проблемы. Охват помимо уровней, Blueprint, материалов, ассетов и C++ включает также перенаправление анимации, UMG, камеры Sequencer, проверку работы в PIE, редактирование геометрии и диагностику проекта. Основной продукт — это Agent; библиотека проектов, библиотека ассетов, библиотеки Blueprint и материалов, заметки и база знаний имеют отдельные интерфейсы и могут использоваться самостоятельно, но в структуре продукта служат Agent: регистрируют цели воздействия, предоставляют материалы, принимают результаты. Данный репозиторий — это社区-версия: не требует учётной записи, не зависит от официальных серверов, может быть полностью собран самостоятельно. Порядок начала работы: скачать и установить из GitHub Releases или с официального сайта (Windows), в настройках добавить поставщика модели и ввести свой API Key, указать его как модель диалога по умолчанию; модель должна поддерживать вызов инструментов. Поддерживается локальный вывод (Ollama, LM Studio, llama.cpp) и собственные шлюзы (LiteLLM, One API). Затем в библиотеке проектов импортировать .uproject; подключающий плагин автоматически установится в каталог Plugins/UnrealAgentLink/ проекта, его можно отключить или удалить. После открытия проекта плагин подключается автоматически; в боковой панели AI-сессии можно сначала задать вопрос только для чтения (например, о количестве источников света на уровне), чтобы убедиться в подключении. Пользователи, уже использующие Codex, Claude Code или Cursor, могут включить переключатель MCP и подключить 虚幻盒子 как сервис инструментов, получив тем самым более ста инструментов UE; MCP доступен только с локальной машины, требует токен и по умолчанию допускает запись. Сеть и данные: учётные записи не используются, ключи хранятся в зашифрованном виде на локальной машине, запросы идут напрямую к настроенному пользователем поставщику, минуя серверы проекта. По умолчанию проверяется только обновление, без загрузки; сборки, собранные самостоятельно и без указанного источника обновлений, не отправляют сетевых запросов. Функции AI, онлайн-поиска, генерации изображений, облачных дисков и т. п. подключаются по мере необходимости; при использовании локальной модели данные AI не покидают машину. Поддержка платформ: для Windows предоставляется установочный пакет, поддерживается обнаружение движка и предкомпилированный плагин UnrealAgentLink — это основная платформа; для macOS требуется сборка из исходников, возможны сканирование движков в常见 общих каталогах установки, ручное добавление каталога движка или .app редактора, а также обнаружение работающих редакторов UE4/UE5 и путей их проектов, однако сборка и приёмка выпуска предкомпилированного плагина ещё не завершены; для Linux требуется сборка из исходников, обнаружение движка пока не адаптировано. Технологический стек — Electron + Vue 3 + TypeScript, поддерживается Unreal Engine от 5.0 до 5.8. Запуск из исходников: pnpm install и pnpm dev; перед коммитом запускается pnpm verify — одной командой выполняются сканирование секретов, lint, lint изменённых строк, проверка типов и модульные тесты, причём это можно делать при работающем приложении. Репозиторий предоставляет спецификацию AGENTS.md и критерии приёмки для AI-ассистентов по коду: пользователь может описать требование на естественном языке, чтобы AI-ассистент изучил архитектуру, изменил код, дополнил тесты и прошёл проверку. Лицензия: приложение распространяется по Apache License 2.0, исходный код плагина UnrealAgentLink находится в plugin/UnrealAgentLink и распространяется по отдельной лицензии MIT. Unreal Engine — товарный знак Epic Games, Inc.; данный проект не связан с Epic Games.