에셋 브라우저와 폴더 구조
콘텐츠 브라우저의 폴더·검색·필터·참조 기능을 익히고 프로젝트 규모가 커져도 유지되는 에셋 구조를 설계합니다.
에셋 임포트를 끝냈다면, 이제 자산을 장기적으로 관리할 수 있는 구조를 만들어야 합니다.
이번 절에서 다루는 콘텐츠 브라우저(Content Browser)는 프로젝트의 모든 에셋을 탐색, 생성, 정리하는 핵심 허브입니다.
초반에는 단순 폴더처럼 보이지만, 규모가 커질수록 검색, 필터, 참조 확인 같은 기능이 작업 속도를 좌우합니다.
핵심은 지금 찾기 쉬운 구조가 아니라 나중에도 유지되는 구조를 만드는 것입니다.
콘텐츠 브라우저 (Content Browser)
콘텐츠 브라우저는 도킹 위치를 바꿀 수 있는 패널입니다. 버전에 따라 콘텐츠 드로어(Content Drawer)로 잠시 열어 사용할 수도 있습니다.
만약 닫혀 있다면 창(Window) > 콘텐츠 브라우저(Content Browser) > 콘텐츠 브라우저 1을 통해 다시 열 수 있습니다.
여러 개의 콘텐츠 브라우저를 동시에 열어 둘 수도 있으며, 각 브라우저는 독립적으로 동작하여 다른 폴더를 탐색하는 데 유용합니다.
콘텐츠 브라우저는 크게 세 가지 주요 영역으로 나눌 수 있습니다.
- 폴더 뷰 (Folders View): 좌측에 위치하며, 프로젝트의
Content등 활성화한 콘텐츠 경로를 계층 구조로 표시합니다. 이곳에서 원하는 폴더를 선택하여 해당 폴더의 에셋들을 우측 영역에서 볼 수 있습니다. - 에셋 뷰 (Asset View): 중앙에 넓게 위치하며, 선택 경로에서 검색·필터·표시 설정에 맞는 에셋을 보여줍니다. 에셋의 종류(Static Mesh, Material, Blueprint 등)에 따라 아이콘 모양이 다릅니다.
- 필터 및 검색 바 (Filters & Search Bar): 에셋 뷰 상단에 위치하며, 특정 에셋을 찾거나 특정 종류의 에셋만 표시하도록 필터링하는 기능을 제공합니다.
효율적인 폴더 구조화 전략
콘텐츠 브라우저에서 가장 중요한 관리 요소는 체계적인 폴더 구조입니다.
프로젝트의 규모가 커질수록 수백, 수천 개의 에셋이 쌓이게 되는데, 이때 폴더 구조가 엉망이라면 원하는 에셋을 찾는 데 많은 시간을 허비하게 됩니다.
폴더 구조화의 원칙
- 직관성: 누가 보더라도 쉽게 이해할 수 있는 폴더 이름과 계층 구조를 사용합니다.
- 일관성: 프로젝트 전체에 걸쳐 동일한 명명 규칙과 구조를 유지합니다.
- 모듈성: 관련된 에셋들을 하나의 폴더 안에 모아두어 관리와 재사용이 용이하게 합니다.
- 확장성: 프로젝트가 커지더라도 새로운 에셋을 쉽게 추가하고 분류할 수 있도록 유연하게 설계합니다.
권장 폴더 구조 예시 (심화)
위에서 살펴본 기본 구조를 실제 프로젝트 기준으로 조금 더 세분화해 보겠습니다.
아래 구조는 프로젝트 규칙의 예시입니다. _Developers는 임의로 정한 이름이며 엔진의 Developers 기능과 다릅니다. 실험 에셋은 공유 에셋에서 참조하지 않고, 빌드 제외가 필요하면 패키징의 Directories to never cook 정책도 명시합니다.
폴더 생성 및 이동 팁
- 새 폴더 생성: 콘텐츠 브라우저의 빈 공간에서 마우스 오른쪽 버튼을 클릭하고 새 폴더(New Folder)를 선택합니다.
- 에셋 이동: 원하는 에셋을 마우스 왼쪽 버튼으로 드래그하여 다른 폴더로 옮길 수 있습니다. 에디터에서 이동하면 이전 경로에 Redirector가 남아 아직 갱신되지 않은 참조를 새 위치로 연결합니다. 운영체제 탐색기에서
.uasset만 옮기지 않습니다. - 폴더 이름 변경: 폴더를 선택하고
F2키를 누르면 이름을 변경할 수 있습니다.
콘텐츠 브라우저의 고급 기능 활용
콘텐츠 브라우저는 단순히 에셋을 보여주는 것을 넘어, 에셋을 효율적으로 찾고 관리하는 다양한 고급 기능들을 제공합니다.
검색 및 필터링
에셋 뷰 상단에는 검색 바(Search Bar)와 필터(Filters) 버튼이 있습니다.
- 검색 바: 찾으려는 에셋의 이름을 직접 입력하여 검색합니다. 부분 일치도 지원합니다.
- 필터: 에셋 종류별로 필터링하여 특정 유형의 에셋만 표시할 수 있습니다.
- 필터(Filters) 버튼 클릭: 드롭다운 메뉴에서 스태틱 메시, 재질, 블루프린트, 텍스처 등 원하는 에셋 유형을 체크하여 필터링합니다.
- 콜렉션(Collections): 자주 사용하는 에셋들을 그룹으로 묶어 놓을 수 있는 기능입니다. 여러 폴더의 에셋을 파일 이동이나 복제 없이 함께 찾아볼 수 있습니다.
- Local Collection (로컬 컬렉션): 현재 PC에만 저장되는 개인 컬렉션입니다.
- Shared Collection (공유 컬렉션): 팀원들과 공유할 수 있는 컬렉션입니다. (버전 관리 시스템 필요)
에셋 미리보기 및 정보
에셋 뷰에서 에셋 아이콘에 마우스를 올리면 에셋의 간단한 정보(경로, 유형, 크기 등)가 툴팁으로 표시됩니다.
에셋을 더블 클릭하면 해당 에셋의 에디터(예: 스태틱 메시 에디터, 재질 에디터, 블루프린트 에디터)가 열립니다.
에셋 액션 (Asset Actions)
콘텐츠 브라우저에서 에셋에 마우스 오른쪽 버튼을 클릭하면 해당 에셋에 대해 수행할 수 있는 다양한 액션 목록이 나타납니다.
- 이동(Move), 복사(Copy), 삭제(Delete): 기본적인 파일 관리 기능입니다.
- 이름 변경(Rename):
F2키와 동일하게 에셋의 이름을 변경합니다. -
참조(References)
- 참조 뷰어(Reference Viewer): 선택된 에셋이 어디에서 참조되고 있는지, 또는 이 에셋이 어떤 다른 에셋을 참조하고 있는지 시각적으로 보여줍니다. 에셋 삭제 전, 또는 복잡한 에셋 관계를 파악할 때 필수적인 도구입니다.
- 참조 탐색 범위: 검색 도구의 종류·필터·깊이에 따라 결과가 달라집니다. 코드의 문자열 경로처럼 에셋 관계에 잡히지 않는 사용도 따로 확인합니다.
- Fix Up Redirectors: Redirector를 참조하는 패키지를 새 경로로 다시 저장합니다. 필요한 패키지를 모두 저장할 수 있어야 Redirector가 제거되므로 체크아웃·저장 권한과 결과를 확인합니다.
- 에셋 생성(Create Asset): 선택된 에셋을 기반으로 새로운 에셋(예: 재질에서 재질 인스턴스 생성)을 생성합니다.
이동 뒤 이전 경로의 Redirector를 거치던 패키지가 Fix Up 재저장 후 새 에셋을 직접 참조한다.
콘텐츠 브라우저 설정
콘텐츠 브라우저의 설정(Settings) 메뉴에서 표시 옵션을 찾습니다. 버튼 위치는 에디터 버전에 따라 다릅니다.
이곳에서 콘텐츠 브라우저의 표시 방식이나 동작을 조절할 수 있습니다.
- 썸네일 크기(Thumbnail Size): 에셋 썸네일의 크기를 조절하여 한 번에 더 많은 에셋을 보거나, 더 크게 미리 볼 수 있습니다.
- 컬럼(Columns): 에셋 목록 보기를 할 때 표시할 정보를 선택합니다.
- 콘텐츠 표시: 엔진·플러그인·개발자 콘텐츠 표시 여부를 조절합니다. 검색 결과가 비면 경로와 필터부터 확인합니다.
콘텐츠 브라우저와 효율적인 폴더 구조는 언리얼 엔진 프로젝트의 뼈대와 같습니다.
처음부터 체계적인 관리 습관을 들이는 것이 중요하며, 이는 여러분의 작업 속도와 협업 효율성을 크게 향상시킬 것입니다.
다음 절에서는 에셋의 변경 이력과 버전 관리를 다룹니다.