언리얼 에셋을 다른 프로젝트로 옮길 때, 의존 파일부터 확인하세요

에셋 이전을 표현한 건축 소품 상자 — GPT 생성 이미지
에셋 이전을 표현한 건축 소품 상자. GPT가 생성한 설명용 콘셉트 이미지입니다.

다른 프로젝트에서 쓰던 소품을 가져왔더니 형태만 오고 표면이 회색 기본 재질로 나옵니다. 파일을 폴더째 복사해 넣었는데 에디터에서 참조가 끊겼다는 경고가 뜨기도 합니다. 대부분 에셋 하나에 딸린 의존 파일이 같이 오지 않아서 생깁니다.

핵심은 이것입니다. 에셋 파일을 탐색기에서 복사하는 대신 콘텐츠 브라우저의 Migrate 를 쓰면, 엔진이 의존 파일 목록을 스스로 모아 함께 복사합니다.

옮기기 전에 Reference Viewer 로 딸린 파일을 봅니다

옮기기 전에 원본 소품과 표면 자료를 확인하는 설명용 이미지

▲ Reference Viewer 는 왼쪽에 참조하는 에셋, 오른쪽에 참조되는 에셋을 늘어놓는다

콘텐츠 브라우저에서 에셋을 오른쪽 클릭하고 Reference Viewer 를 고르면 관계 그래프가 열립니다. 공식 문서 설명대로 왼쪽에는 선택한 에셋을 참조하는 에셋이, 오른쪽에는 선택한 에셋이 참조하는 에셋이 놓입니다. 화살표는 참조되는 쪽을 가리킵니다.

여기서 오른쪽에 늘어선 것이 함께 가야 할 의존 파일입니다. 그래프 안의 노드를 오른쪽 클릭하면 Size Map 과 Audit Assets 을 열 수 있습니다. Size Map 은 에셋과 의존 파일의 용량 비중을 보여 주고, Audit Assets 은 상세 정보를 Settings 메뉴에서 csv 로 내보낼 수 있습니다.

Asset Actions 의 Migrate 로 복사합니다

콘텐츠 브라우저에서 옮길 에셋을 고릅니다. 여러 개를 고를 때는 Ctrl 클릭으로 하나씩, Shift 클릭으로 구간을 지정합니다. 선택한 에셋을 오른쪽 클릭하고 Asset Actions 안의 Migrate 를 누릅니다.

Asset Report 목록은 지우지 않고 지나갑니다

대상 프로젝트 안의 콘텐츠 폴더를 고르는 설명용 이미지

▲ Asset Report 창에 함께 복사될 의존 파일이 모두 나열된다

Migrate 를 누르면 Asset Report 창이 열리고, 함께 복사될 에셋이 의존 파일까지 포함해 나열됩니다. 체크를 해제해 일부를 뺄 수는 있지만, 공식 문서는 그렇게 하면 그 파일에 의존하던 에셋이 깨질 수 있다고 밝히고 있습니다. 표면이 회색으로 오는 사고는 대개 이 단계에서 항목을 뺐을 때 생깁니다.

목록을 확인했으면 OK 를 누릅니다. 파일 탐색 창이 뜨면 옮겨 갈 프로젝트의 Content 폴더를 찾아 선택하고 Select Folder 를 누릅니다. Content 폴더가 아닌 곳을 고르면 그래도 진행할지 묻는 경고가 나옵니다.

이름이 겹칠 때와 끝난 뒤 확인

이동 전후 소품의 형태와 표면을 비교하는 설명용 이미지

▲ 복사가 끝난 뒤 대상 프로젝트에서 형태와 표면을 함께 확인한다

같은 이름의 에셋이 대상에 이미 있으면 덮어쓸지 건너뛸지 묻습니다. 항목이 많을 때는 Yes All 과 No All 로 한 번에 처리합니다. 성공하면 확인 창이 뜨고, Show Message Log 를 누르면 실제로 옮겨진 에셋 전체 목록을 볼 수 있습니다.

복사가 덜 됐는지 경로가 어긋났는지 가르는 법

대상 프로젝트에서 소품을 열었을 때 텍스처 자리가 비어 있고 참조 경고가 뜬다면, Asset Report 에서 항목을 뺐을 가능성이 큽니다. 원본으로 돌아가 Migrate 를 다시 실행하고 목록을 그대로 둔 채 진행하면 됩니다.

반면 파일은 다 있는데 폴더 구조만 원본과 달라졌다면 Content 폴더가 아닌 하위 폴더를 목적지로 고른 경우입니다. Migrate 는 원본의 폴더 경로를 그대로 재현하므로, 목적지는 언제나 프로젝트 최상단의 Content 폴더여야 합니다.

자주 묻는 질문

Q. 엔진 버전이 다른 프로젝트로도 옮길 수 있나요?

Migrate 는 에셋 파일을 복사하는 기능이라 대상 프로젝트가 그 에셋을 열 수 있는 버전이어야 합니다. 대상 쪽 버전이 더 낮으면 열리지 않을 수 있으니 먼저 버전을 맞추는 편이 안전합니다.

Q. 레벨을 통째로 옮기면 배치된 소품도 따라오나요?

레벨 에셋을 선택해 Migrate 하면 그 레벨이 참조하는 메시와 재질이 Asset Report 에 함께 잡힙니다. 목록 분량이 커지므로 옮기기 전에 Size Map 으로 용량을 먼저 가늠해 두면 좋습니다.

Q. 반대로 필요 없는 에셋이 딸려 오는 것은 어떻게 줄이나요?

원본에서 Reference Viewer 로 어떤 참조가 붙어 있는지 보고, 쓰지 않는 참조를 원본 쪽에서 먼저 끊습니다. 그 상태로 Migrate 하면 목록이 줄어듭니다.

출처·확인일: 2026-09-14
– Epic Games 에셋 마이그레이션: 공식 자료 보기
– Epic Games 레퍼런스 뷰어: 공식 자료 보기

이 글은 공식 문서를 확인해 정리한 참고 자료이며, 엔진 버전에 따라 메뉴 위치와 이름이 다를 수 있습니다.

Leave a Comment