UnrealBridge — скилл

UnrealBridge дает ИИ-агенту управление редактором Unreal Engine: ассеты, Blueprint, анимации и уровень с откатом каждой правки.

  • 313 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Широкий доступ

Почему такой уровень

  • Агент исполняет произвольный Python-код внутри редактора с правами проекта
  • Записи меняют ассеты и уровни проекта
  • Сервер моста слушает порт; поиск по сети включается отдельно и защищается токеном
Все причины и проверки

tornlux/unrealbridge

Установка

В терминале, через 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: управление ассетами, акторами, редактором, секвенсором и блупринтами

MCP-серверШирокий доступ1 тыс.Звезды репозитория

Python-CLI и MCP-сервер, через которые агент создает акторы, правит блупринты и запускает PIE в Unreal Engine 5

CLIШирокий доступ216Звезды репозитория

Плагин Unreal Engine с MCP: агент ведет редактор через язык запросов RQL, правит Blueprint и C++, снимает кадры вьюпорта, есть облако и свой сервер

MCP-серверШирокий доступ60Звезды репозитория

Плагин Unreal Engine с MCP-сервером: Claude и Cursor создают блупринты, спавнят объекты и запускают команды редактора

MCP-серверШирокий доступ686Звезды репозитория

MCP-сервер для Unreal Editor: агент правит уровни, Blueprint и материалы, собирает проект обычными фразами

MCP-серверШирокий доступ495Звезды репозитория

Плагин и набор скиллов для Unreal Engine 5: агент вызывает функции движка и правит свойства объектов в запущенном редакторе.

СкиллШирокий доступ130Звезды репозитория

Коротко о README

Проект состоит из плагина `Plugin/UnrealBridge` для редактора и скилла с клиентом `bridge.py`, манифестом функций и вспомогательными скриптами перезапуска редактора.

Бейдж для README

Сообщить о проблеме