UnrealBridge — скилл
UnrealBridge дает ИИ-агенту управление редактором Unreal Engine: ассеты, Blueprint, анимации и уровень с откатом каждой правки.
- 313 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент исполняет произвольный Python-код внутри редактора с правами проекта
- Записи меняют ассеты и уровни проекта
- Сервер моста слушает порт; поиск по сети включается отдельно и защищается токеном
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/unrealbridgeОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент исполняет произвольный Python-код внутри редактора с правами проекта
- Записи меняют ассеты и уровни проекта
- Сервер моста слушает порт; поиск по сети включается отдельно и защищается токеном
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
UnrealBridge соединяет агента с запущенным редактором Unreal Engine 5.3 и новее. Плагин поднимает локальный TCP-сервер, а скрипт `bridge.py` из скилла отправляет в редактор Python-код. 26 библиотек с 1388 функциями покрывают ассеты и ссылки между ними, Blueprint, граф анимации, Control Rig, Niagara, материалы, уровень и запуск в режиме игры. Перед отправкой скрипт проходит локальную проверку: `bridge_preflight.py` разбирает вызовы по манифесту и отсекает несуществующие функции и неверные аргументы без обращения к редактору. Правки уровня оборачиваются в транзакции и отменяются через Undo, подписки на события вызывают агента сами.
Для кого. Разработчикам игр на Unreal Engine, которые отдают агенту рутину: правку Blueprint, настройку анимаций и разбор зависимостей ассетов.
Подходит, если
- Надо перечислить все точечные источники света на уровне или сдвинуть объект.
- Blueprint требует компиляции и проверки на ошибки, а граф узлов надо разложить автоматически.
- Нужен автомат состояний анимации с условиями переходов, собранный с нуля.
- Перед удалением ассета хочется увидеть прямые и обратные ссылки на него.
Не подходит, если
- Редактор закрыт или запущен в режиме commandlet: модуль в нем отключен.
- Нужна работа на Unity, Godot или другом движке.
- Проект нельзя открывать даже локальному агенту с правом выполнять Python в редакторе.
Пример запроса к агенту
Покажи все PointLight текущего уровня, подними PlayerStart на 200 единиц и скомпилируй `/Game/Blueprints/BP_Character` с отчетом об ошибках.Ограничения
Мост работает только в интерактивной сессии редактора. Плагин и скилл копируются в проект скриптом `sync_project.bat`, а для Codex, Gemini CLI, OpenCode и Cursor сначала создают ссылку `.agents/skills` скриптом `link_agents_skills.bat`. Сборка плагина идет вместе с проектом, нужна версия Unreal Engine 5.3 или новее с включенным Python. Скрипты запускаются в редакторе с правами проекта, поэтому открытые ассеты и уровни перед сеансом стоит сохранить в системе контроля версий.
Как отключить. Закройте редактор, удалите `Plugins/UnrealBridge` и скопированный каталог `unreal-bridge` из `.claude/skills` и `.agents/skills` проекта, затем пересоберите проект. Сервер моста запускается только вместе с плагином.
Частые вопросы
Как проверить, что мост работает?
Запустите `bridge.py ping`: при живом редакторе придет ответ `pong`. В логе редактора должна быть строка `LogUnrealBridge: Listening on 127.0.0.1`.
Можно ли отменить правки агента?
Да, правки уровня выполняются в транзакциях `FScopedTransaction`, поэтому доступны стандартные Undo и Redo редактора.
Как подключить несколько редакторов?
Команда `bridge.py list-editors` перечисляет редакторы на этой машине, а флаг `--project=` выбирает нужный. Поиск по локальной сети включается явно через `--discovery-scope=lan`.
Что делает проверка перед отправкой?
`bridge_preflight.py` разбирает скрипт как Python AST и сверяет вызовы с манифестом. Неизвестные функции и неверные аргументы отсекаются локально, без обращения к редактору.
Нужна ли установка для Claude Code?
Скопируйте каталог `.claude/skills/unreal-bridge` в `~/.claude/skills/` или в `.claude/skills/` проекта. Для остальных агентов сначала создают ссылку `.agents/skills`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыMCP-сервер для Unreal Engine: управление ассетами, акторами, редактором, секвенсором и блупринтами
Python-CLI и MCP-сервер, через которые агент создает акторы, правит блупринты и запускает PIE в Unreal Engine 5
Плагин Unreal Engine с MCP: агент ведет редактор через язык запросов RQL, правит Blueprint и C++, снимает кадры вьюпорта, есть облако и свой сервер
Плагин Unreal Engine с MCP-сервером: Claude и Cursor создают блупринты, спавнят объекты и запускают команды редактора
MCP-сервер для Unreal Editor: агент правит уровни, Blueprint и материалы, собирает проект обычными фразами
Плагин и набор скиллов для Unreal Engine 5: агент вызывает функции движка и правит свойства объектов в запущенном редакторе.
Коротко о README
Проект состоит из плагина `Plugin/UnrealBridge` для редактора и скилла с клиентом `bridge.py`, манифестом функций и вспомогательными скриптами перезапуска редактора.