들어가기

언리얼 엔진으로 게임을 개발하다보면 실제 게임에 들어가는 리소스와 들어가지 않는 리소스가 있습니다.

테스트 리소스가 빌드에 포함되어야 하나?

굳이 인게임에 사용되지 않을 리소스가 빌드에 포함되어 게임 패키지 크기만 키우는 건 바람직한 방향이 아닙니다. 더 나아가 테스트 리소스인데 실수록 인게임에 노출시켜버리는 것도 원하는 결과가 아닐 것입니다.

테스트 리소스는 관리가 필요하다.

테스트 리소스, 어떻게 관리할까

1. 공용 테스트 리소스용 폴더를 루트 디렉토리 아래에 생성합니다. 언리얼 엔진으로 따지면 Developers 같은 폴더입니다. 해당 폴더에는 개발 진행 중인 리소스나 테스트 리소스, 혹은 프로젝트 내부에 공유하고 싶은 리소스이지만 인게임에는 포함되지 않을 리소스 등을 담을 수 있습니다.
2. 팀별로도 더미 리소스나 테스트용 리소스를 보관할 장소가 필요합니다. 팀별 디렉토리 아래에 공통된 네이밍으로 테스트용 리소스 폴더를 생성합니다.
3. 테스트용 리소스의 네이밍 규칙을 정합니다. 아래와 같은 예시입니다.
   • 더미 리소스: (Name)_DUMMY
   • 테스트 리소스: (Name)_TEST
   • 임시 리소스: (Name)_TEMP
4. 검증 툴을 제작해 인게임 리소스가 테스트 리소스를 참조하는 경우 에러를 출력합니다. 예컨대 위의 관리법을 도입한다면 아래와 같은 검증 케이스를 포함하면 됩니다.
   • 테스트 리소스용 폴더로 지정한 경로의 에셋이 그 외 에셋에 참조되는 경우
   • 네이밍 규칙에 따라 테스트 리소스로 분류된 에셋이 그 외 에셋에 참조되는 경우

Unreal Engine

언리얼 엔진은 프로젝트 세팅에서 빌드에 포함시키지 않을 디렉토리를 지정할 수 있는 기능을 제공합니다.

Project Settings → Packaging → Packaging → Directories to never nook

혹은 DefaultGame.ini에서 [/Script/UnrealEd.ProjectPackagingSettings] 섹션에 아래와 같이 추가하면 위와 동일한 효과를 보실 수 있습니다.

[/Script/UnrealEd.ProjectPackagingSettings]
+DirectoriesToNeverCook=(Path="/Game/Developers")
+DirectoriesToNeverCook=(Path="/Game/Characters/Dev")
+DirectoriesToNeverCook=(Path="/Game/Design/Dev")
+DirectoriesToNeverCook=(Path="/Game/FX/Dev")
+DirectoriesToNeverCook=(Path="/Game/Environment/Dev")
+DirectoriesToNeverCook=(Path="/Game/TA/Dev")
+DirectoriesToNeverCook=(Path="/Game/Maps/TestMaps")