blender-unreal-asset-bridge의 기능
blender-unreal-asset-bridge는 완성된 씬을 Unreal Engine으로 간편하게 전송할 수 있도록 지원하는 Blender 애드온입니다. 에셋을 하나씩 내보내고 설정을 수동으로 다시 구성하는 대신, Blender에서 에셋을 표시한 후 한 번에 일괄 내보내 Unreal Engine 파이프라인에 맞는 폴더 트리를 생성할 수 있습니다.
이 애드온은 스태틱 메시, 스켈레탈 메시, Action 애니메이션, NLA 트랙, Alembic 캐시, 스플라인, 카메라, 콜리전, 소켓 및 Sequencer 콘텐츠를 내보낼 수 있습니다. 또한 내보낸 구조를 Unreal Engine Content Browser에 재구성하는 Python 가져오기 스크립트도 생성합니다.
이 프로젝트는 Windows x64, Blender 4.2 이상, Unreal Engine 4 또는 5를 대상으로 합니다. 생성된 가져오기 스크립트를 사용하려면 Unreal Engine 4.26 이상이 필요합니다.
주요 기능
- 씬 일괄 내보내기: 전체 환경, 캐릭터 세트 또는 시네마틱 씬을 한 번에 내보냅니다.
- 메시 및 애니메이션 지원: 스태틱 메시, 스켈레탈 메시, 선택한 Action, NLA 트랙, 모프 타깃 및 Alembic 캐시를 내보냅니다.
- Blender에서 제작하는 콜리전 및 소켓: 내보내기 전에 박스, 볼록, 구 또는 캡슐 형태의 콜리전과 소켓을 생성합니다.
- 내보내기 전 검증: 오류 검사기가 이름, 스케일, 머티리얼 및 애니메이션 문제를 식별하며, 일부 문제는 한 번의 클릭으로 수정할 수 있습니다.
- 생성된 Unreal 가져오기 스크립트: 생성된 Python 스크립트로 Content Browser 구조를 재구성합니다.
- 시네마틱 전송: 컷, 종횡비, 초점 거리 및 렌즈 시프트를 유지한 Level Sequence로 카메라와 Sequencer 콘텐츠를 내보냅니다.
- 클립보드 워크플로: 카메라, 스플라인 및 소켓을 복사하여 Unreal Engine에 바로 붙여넣습니다.
- AI 지원: OpenAI 호환 공급자와 모델을 연결하면 대화 방식으로 반복적인 이름 지정, 검사 및 내보내기 작업을 처리할 수 있습니다.
Blender 애드온 설치
1. Windows 릴리스 다운로드
프로젝트 릴리스 페이지에서 릴리스 ZIP 파일을 다운로드합니다. 이 패키지는 Windows x64 및 Blender 4.2 이상을 대상으로 합니다.
2. ZIP 파일 차단 해제
Windows에서 다운로드한 ZIP 파일을 차단된 파일로 표시할 수 있습니다. PowerShell을 열고 다음 명령을 실행합니다. 파일이 다른 위치에 저장되어 있다면 경로를 조정하십시오.
powershell Unblock-File -Path "$HOME\Downloads\blender-unreal-asset-bridge.zip"3. Blender 환경 설정에서 설치
- Blender를 엽니다.
- Edit > Preferences > Get Extensions로 이동합니다.
- 확장 기능 메뉴를 열고 Install from Disk를 선택합니다.
- 다운로드한 ZIP 파일을 선택합니다.
- blender-unreal-asset-bridge를 활성화합니다.
애드온을 활성화한 후 Blender 3D 뷰포트를 열고 N 키를 눌러 사이드바를 표시한 다음 blender-unreal-asset-bridge 패널을 선택합니다.
4. 어시스턴트 연결 구성
AI 공급자를 선택하고 연결 정보를 입력한 다음 모델을 선택합니다. 구성 패널에는 공급자 엔드포인트와 키가 표시됩니다. Blender 내부에서 메시지를 보내거나 Open Studio Window를 선택할 수 있습니다.
Studio Window 또는 외부 클라이언트를 사용하는 동안 Blender를 실행 상태로 유지하십시오. 두 워크플로 모두 활성 Blender 세션과 통신합니다.
내보낼 씬 준비
Blender 씬을 Unreal Engine으로 전송할 에셋과 컬렉션에 맞게 구성합니다. 여기에는 환경 프롭, 캐릭터 메시, 애니메이션 Action, 콜리전 오브젝트, 소켓, 카메라 및 시네마틱 데이터가 포함될 수 있습니다.
내보내기 전에 대상 프로젝트에 맞는 옵션을 결정합니다.
- 대상 엔진을 Unreal Engine 5로 설정하거나, 필요한 경우 Unreal Engine 4를 선택합니다. 생성된 가져오기 스크립트는 Unreal Engine 4.26 이상에서 지원됩니다.
- 일반적인 메시 워크플로에는 FBX를 사용하고, 캐시 및 시뮬레이션 기반 메시에는 Alembic을 선택합니다.
- Blender 단위를 Unreal Engine 스케일로 변환하려면 Unit scale을 Auto로 유지합니다.
- Unreal Engine 규칙에 맞게 회전, 피벗 및 기타 변환을 처리하려면 Axis transform을 Auto로 유지합니다.
- 개별 애니메이션을 내보내려면 Actions를 선택하고, 하나의 혼합 트랙을 내보내려면 NLA로 전환합니다.
- 특별한 이유가 없다면 Error checker 및 Import script 옵션을 활성화합니다.
기본 일괄 내보내기 실행
환경 팩 내보내기
- 환경 프롭이 포함된 컬렉션을 표시하거나 선택합니다.
- 단위 스케일, 축 변환, 이름 지정, 콜리전 및 소켓 설정을 검토합니다.
- 내보내기 전에 오류 검사를 실행합니다.
- 보고된 문제를 해결하거나 사용할 수 있는 원클릭 수정 기능을 적용합니다.
- 일괄 내보내기를 시작합니다.
- 생성된 출력 폴더를 열고 에셋이 Unreal에 바로 사용할 수 있는 폴더 트리로 구성되었는지 확인합니다.
내보내기는 Unreal Engine용으로 구성된 구조에 씬 에셋을 디스크에 기록합니다. 스태틱 메시에는 Blender에서 제작한 콜리전과 소켓을 포함할 수 있으므로 엔진에서 콜리전을 다시 제작하는 작업을 줄일 수 있습니다.
캐릭터와 애니메이션 내보내기
- 내보낼 스켈레탈 메시와 작업을 선택합니다.
- 선택한 애니메이션을 각각 내보내려면 Actions를 선택하고, 하나의 혼합 애니메이션 트랙으로 내보내려면 NLA를 선택합니다.
- 오류 검사기를 실행하여 애니메이션, 스케일, 이름 지정 또는 설정 문제를 확인합니다.
- 내보내기를 시작한 후 생성된 스켈레탈 메시, 스켈레톤, 애니메이션 및 모프 타깃 파일을 확인합니다.
- 생성된 가져오기 스크립트를 사용하여 해당 Unreal Engine 콘텐츠 구조를 재구성합니다.
카메라 및 시네마틱 콘텐츠 내보내기
카메라 리그와 해당 Sequencer 콘텐츠를 내보내기에 포함합니다. 생성된 Unreal 가져오기 스크립트는 컷, 화면비, 초점 거리 및 렌즈 시프트를 유지하면서 시네마틱을 Level Sequence로 재구성할 수 있습니다. 또는 카메라를 클립보드에 복사한 다음 Unreal Engine Sequencer에 직접 붙여 넣을 수 있습니다.
생성된 파일을 Unreal Engine으로 가져오기
- 에셋을 받을 Unreal Engine 프로젝트를 엽니다.
- 애드온에서 생성한 Python 가져오기 스크립트를 찾습니다.
- Unreal Engine Python 콘솔을 엽니다.
- 생성된 스크립트를 실행합니다.
- 콘텐츠 브라우저에서 재생성된 폴더 구조와 가져온 에셋을 확인합니다.
생성된 스크립트에는 Unreal Engine 4.26 이상이 필요합니다. 스크립트를 실행해도 아무 작업이 수행되지 않는 것처럼 보이면 엔진의 Python 콘솔에서 실행 중인지, 그리고 엔진 버전이 요구 사항을 충족하는지 확인합니다.
구성 참조
- 대상 엔진: 기본값은 Unreal Engine 5이며 Unreal Engine 4도 지원합니다.
- 내보내기 형식: 기본값은 FBX이며, 캐시 및 시뮬레이션 기반 메시에는 Alembic을 사용할 수 있습니다.
- 단위 스케일: 기본값은 자동이며 Blender 단위를 Unreal Engine 스케일로 변환합니다.
- 축 변환: 기본값은 자동이며 Unreal Engine 규칙에 맞게 변환과 피벗을 조정합니다.
- 애니메이션 모드: 기본값은 Actions이며 혼합 트랙에는 NLA를 사용할 수 있습니다.
- 충돌 셰이프: 박스, 볼록, 구 및 캡슐.
- 가져오기 스크립트: 기본적으로 활성화되어 Unreal Engine Python 스크립트를 생성합니다.
- 오류 검사기: 기본적으로 활성화되어 이름 지정, 스케일, 머티리얼 및 애니메이션 설정을 검사합니다.
- Provider: 기본값은 OpenAI 호환 방식이며, 패널에서 엔드포인트 URL과 키를 설정합니다.
- Model: 채팅 기반 작업에 사용할 모델을 선택합니다.
고급 워크플로 팁
Unreal 가져오기 문제를 해결하기 전에 검증하기
중요한 내보내기 작업을 수행하기 전에 항상 오류 검사기를 실행합니다. 단위, 축, 피벗, 이름 지정, 머티리얼 또는 애니메이션 설정 문제는 파일이 엔진에 도달하기 전에 Blender에서 해결하는 편이 쉽습니다. 가능하면 Unreal Engine에서 가져오기 결과를 직접 분석하기보다 검사기의 원클릭 복구 기능을 사용합니다.
자동 변환을 기준으로 사용하기
대부분의 프로젝트에서는 단위 스케일과 축 변환을 Auto로 유지합니다. 에셋의 스케일이나 회전이 잘못된 상태로 가져와지면 가져온 모든 에셋을 수동으로 수정하지 말고 오류 검사기를 다시 실행하여 검사기가 식별한 오브젝트를 확인합니다.
애니메이션 모드를 신중하게 선택하기
스켈레탈 메시와 함께 선택한 애니메이션을 개별 내보내기로 전송하려면 Actions를 사용합니다. 원본 장면이 하나의 혼합 트랙으로 구성되어 있고 이를 결합된 애니메이션 시퀀스로 내보내려면 NLA를 사용합니다.
이름 지정과 대상 구조를 일관되게 유지하기
애드온은 이름 지정 규칙을 유지하고 Unreal에 맞는 폴더 트리를 생성합니다. 메시, 충돌, 소켓, 애니메이션 및 컬렉션에 일관된 이름을 사용하면 생성된 가져오기 스크립트를 검토하기 쉽고 결과적으로 콘텐츠 브라우저도 관리하기 쉬워집니다.
일상적인 작업에 AI 어시스턴트 사용하기
Provider와 Model을 설정한 후 Blender에서 이름 지정, 검사 또는 내보내기 설정 조정과 같은 일상적인 작업을 설명합니다. Studio Window 또는 외부 클라이언트를 사용하는 동안에는 Blender를 열어 두어 어시스턴트가 활성 애드온 세션과 통신할 수 있도록 합니다.
문제 해결
ZIP이 설치되지 않음
다음 명령으로 다운로드한 파일의 차단을 해제합니다.
powershell Unblock-File -Path "$HOME\Downloads\blender-unreal-asset-bridge.zip"그런 다음 Blender의 확장 프로그램 설치 관리자로 돌아가 ZIP을 다시 설치합니다.
패널이 표시되지 않음
Edit > Preferences > Get Extensions에서 애드온이 활성화되어 있는지 확인합니다. 또한 Windows x64에서 Blender 4.2 이상을 사용하고 있는지 확인합니다.
에셋의 스케일이나 회전이 잘못됨
단위 스케일과 축 변환을 Auto로 설정한 상태에서 오류 검사기를 다시 실행합니다. 오류 검사기는 변환 체인을 손상시키는 오브젝트를 식별하도록 설계되었습니다.
가져오기 스크립트가 아무 작업도 수행하지 않음
Unreal Engine 버전이 4.26 이상인지 확인하고 엔진의 Python 콘솔에서 생성된 스크립트를 실행합니다.
AI 어시스턴트가 응답하지 않음
N 패널에서 Provider 엔드포인트, API 키 및 Model 이름을 확인합니다. Studio 또는 외부 클라이언트가 애드온과 통신하는 동안 Blender를 열어 두어야 합니다.
결론
blender-unreal-asset-bridge는 수동으로 진행하던 Blender에서 Unreal로의 전송 작업을 반복 가능한 파이프라인으로 바꿉니다. Windows 애드온을 설치하고 장면을 준비 및 검증한 다음 필요한 에셋을 일괄 내보내고 생성된 Unreal Engine Python 스크립트를 실행합니다. 자동 변환, Blender에서 작성한 충돌 및 소켓, 애니메이션 지원, 시네마틱 전송 및 선택적 AI 지원을 통해 에셋 준비는 Blender에서 유지하면서 반복적인 가져오기와 설정 작업을 줄일 수 있습니다.
