에셋 브라우저와 폴더 구조
콘텐츠 브라우저의 폴더·검색·필터·참조 기능을 익히고 프로젝트 규모가 커져도 유지되는 에셋 구조를 설계합니다.
에셋 임포트를 끝냈다면, 이제 자산을 장기적으로 관리할 수 있는 구조를 만들어야 합니다.
이번 절에서 다루는 콘텐츠 브라우저(Content Browser)는 프로젝트의 모든 에셋을 탐색, 생성, 정리하는 핵심 허브입니다.
초반에는 단순 폴더처럼 보이지만, 규모가 커질수록 검색, 필터, 참조 확인 같은 기능이 작업 속도를 좌우합니다.
핵심은 지금 찾기 쉬운 구조가 아니라 나중에도 유지되는 구조를 만드는 것입니다.
콘텐츠 브라우저 정리는 폴더명 규칙만의 문제가 아니다. 이동 전 참조, 이름 변경 흔적, 패키징 로그까지 이어지는 운영 흐름으로 봐야 한다.
- 1소유 폴더를 정한다
캐릭터, 환경, UI, 이펙트처럼 담당 파트 기준으로 이동 목적지를 먼저 고정한다.
- 2이동 전 참조를 본다
삭제 또는 이동이 어떤 맵, 블루프린트, 머티리얼에 영향을 주는지 먼저 확인한다.
- 3이름과 위치를 바꾼다
접두어와 기능 폴더를 맞추고, 샘플·실험용 에셋이 운영 폴더에 섞이지 않게 한다.
- 4경로 변경 흔적 제거
름 변경과 이동 뒤에 남은 redirector를 정리해 낡은 패키지 경로를 없앤다.
- 5패키징 로그로 검증
없는 파일, 잘못된 소프트 참조, 미사용 대형 텍스처 경고가 사라졌는지 본다.
- 6실험용 에셋이 남아 있음
임시 폴더 잔류 개발자 전용, 임시, 복사본 폴더가 릴리즈 경로에 있으면 Cook 대상에 섞일 수 있다.
- 7복사본과 낡은 버전
중복 이름 비슷한 머티리얼과 텍스처가 여러 개 있으면 부모와 인스턴스 구조를 다시 본다.
- 8참조 0개 확인 후 삭제
삭제 조건 크기와 참조를 확인하고 테스트 맵 로드까지 통과한 뒤에만 에셋을 제거한다.
콘텐츠 브라우저 (Content Browser)
콘텐츠 브라우저는 언리얼 에디터의 하단에 넓게 배치되어 있는 패널입니다.
만약 닫혀 있다면 창(Window) > 콘텐츠 브라우저(Content Browser) > 콘텐츠 브라우저 1을 통해 다시 열 수 있습니다.
여러 개의 콘텐츠 브라우저를 동시에 열어 둘 수도 있으며, 각 브라우저는 독립적으로 동작하여 다른 폴더를 탐색하는 데 유용합니다.
콘텐츠 브라우저는 크게 세 가지 주요 영역으로 나눌 수 있습니다.
- 폴더 뷰 (Folders View): 좌측에 위치하며, 프로젝트의
Content폴더를 기준으로 모든 하위 폴더들을 계층 구조로 표시합니다. 이곳에서 원하는 폴더를 선택하여 해당 폴더의 에셋들을 우측 영역에서 볼 수 있습니다. - 에셋 뷰 (Asset View): 중앙에 넓게 위치하며, 현재 선택된 폴더 내의 모든 에셋들을 아이콘 형태로 보여줍니다. 에셋의 종류(Static Mesh, Material, Blueprint 등)에 따라 아이콘 모양이 다릅니다.
- 필터 및 검색 바 (Filters & Search Bar): 에셋 뷰 상단에 위치하며, 특정 에셋을 찾거나 특정 종류의 에셋만 표시하도록 필터링하는 기능을 제공합니다.
효율적인 폴더 구조화 전략
콘텐츠 브라우저에서 가장 중요한 관리 요소는 체계적인 폴더 구조입니다.
프로젝트의 규모가 커질수록 수백, 수천 개의 에셋이 쌓이게 되는데, 이때 폴더 구조가 엉망이라면 원하는 에셋을 찾는 데 많은 시간을 허비하게 됩니다.
폴더 구조화의 원칙
- 직관성: 누가 보더라도 쉽게 이해할 수 있는 폴더 이름과 계층 구조를 사용합니다.
- 일관성: 프로젝트 전체에 걸쳐 동일한 명명 규칙과 구조를 유지합니다.
- 모듈성: 관련된 에셋들을 하나의 폴더 안에 모아두어 관리와 재사용이 용이하게 합니다.
- 확장성: 프로젝트가 커지더라도 새로운 에셋을 쉽게 추가하고 분류할 수 있도록 유연하게 설계합니다.
권장 폴더 구조 예시 (심화)
에셋 브라우저는 검색 창이 아니라 프로젝트 구조를 유지하는 기준점입니다.
아래 다이어그램은 폴더, 네이밍, 필터를 사용해 에셋을 찾기 쉽게 만드는 방법을 정리합니다.
검색하기 쉬운 구조는 마이그레이션, 리다이렉터 정리, 팀 협업 비용을 줄인다.
- 유지할 영역
Core 공통 Material, DataTable, UI 리소스 Characters 캐릭터 메시, 애니메이션, 전용 Blueprint Maps 레벨과 레벨 전용 연출 에셋
- 분리할 영역
Feature 무기, 상호작용, 퀘스트처럼 변경 이유가 같은 파일 Test 실험 파일과 버릴 샘플 External 구매/외부 에셋의 원본 경계
| 기준 | 판정 |
|---|---|
| 좋은 기준 | 같이 바뀌는 파일은 가까이 둔다. |
| 나쁜 기준 | 임시 파일을 실제 배포 에셋과 섞는다. |
위에서 살펴본 기본 구조를 실제 프로젝트 기준으로 조금 더 세분화해 보겠습니다.
이 구조는 많은 팀이 사용하는 출발점이며, 프로젝트 특성에 맞게 유연하게 변형해도 괜찮습니다.
폴더 생성 및 이동 팁
- 새 폴더 생성: 콘텐츠 브라우저의 빈 공간에서 마우스 오른쪽 버튼을 클릭하고 새 폴더(New Folder)를 선택합니다. 또는
Ctrl + Shift + N단축키를 사용합니다. - 에셋 이동: 원하는 에셋을 마우스 왼쪽 버튼으로 드래그하여 다른 폴더로 옮길 수 있습니다. 참조 관계가 있는 에셋을 옮기면 언리얼 엔진이 자동으로 참조 경로를 업데이트해 줍니다.
- 폴더 이름 변경: 폴더를 선택하고
F2키를 누르면 이름을 변경할 수 있습니다.
콘텐츠 브라우저의 고급 기능 활용
콘텐츠 브라우저는 단순히 에셋을 보여주는 것을 넘어, 에셋을 효율적으로 찾고 관리하는 다양한 고급 기능들을 제공합니다.
검색 및 필터링
에셋 뷰 상단에는 검색 바(Search Bar)와 필터(Filters) 버튼이 있습니다.
- 검색 바: 찾으려는 에셋의 이름을 직접 입력하여 검색합니다. 부분 일치도 지원합니다.
- 필터: 에셋 종류별로 필터링하여 특정 유형의 에셋만 표시할 수 있습니다.
- 필터(Filters) 버튼 클릭: 드롭다운 메뉴에서 스태틱 메시, 재질, 블루프린트, 텍스처 등 원하는 에셋 유형을 체크하여 필터링합니다.
- 콜렉션(Collections): 자주 사용하는 에셋들을 그룹으로 묶어 놓을 수 있는 기능입니다. 여러 폴더에 흩어져 있는 에셋들을 임시적으로 한곳에 모아 관리할 때 유용합니다.
- Local Collection (로컬 컬렉션): 현재 PC에만 저장되는 개인 컬렉션입니다.
- Shared Collection (공유 컬렉션): 팀원들과 공유할 수 있는 컬렉션입니다. (버전 관리 시스템 필요)
에셋 미리보기 및 정보
에셋 뷰에서 에셋 아이콘에 마우스를 올리면 에셋의 간단한 정보(경로, 유형, 크기 등)가 툴팁으로 표시됩니다.
에셋을 더블 클릭하면 해당 에셋의 에디터(예: 스태틱 메시 에디터, 재질 에디터, 블루프린트 에디터)가 열립니다.
에셋 액션 (Asset Actions)
콘텐츠 브라우저에서 에셋에 마우스 오른쪽 버튼을 클릭하면 해당 에셋에 대해 수행할 수 있는 다양한 액션 목록이 나타납니다.
- 이동(Move), 복사(Copy), 삭제(Delete): 기본적인 파일 관리 기능입니다.
- 이름 변경(Rename):
F2키와 동일하게 에셋의 이름을 변경합니다. -
참조(References)
- 참조 뷰어(Reference Viewer): 선택된 에셋이 어디에서 참조되고 있는지, 또는 이 에셋이 어떤 다른 에셋을 참조하고 있는지 시각적으로 보여줍니다. 에셋 삭제 전, 또는 복잡한 에셋 관계를 파악할 때 필수적인 도구입니다.
- 사용된 위치 찾기(Find References): 선택된 에셋이 사용된 모든 위치(레벨, 다른 블루프린트 등)를 결과 로그에 표시합니다.
- 수정(Fix Up Redirectors in Folder): 폴더를 이동하거나 이름을 변경했을 때 발생할 수 있는 리다이렉터(Redirector) 파일을 정리하여 에셋 참조 문제를 해결합니다. 주기적으로 실행해 주는 것이 좋습니다.
- 에셋 생성(Create Asset): 선택된 에셋을 기반으로 새로운 에셋(예: 모델에서 재질 생성)을 생성합니다.
Filters, Collections, Reference Viewer, Size Map, Fix Up Redirectors를 같은 주기로 돌리면 폴더 구조와 참조 경로가 오래 유지됩니다.
- 1
Filters/Collections Static Mesh, Material, Blueprint, Niagara System을 유형별로 좁힙니다.
- 2
SM_/MI_/BP_ 검사 SM_, M_, MI_, T_, BP_ 접두어와 Content 하위 위치가 용도와 맞는지 봅니다.
- 3
Reference Viewer·Size Map 삭제나 이동 전에 하드 참조 체인과 패키지 크기 증가 원인을 확인합니다.
- 4
Fix Up Redirectors 폴더 이동 뒤 Redirector 파일을 제거하고 소스 컨트롤 제출 전 다시 검색합니다.
콘텐츠 브라우저를 운영할 때는 폴더 이름만 맞추는 것보다, 이동 전 참조 확인과 이동 후 리다이렉터 정리까지 같은 절차로 처리하는 편이 안전합니다.
콘텐츠 브라우저는 파일 보관함이 아니라 에셋을 검색하고 옮기고 검증하는 작업대입니다. 분류 기준이 흐려지면 리다이렉터와 중복 에셋이 빠르게 쌓입니다.
- 역할별 최상위 폴더
folder Common, Environments, Characters처럼 찾는 기준을 먼저 정하고 임시 작업은 _Developers 아래에 둡니다.
- 검색 가능한 이름
prefix SM_ , M_ , T_ , BP_ 접두어를 맞추면 필터와 검색 결과가 곧 점검표가 됩니다.
- 필터로 범위 축소
filter Static Mesh/Material/Texture 필터로 접두사 누락과 위치 오류를 찾습니다.
- 이동 전 참조 확인
reference Reference Viewer로 연결을 보고 삭제/이동을 결정합니다.
- 이동 후 경로 정리
cleanup 폴더 이동이 끝나면 Fix Up Redirectors를 실행해 오래된 경로가 다음 작업으로 번지지 않게 합니다.
콘텐츠 브라우저 설정
콘텐츠 브라우저의 우측 하단에는 설정(Settings) 버튼이 있습니다.
이곳에서 콘텐츠 브라우저의 표시 방식이나 동작을 조절할 수 있습니다.
- 썸네일 크기(Thumbnail Size): 에셋 썸네일의 크기를 조절하여 한 번에 더 많은 에셋을 보거나, 더 크게 미리 볼 수 있습니다.
- 컬럼(Columns): 에셋 목록 보기를 할 때 표시할 정보를 선택합니다.
- 고급 검색 결과(Advanced Search Results): 검색 시 더 상세한 필터 옵션을 제공합니다.
콘텐츠 브라우저의 검색, 타입 필터, Reference Viewer, Fix Up Redirectors를 같은 순서로 돌리면 에셋이 늘어도 누락된 참조와 잘못된 경로를 빨리 잡는다.
- Asset Search접두사와 경로 불일치 찾기
Asset Search SM_ , M_ , T_ 처럼 접두사를 검색해 타입은 Static Mesh인데 Materials 폴더에 남은 에셋을 걸러낸다.
- Type FilterAsset Class별로 좁히기
Type Filter Static Mesh, Material, Texture 필터를 켜서 폴더 규칙과 실제 에셋 클래스가 어긋난 파일을 분리한다.
- Safe Move의존 에셋을 묶어서 이동
Safe Move 메시, 머티리얼, 텍스처를 같은 작업 단위로 옮겨 패키지 경로 변경과 참조 업데이트를 한 번에 끝낸다.
- RedirectorFix Up Redirectors 실행
Redirector 폴더 이동 후 리다이렉터를 정리해 오래된 패키지 경로가 다음 커밋, 쿠킹, 마이그레이션에 남지 않게 한다.
콘텐츠 브라우저와 효율적인 폴더 구조는 언리얼 엔진 프로젝트의 뼈대와 같습니다.
처음부터 체계적인 관리 습관을 들이는 것이 중요하며, 이는 여러분의 작업 속도와 협업 효율성을 크게 향상시킬 것입니다.
다음 절에서는 언리얼 엔진 공식 마켓플레이스와 퀵셀 메가스캔(Quixel Megascans)를 활용하여 외부의 고품질 에셋을 프로젝트에 추가하는 방법에 대해 알아보겠습니다.
필요한 에셋을 선별해 프로젝트에 추가하는 기준을 함께 다룹니다.
콘텐츠 브라우저는 프로젝트의 실제 작업 기억입니다. Root 폴더, 접두어, 타입 필터, 컬렉션이 맞물려야 에셋이 늘어나도 참조 경로를 잃지 않습니다.
- 최상위 폴더 제한
Root Maps, Meshes, Materials, Textures처럼 패키지 Root를 먼저 정해 무작위 저장과 순환 참조를 줄입니다.
- Asset Class 접두어
Prefix SM_, MI_, T_처럼 타입을 드러내는 이름은 검색 결과에서 잘못된 폴더와 누락된 인스턴스를 빠르게 드러냅니다.
- Class 필터로 좁히기
Filters Static Mesh, Material, Texture 필터와 경로 검색을 함께 써서 폴더 안의 이물질을 분리합니다.
- 작업용 컬렉션
Collections 실제 패키지 경로를 옮기지 않고도 레벨 아트, VFX, UI처럼 특정 작업 묶음만 따로 봅니다.