이 페이지에서는 에셋 레퍼런스와 언리얼 엔진에서 에셋 레퍼런스를 보는 방법을 정의합니다. 또한, 에셋 레퍼런스를 식별하는 언리얼 엔진 툴과 해당 세팅 및 기타 함수 기능에 대해서도 간략하게 살펴봅니다.
에셋 레퍼런스란?
에셋이 다른 에셋을 어떤 식으로든 사용하는 경우, 첫 번째 에셋이 두 번째 에셋을 참조 한다고 말합니다.
예를 들어, 큐브 액터(Cube Actor) 가 컬러 머티리얼(Color Material) 을 사용한다면, 큐브 액터가 컬러 머티리얼을 참조하는 것입니다. 또한, 큐브 액터가 컬러 머티리얼에 종속성 을 갖는다고도 말할 수 있습니다. 큐브 액터가 그 모습으로 보이려면 컬러 머티리얼이 필요하다는 식으로 생각하면 됩니다.

위의 예시에서는 DistanceToNearest_Mat_Gradient 머티리얼이 OceanNoise 텍스처 2D 에셋을 참조합니다.
레퍼런스는 일방통행, 즉 단방향입니다. 참조된 에셋은 자신의 참조자를 참조하지 않습니다.
레퍼런스 뷰어 툴
레퍼런스 뷰어(Reference Viewer) 는 하나 이상의 에셋을 참조하거나 하나 이상의 에셋에 의해 참조되는 에셋의 그래프를 표시합니다.
레퍼런스 뷰어를 여는 방법은 다음과 같습니다.
-
콘텐츠 브라우저(Content Browser) 에서 하나 이상의 에셋을 선택합니다.
-
선택한 에셋을 우클릭합니다. 그런 다음, 컨텍스트 메뉴 에서 레퍼런스 뷰어(레퍼런스 뷰어) 를 선택합니다.
선택에 따라 다음과 같이 표시됩니다.
-
하나의 에셋을 선택하면 레퍼런스 뷰어 에 해당 에셋의 레퍼런스가 표시됩니다.
-
여러 에셋을 선택하면 선택한 에셋에 공통으로 있는 레퍼런스만 표시됩니다.
-
폴더를 선택하면 해당 폴더에 있는 모든 에셋에 대한 레퍼런스 그래프가 표시됩니다.
전체 크기로 보려면 이미지를 클릭하세요.
위의 스크린샷은 다음과 같은 레퍼런스 뷰어의 주요 엘리먼트를 보여줍니다.
-
선택한 에셋을 참조하는 다른 에셋입니다.
-
선택한 에셋입니다.
-
선택한 에셋이 참조하는 다른 에셋입니다.
-
레퍼런스 뷰어 툴바입니다.
-
여러 개의 활성 에셋 필터가 있는 검색 패널입니다.
아래에 이러한 엘리먼트에 대한 자세한 설명이 나와 있습니다.
에셋 레퍼런스
레퍼런스 뷰어(Reference Viewer) 툴은 선택한 에셋을 참조하거나 선택한 에셋에 의해 참조되는 에셋의 그래프를 표시합니다. 참조 관계는 참조되는 에셋을 가리키는 화살표로 표시됩니다.

