TornLux/UnrealBridge

해결하는 문제

UnrealBridge는 AI 에이전트(코드 어시스턴트 등)가 Unreal Engine 프로젝트를 직접적이고 안정적으로 검사하고 수정할 방법이 없다는 문제를 해결합니다. 이 플러그인은 에이전트에게 에셋, 블루프린트 그래프, 애니메이션, Niagara 효과 등을 쿼리하고 편집할 수 있는 타입 지정 작업 세트(Python 함수를 통해)를 제공하며, 실시간 업데이트와 실행 취소 기능을 지원하는 구조화된 브리지 역할을 합니다.

작동 방식

이 브리지는 Unreal Editor 내에서 플러그인으로 실행됩니다. 로컬 서버를 시작하면 에이전트의 Python 클라이언트가 TCP를 통해 연결됩니다. 에이전트가 Python 코드로 명령을 보내면, 브리지는 26개 라이브러리에 걸친 1388개 함수로 구성된 생성된 매니페스트를 기반으로 로컬에서(AST 사전 검증을 사용하여) 명령을 검증하여 에디터에 도달하기 전에 오류를 잡아냅니다. 명령은 게임 스레드에서 실행되고 결과가 반환됩니다. 또한 브리지는 반응형 이벤트 구독을 지원하므로 에이전트는 폴링 없이 이벤트 발생 시 알림을 받을 수 있습니다. 브리지 라이브러리는 애니메이션, 블루프린트 편집, Niagara VFX, 에셋 관리 등 특정 영역을 포괄합니다.

대상 사용자

LLM 기반 에이전트(Claude Code, Codex, Gemini CLI 등)가 애니메이션 블루프린트 생성, Niagara 효과 설정, 블루프린트 그래프 편집, 게임플레이 검증 등 Unreal Engine 프로젝트에서 복잡한 작업을 수행해야 하는 개발자 및 AI 지원 워크플로우를 위한 도구입니다. Windows 환경의 대화형 에디터 세션을 위해 구축되었으며 UE 5.3+를 지원합니다.

주요 특징

• AST 기반 환각 방지: Python 코드를 파싱하고 매니페스트와 대조하는 사전 검증을 통해 테스트에서 브리지 호출 실패율을 24%에서 16%로 낮췄습니다.
• 심층적인 에셋 구조 검사 및 쓰기 작업: 애니메이션, 블루프린트 그래프, Niagara 등을 위한 라이브러리와 자동 레이아웃 및 품질 도구를 제공합니다.
• 반응형 이벤트 구독: 에이전트가 엔진 이벤트를 구독하고 폴링 없이 콜백을 받을 수 있습니다.
• 네이티브 Python 실행: 26개 라이브러리에 걸친 1388개 함수를 제공하며, 모든 작업은 실행 취소/다시 실행을 위해 트랜잭션으로 래핑됩니다.
• Agent Skills와의 쉬운 통합: Agent Skills 오픈 표준을 따르는 Claude Code 및 기타 런타임을 위한 스킬을 제공합니다.