soft-ue-cli
Python-CLI и MCP-сервер, через которые агент создает акторы, правит блупринты и запускает PIE в Unreal Engine 5
- 216 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Команда `run-python-script` выполняет произвольный Python во встроенном интерпретаторе Unreal с доступом к проекту
- Мост внутри редактора принимает по HTTP на порту 8080 команды, которые меняют ассеты, блупринты и уровни и запускают пересборку проекта
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/soft-ue-cliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Команда `run-python-script` выполняет произвольный Python во встроенном интерпретаторе Unreal с доступом к проекту
- Мост внутри редактора принимает по HTTP на порту 8080 команды, которые меняют ассеты, блупринты и уровни и запускают пересборку проекта
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
soft-ue-cli управляет Unreal Engine 5 из терминала и из MCP-клиента. Один пакет Python дает агенту больше 120 команд: Claude Code, Cursor или Windsurf создают акторы на уровне, правят блупринты, материалы, MetaSound и StateTree, собирают экраны UMG, запускают сессии Play-In-Editor и снимают скриншоты вьюпорта. Размер и цветность снимка настраиваются, чтобы тратить меньше токенов. Живые команды идут в запущенный редактор через плагин SoftUEBridge: он поднимает HTTP-сервер внутри процесса Unreal и принимает вызовы JSON-RPC. Когда редактор закрыт, работают офлайн-команды: они разбирают и сравнивают файлы `.uasset`, читают и проверяют `.ini`, `.uproject` и `BuildConfiguration.xml`. Режим `mcp-serve` публикует те же команды как инструменты MCP. Встроенные скиллы-промпты ведут агента через длинные сценарии: перенос блупринта в C++, сборка интерфейса UMG, наполнение уровня по картинке, восстановление бинарных ассетов после конфликта слияния.
Для кого. Разработчикам игр на Unreal Engine 5, которые поручают агенту рутину в редакторе: расстановку акторов, правку блупринтов, сборку интерфейса и прогон PIE в CI.
Подходит, если
- Сцену нужно собрать по референсной картинке: скилл `level-from-image` подбирает ассеты проекта, расставляет акторы партией и сверяется со скриншотами вьюпорта
- Блупринт пора переписать на C++, а ручной перенос графа занимает дни: скилл `blueprint-to-cpp` генерирует заголовок и реализацию
- Экран интерфейса собирают в UMG и сразу проверяют в PIE: скилл `author-umg` фиксирует имена виджетов и сравнивает раскладку
- В Git или Perforce случился конфликт бинарных `.uasset`, и надо понять, что изменилось: `asset diff-file` показывает отличия без запуска редактора
- Несколько сессий агента работают с одним редактором и мешают друг другу: группа команд `session` ведет общий реестр сессий
- Регрессию в пакетной сборке `Development` проверяет CI: `runtime smoke-plan` выдает план проверки
Не подходит, если
- Проект на Unreal Engine 5.8, и официальный MCP от Epic закрывает ваш сценарий: README сам советует брать его в таком случае
- Проект сделан на Unity или Godot: пакет работает только с Unreal Engine
- Агент должен управлять финальной релизной сборкой: мост описан для сборок `Development` и `DebugGame`
- Нужна только правка текстового конфига без Unreal: хватит обычного редактора, а офлайн-команды `config` окупаются на больших иерархиях слоев
Пример запроса к агенту
Подключи soft-ue-cli к проекту в этой папке, запусти редактор и расставь на уровне пять точек старта игрока по сеткеОграничения
- Живые команды работают только при запущенном редакторе или собранной игре с плагином SoftUEBridge. Плагин копируют в проект, подключают в `.uproject` и пересобирают проект.
- Основная цель разработки сейчас Unreal Engine 5.8, совместимость с 5.7 поддерживается.
- Часть команд требует дополнительных плагинов Unreal. Без них мост возвращает ошибку `plugin_unavailable`.
- Число команд в README указано приблизительно, точный список выдает `soft-ue-cli commands --json`.
Как отключить. Уберите запись SoftUEBridge из `.uproject`, удалите папку плагина из проекта и пересоберите его. Пакет Python снимает команда `pip uninstall soft-ue-cli`, а сервер MCP достаточно удалить из конфигурации клиента.
Частые вопросы
Как подключить soft-ue-cli к Claude Code?
Установите пакет командой `pip install soft-ue-cli` и запустите `soft-ue-cli setup /путь/к/проекту` внутри Claude Code. Команда печатает шаги, и агент сам копирует плагин и правит `.uproject`. После пересборки и запуска редактора `soft-ue-cli check-setup` должен показать три отметки OK.
Как добавить soft-ue-cli в Cursor или Claude Desktop как MCP-сервер?
Поставьте пакет с дополнением `pip install soft-ue-cli[mcp]` и впишите в конфигурацию клиента сервер с командой `soft-ue-cli` и аргументом `mcp-serve`. Транспорт stdio, ключи не нужны.
Что делать, если check-setup не видит мост?
Проверьте, что редактор запущен и в журнале есть строка `LogSoftUEBridge: Bridge server started on port 8080`. Если мост слушает другой порт или стоит на другой машине, задайте `SOFT_UE_BRIDGE_PORT` или `SOFT_UE_BRIDGE_URL`.
Чем soft-ue-cli отличается от официального MCP Unreal Engine 5.8?
Это отдельный слой: пакет работает и как обычный CLI для терминала и CI, читает `.uasset` без редактора и подключается к сборкам `Development`. Встроенный MCP Epic удобнее там, где он закрывает нужный вам сценарий.
Как узнать, какие команды доступны в моей версии?
`soft-ue-cli commands --json` выдает каталог команд с требованиями к редактору, PIE и дополнительным плагинам, а `soft-ue-cli skills list` показывает встроенные скиллы.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMCP-сервер для Unreal Editor: агент правит уровни, Blueprint и материалы, собирает проект обычными фразами
MCP-сервер, который позволяет агенту управлять редактором Unreal Engine словами: акторы, блупринты, узлы графа, камера
Unreal MCP на Python: 253 действия в 21 области, от акторов и Blueprint до материалов и кинематографики, плюс выполнение любого Python в редакторе
MCP-сервер для Unreal Engine: управление ассетами, акторами, редактором, секвенсором и блупринтами
Плагин Unreal Engine с MCP-сервером: Claude и Cursor создают блупринты, спавнят объекты и запускают команды редактора
Плагин Unreal Engine с MCP: агент ведет редактор через язык запросов RQL, правит Blueprint и C++, снимает кадры вьюпорта, есть облако и свой сервер
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| soft-ue-cli (эта карточка) | нет | 216 | ||
| Unreal MCP | нет | не нужна | 2 115 | MCP-сервер без отдельного режима CLI и без офлайн-разбора файлов `.uasset` |
| UnrealClaude | нет | не нужна | 1 031 | плагин, который встраивает Claude Code в сам редактор Unreal Engine 5.7 |
Коротко о README
Страница начинается с описания двух путей подключения, живого через мост в редакторе и офлайн-разбора файлов. Дальше идут быстрый старт из пяти шагов, схема работы, таксономия команд и справочник по группам: акторы, блупринты, ассеты, материалы, ткань, PIE, профилирование, StateTree, UMG. В конце собраны примеры вызовов, переменные окружения для моста и сравнение со встроенным Remote Control API Unreal.