이 예시에서 M_Tree_FallTreeMerged_01 머티리얼과 다른 세 개의 에셋 간의 관계는 그 사이를 연결하는 세 개의 화살표로 명확하게 파악됩니다.
그래프에서 에셋을 우클릭하면 다음과 같은 옵션이 있는 컨텍스트 메뉴가 열립니다.
옵션 | 설명 |
---|---|
에셋 탐색(Browse to Asset) | 에셋이 선택된 상태로 콘텐츠 브라우저(Content Browser) 창이 열립니다. |
편집(Edit) | 에디터에서 에셋을 엽니다. 예를 들어, 레벨 뷰포트(Level Viewport) 에서 월드 에셋(World Asset) 이 열립니다. |
줌 레벨 맞춤(Zoom to Fit) | 창 안에 맞도록 레퍼런스 트리 크기를 조절합니다. |
그래프 중심 재설정(Re-Center Graph) | 선택한 에셋에 대한 새 레퍼런스 트리를 생성합니다. |
다음으로 컬렉션 만들기(Make Collection With) | 선택한 에셋의 레퍼런스 또는 종속성으로 새 컬렉션 을 생성합니다. |
참조된 오브젝트 목록 복사(Copy Referenced Objects List), 참조한 오브젝트 목록 복사(Copy Referencing Objects List) | 선택한 에셋을 참조하거나 선택한 에셋이 참조하는 에셋 목록을 텍스트 포맷으로 클립보드에 복사합니다. 이 목록은 상대 에셋 경로를 사용합니다. 예시:
|
참조된 오브젝트 목록 표시(Show Referenced Objects List), 참조한 오브젝트 목록 표시(Show Referencing Objects List) | 선택한 에셋을 참조하거나 선택한 에셋이 참조하는 에셋 목록을 텍스트 포맷으로 보여줍니다. 이 목록은 상대 에셋 경로를 사용합니다. 예시:
|
레퍼런스 트리 표시(Show Reference Tree) | 레퍼런스 트리 툴을 엽니다. 레퍼런스 트리에는 특정 에셋에 대한 레퍼런스 체인이 나열됩니다. 레퍼런스 체인은 목록에 있는 각 오브젝트가 목록에서 아래에 있는 오브젝트를 참조하는 레퍼런스 목록입니다. 레퍼런스 트리의 에셋을 우클릭한 다음, 액터 선택(Select Actor) 을 클릭하여 레벨 뷰포트에서 해당 에셋의 액터(있는 경우)를 선택합니다. 선택한 에셋을 참조하는 스크립트 오브젝트를 표시하려면 레퍼런스 트리 메뉴에서 옵션(Options) > 스크립트 오브젝트 표시(Show Script Objects) 옵션을 활성화합니다. 기본적으로 이러한 레퍼런스는 표시되지 않습니다. |
사이즈 맵(Size Map) | 디스크나 메모리에서의 에셋 및 종속성 크기를 시각적으로 분석해서 보여주는 사이즈 맵 을 표시합니다. 이는 퍼포먼스 프로파일링에 도움이 됩니다. 콘텐츠 브라우저에서 에셋을 우클릭한 다음, 콘텐츠 메뉴에서 사이즈 맵 을 선택하여 에셋 및 에셋의 레퍼런스에 대한 사이즈 맵을 열 수도 있습니다. |
에셋 검사(Audit Assets) | 선택한 에셋에 대한 자세한 정보를 보여주는 에셋 검사 툴을 엽니다. 에셋 검사 창의 오른쪽 상단에 있는 세팅(Settings) 메뉴(톱니바퀴 아이콘)에서 이 정보를 .csv 파일로 익스포트할 수 있습니다. |
레퍼런스 뷰어 툴바
레퍼런스 뷰어 창 상단에 있는 레퍼런스 뷰어 툴바 에서는 다음과 같은 옵션을 사용할 수 있습니다.

번호 | 이름 | 설명 |
---|---|---|
1 | 새로고침, 뒤로 및 앞으로 버튼 | 이러한 버튼은 웹 브라우저의 새로고침, 뒤로 및 앞으로 버튼과 같은 역할을 합니다. 뷰를 새로 고치고 이전 뷰로 이동하는 데 사용합니다. |
2 | 뷰 메뉴 | 레퍼런스 뷰어 그래프에 표시되는 정보와 그 정보가 표시되는 방식을 세밀하게 제어할 수 있는 옵션이 포함되어 있습니다. |
3 | 중복 레퍼런스 토글 버튼 | 비주얼 그래프에서 중복 레퍼런스 표시를 토글합니다. |
4 | 에셋 필터 컨트롤 | 왼쪽의 에셋 타입 필터 버튼은 다음 섹션에 나오는 검색 패널 에서 설정한 에셋 타입 필터로 레퍼런스 뷰어 필터링을 토글합니다. 오른쪽의 에셋 타입 필터 자동 채우기 버튼은 레퍼런스 그래프에 표시되는 모든 에셋에 해당하는 필터를 자동으로 선택합니다. 이 버튼이 활성화되어 있으면 새 루트 에셋을 선택하거나 그래프 파라미터를 변경할 때마다 자동으로 검색 패널의 필터 목록이 그래프에 있는 모든 에셋 타입으로 채워집니다. A 키보드 단축키를 사용하여 필터링된 버전과 필터링되지 않은 버전의 그래프를 토글할 수 있습니다. |
5 | 해당 없음 | 그래프에 종속성이 표시되는 에셋의 상대 경로입니다. |
검색 패널
레퍼런스 뷰어 왼쪽 상단에 있는 검색(Search) 패널을 사용하여 다음과 같은 작업을 수행할 수 있습니다.
- 이름으로 레퍼런스 또는 종속성을 찾습니다.
- 에셋 타입으로 레퍼런스를 필터링합니다.
- 언리얼 엔진의 레퍼런스 및 종속성 검색 깊이를 구성합니다.
- 특정 에셋 컬렉션으로 검색을 제한합니다.

