TornLux/UnrealBridge

무엇을 해결하는가

UnrealBridge는 AI 에이전트가 Unreal Engine 에디터를 실시간으로 제어하고 편집할 수 있도록 구조화된 인터페이스를를 제공합니다. 이는 에이전트의 고수준 요청과 Unreal Engine의 복잡하고 종종 비공개인 내부 API 사이의 간극을 메워주며, 엄격한 검증 및 타입화된 작업 표면을 통해 에이전트 주도 수정의 실패율을 낮춥니다.

작동 방식

시스템은 Unreal Engine (5.3+)을 위한 C++ 플러그인과 Python 기반 클라이언트로 구성됩니다. 에이전트는 Python CLI (bridge.py)와 상호작용하며, 이 CLI는 명령이 TCP/JSON을 통해 에디터로 전송되기 전에 1,388개의 사용 가능한 함수 매니페스트를 대상으로 AST 기반 "preflight" 체크를 수행하여 환각(hallucination) 및 인자 오류를 포착합니다. Unreal Engine 내부에서는 서버가 이러한 명령을 GameThread로 전달하며, 여기서 네이티브 Python API 또는 특화된 UnrealBridge*Library C++ 래퍼를 통해 실행됩니다. 또한 브릿지는 반응형 이벤트 구독을 지원하여, 에디터가 폴링 없이도 에셋 변경이나 액터 라이프사이클과 같은 이벤트를 에이전트에게 선제적으로 알릴 수 있게 합니다.

대상 사용자

이 도구는 게임 개발, 자동화 테스트 및 NPC 프로토타이핑을 위한 AI 에이전트를 구축하는 개발자 중, Unreal Engine 에셋, 블루프린트 및 월드 상태를 프로그래밍 방식으로 조작할 수 있는 신뢰할 수 있는 방법이 필요한 사람들을 위해 설계되었습니다.

주요 특징

• 환각 방어: 엔진에 도달하기 전에 호출을 검증하기 위해 로컬 AST 파싱과 함수 매니페스트를 사용하며, 이를 통해 호출 실패율을 크게 낮춥니다.
• 심층 에셋 조사: Animation Blueprints, 상태 머신 및 에셋 종속성 트리를 포함한 포괄적인 읽기/쓰기 액세스를 제공합니다.
• VFX 및 리깅 워크플로우: Control Rig 계층 구조, IK Retargeters 및 Niagara VFX 시스템을 작성하기 위한 전용 라이브러리를 제공합니다.
• 블루프린트 품질 툴링: 자동 레이아웃, 고아/이름 없는 노드에 대한 린팅, 함수로의 서브그래프 추출과 같은 고급 그래프 조작 도구를 포함합니다.
• 반응형 이벤트 시스템: GAS 이벤트, 속성 변경 및 에디터 측 에셋 수정에 대한 선제적 콜백을 지원합니다.
• 네이티브 Python 통합: 26개의 특화된 라이브러리를 unreal.* API에 대한 직접 액세스와 결합하여, 전체 Undo/Redo를 지원하는 트랜잭션 내에 래핑하여 제공합니다.