프로젝트 소개

Unreal Engine 5용 uasset-workbench 플러그인은 외부 스크립트와 AI 에이전트가 에디터를 열지 않고도 바이너리 .uasset 파일과 상호작용할 수 있는 커맨드 라인 기반 워크플로우를 제공합니다. 이 플러그인은 엔진 데이터를 Intermediate/UAssetExport 경로 아래의 JSON으로 구조화하며, 블루프린트, 애니메이션 에셋, 위젯 레이아웃, 데이터 테이블, 머티리얼, 텍스처, Niagara 시스템, 비헤이비어 트리 및 레벨 액터를 포함합니다. 작업은 Export, Import, Edit, Migrate, Audit으로 그룹화되며, 각각 0-3 사이의 상태 코드를 반환하는 통합 계약을 통해 액세스할 수 있습니다. 플러그인은 열려 있는 에디터 세션 내에서 실행하거나 에디터가 닫혀 있을 때 헤드리스 커맨드렛을 실행할 수 있으며, 쓰기 전용 그룹은 에디터가 실행 중이어야 합니다. 내보낸 JSON에는 버전 및 유형 필드가 포함되며, 노드 연결, 변수 메타데이터, 애니메이션 커브, 머티리얼 표현식 체인 및 위젯 트리 속성과 같은 세부 정보가 보존됩니다. Import 및 Edit 커맨드렛은 에셋을 수정하거나 재생성하기 위해 spec JSON을 수락하며, Migrate는 이름 변경 후 참조 리다이렉션을 수정하고, Audit은 커밋 게이트로 사용할 수 있는 읽기 전용 보고서를 생성합니다. 래퍼 스크립트를 통해 엔진 경로, 프로젝트 파일, 실행 이름, 에셋 목록 및 선택적 타임아웃을 전달하여 호출을 단순화할 수 있습니다. 이러한 설계는 AI 지원 개발 파이프라인을 위한 버전 제어 가능하고 재현 가능한 변경 및 UE5 콘텐츠의 자동 감사를 가능하게 합니다.