위의 스크린샷은 검색 패널의 주요 영역을 보여줍니다.
번호 | 이름 | 설명 |
---|---|---|
1 | 검색창 | 에셋 이름으로 레퍼런스를 검색합니다. |
2 | 필터 | 에셋 타입으로 레퍼런스를 필터링합니다. 이러한 필터는 콘텐츠 브라우저의 필터와 같은 방식으로 행동합니다. |
3 | 검색 옵션 | 다음 옵션을 사용하여 레퍼런스 뷰어 그래프에 표시되는 에셋을 추가로 환경설정할 수 있습니다. 검색 레퍼런스 깊이(Search References Depth): 선택한 에셋을 참조하는 에셋에 대한 엔진의 검색 깊이입니다. 예를 들어, 값이 2이면 그래프에는 선택한 에셋과 관련된 에셋뿐 아니라 관련 에셋에 관련된 에셋도 표시됩니다. 검색 종속성 깊이(Search Dependencies Depth): 선택한 에셋이 참조하는 에셋 종속성에 대한 엔진의 검색 깊이입니다. 예를 들어, 값이 2이면 그래프에는 선택한 에셋과 관련된 에셋뿐 아니라 관련 에셋에 관련된 에셋도 표시됩니다. 검색 너비 제한(Search Breadth Limit): 주어진 열에 나열되는 참조하거나 참조되는 레퍼런스 수입니다 예를 들어, 에셋이 20개의 에셋을 참조하지만 검색 너비 제한을 10으로 설정하면, 열에는 10개의 에셋만 표시됩니다. 컬렉션 필터(Collection Filter): 단일 컬렉션으로 검색을 제한합니다. |
레퍼런스 뷰어의 에셋 노드
레퍼런스 뷰어의 각 에셋은 비주얼 그래프에서 하나의 노드 로 표시됩니다. 노드는 에셋 타입에 따라 색으로 구분되며, 이름과 타입, 섬네일과 같은 에셋에 대한 추가 정보를 포함하고 있습니다.
노드는 일반 노드(전체 표시됨)가 될 수도 컴팩트 노드가 될 수도 있습니다. 레퍼런스 뷰어 툴바의 뷰 메뉴를 사용하거나(위의 레퍼런스 뷰어 툴바 섹션 참조), V 키보드 단축키를 사용하여 두 모드 간에 토글할 수 있습니다.
![]() |
![]() |
---|---|
일반 노드 | 컴팩트 노드 |
비활성 노드
필터를 사용하면 일부 비활성 노드가 표시될 수 있습니다. 이러한 노드는 반투명으로 보이며 항상 컴팩트 모드입니다. 이러한 노드는 현재 필터에 의해 제외되었지만, 제외되지 않은 두 에셋 사이에 존재하는 노드입니다. 비활성 노드가 여전히 표시되는 이유는 레퍼런스 체인을 명확하게 유지하기 위해서입니다.

이 예시에서는 머티리얼 에셋이 필터링으로 제외되었습니다. 두 머티리얼 노드 M_Tree_FallBark_01 및 M_Tree_FallTreeMerged_01 은 레퍼런스 체인을 온전히 유지하기 위해 비활성 노드로 여전히 표시됩니다.
오버플로 노드
검색 패널의 검색 너비 제한 값이 크면 레퍼런스 뷰어가 한 번에 모든 에셋을 표시하지 못합니다. 대신, 오버플로(Overflow) 노드를 표시합니다. 이 노드를 더블클릭하면 나머지 레퍼런스가 표시됩니다.

아래의 GIF는 오버플로 노드 사용을 보여줍니다.

레퍼런스 뷰어 키보드 단축키
기능 | 키보드 단축키 |
---|---|
레퍼런서 | |
레퍼런서 검색 깊이 증가 | R |
레퍼런서 검색 깊이 감소 | SHIFT + R |
레퍼런서 검색 깊이 설정 | CTRL + R |
종속성 | |
종속성 검색 깊이 증가 | D |
종속성 검색 깊이 감소 | SHIFT + D |
종속성 검색 깊이 설정 | CTRL + D |
너비 제한 | |
너비 제한 증가 | L |
너비 제한 감소 | SHIFT + L |
너비 제한 설정 | CTRL + L |
레퍼런스 타입 | |
소프트 레퍼런스 표시/숨기기 | S |
하드 레퍼런스 표시/숨기기 | H |
에디터 전용 레퍼런스 표시 숨기기 | E |
관리 레퍼런스 표시 숨기기_(프라이머리 에셋 ID)_ | M |
이름 레퍼런스 표시/숨기기 (검색 가능 이름) | N |
C++ 패키지 레퍼런스 표시/숨기기 | C |
뷰 | |
중복 레퍼런스 표시/숨기기 | U |
컴팩트 뷰 토글 | V |
에셋 경로 를 코멘트로 토글 | P |
줌 레벨 맞춤 | F |
에셋 필터 켜기/끄기 토글 | A |
검색 | CTRL + F |
[REGION:asset]뷰[/REGION] | |
에셋 편집 | CTRL + E |
에셋 탐색 | CTRL + B |
선택한 에셋 경로를 클립보드에 복사 | N |