언리얼 엔진 5 문서가 에픽 디벨로퍼 커뮤니티로 이전되었습니다

레퍼런스 대체(Replace Reference) 툴은 에디터 내에서 간단한 방법으로 여러 애셋을 하나의 애셋으로 합치는 툴입니다. 개발 도중에 여러번 복제된 텍스처를 예를 들어 봅시다. 완전히 똑같은 텍스처의 사본 수만큼 리소스가 낭비되게 됩니다. 레퍼런드 대체 툴로 사용자가 그런 것들을 전부 선택해서 텍스처 인스턴스 하나를 지정하여 가리키게끔 할 수 있습니다.

이 부분이 언리얼 엔진 4 에서는 똑같은 (이름과 경로의) 파일을 두 번 추가하려 할 때 소스 애셋만 리임포트하는 것으로 크게 간소화되긴 했지만, 한 게임에 여러 명이 작업할 때는 여전히 벌어질 수 있는 일입니다.

레퍼런드 대체 툴 사용하기

레퍼런드 대체 툴은 꽤나 사용하기 쉬우나, 제대로 활용하기 위해서는 주의해야 합니다.

레퍼런드 대체 툴 불러오기

툴에 접근하려면 콘텐츠 브라우저에서 통합 과정에 사용할 애셋을 최소 하나 선택하기만 하면 됩니다. 그리고 우클릭 후 뜨는 컨텍스트 메뉴에서 Replace Reference (레퍼런스 대체)를 선택합니다. 레퍼런스 대체 대화창에 툴을 띄우기 전에 선택된 애셋 전부가 채워진 상태로 뜨게 됩니다. 애셋을 더 추가하려면 그냥 콘텐츠 브라우저에서 끌어다가 대화창의 주요 부분에다 떨구기만 하면 됩니다.

이 텍스처가 여러번 중복됐습니다! 전부 선택하고서 우클릭을 하면 레퍼런스 대체 옵션이 뜹니다.

애셋 통합하기

통합 과정에서 사용할 애셋 전부를 대화창에 채웠으면, "통합 대상 애셋"을 하나 선택하고, "애셋 통합" 을 누릅니다. 나열된 것 중 선택되지 않은 애셋으로의 참조는 전부 선택된 애셋으로의 참조로 대체되며, 선택되지 않은 애셋은 삭제합니다.

레퍼런스 대체 대화창 안에서 애셋을 선택하면 "통합 대상 애셋"으로 마킹하는 것입니다.

"애셋 통합" 을 클릭하여 "애셋 삭제" 대화창이 뜹니다. 여기서 더이상 참조되지 않아 필요치 않은 애셋을 제거할 수 있습니다. 삭제 를 클릭합니다.

중복된 것 전부가 선택된 애셋으로 통합됐습니다!

더티 패키지 저장하기

통합 대화창의 좌하단 구석에는 "더티 패키지 저장?" 옵션도 있습니다. 체크하면 통합 작업 완료 후 통합 과정에서 건드린 UAsset 을 저장하겠냐고 묻는 창이 뜨게 됩니다. 통합에 영향받은 UAsset 전부를 콘텐츠 브라우저에서 일일이 찾아 저장할 수고를 덜어주는 편한 방법입니다. 만약 어떤 이유에서건 통합이 실패하거나 오류가 발생하면, UAsset 은 저장되지 않고 적절한 경고가 뜨게 됩니다.

레퍼런드 대체 툴 작동 원리

실제 통합 과정은 여러 단계에 걸쳐 일어납니다. 먼저 통합이 가능한 오브젝트로의 참조 전부를 이미 로드되어 메모리에 있는 오브젝트/UAsset 내의 "통합 대상 애셋"으로의 참조로 대체해 봅니다. 즉 통합될 오브젝트중 하나로 참조되는 맵이나 UAsset 이 이미 열려있는 상태라면, 툴이 즉시 업데이트해 봅니다. 다음, 통합될 오브젝트를 툴이 직접 지워봅니다. (이 작업은 실패할 확률이 있습니다. 제한사항 및 경고 참고.) 마지막으로 삭제에 성공했으면, 툴은 삭제된 오브젝트 대신 오브젝트 리디렉터 를 놔둡니다. 이를 통해 삭제된 오브젝트로의 참조를 가진 UAsset 중에 로드되지 않은 것들을 통합 대상 오브젝트로 돌려주게 됩니다.

실전 사례

• 레퍼런드 대체 툴이 하는 일의 속성으로 보면, 제대로 사용하지 않을 경우 굉장히 위험할 수가 있습니다. 툴 사용자는 항상 뭘 하려 하는지 생각해야 하며, 작업 결과가 애셋의 컨텍스트에 잘 들어맞는지 결정해야 합니다. 명백히 잘못된 통합은 툴이 자체적으로 막아주긴 하지만, UAsset 을 망치지 않도록 항시 주의해야 하는 건 사용자의 몫입니다. 통합된 애셋을 삭제하고 기존 사용처를 선택된 오브젝트로 돌려주는 기능을 하는 툴이라는 점을 명심하십시오. "액터를 대체하는" 형태의 작업 대체법이 아닙니다!

• 레퍼런드 대체 툴이 현재 로드되어 메모리에 있는 UAsset/맵 내 통합할 오브젝트로의 참조를 강제로 대체하려 하기는 하지만, 툴을 사용할 때 통합할 오브젝트로의 참조를 가급적 줄여 통합 성공률을 높이는 게 좋습니다. 구체적으로, 곧 통합될 애셋을 (블루프린트 에디터나 스태틱 메시 에디터같은) 하위-에디터로 열어 활용하는 것은 매우 문제의 소지가 큽니다.

• 레퍼런드 대체 툴은 오브젝트 리디렉터 를 많이 사용합니다. 즉 레퍼런드 대체 툴을 사용한 뒤 약간 지나고서 종종 FixupRedirects 커맨드렛을 사용해 주시는 게 좋다는 뜻입니다.

한계 및 주의점

유용하긴 해도 레퍼런드 대체 툴에는 제한사항 및 경고가 약간 있는데, 대략 아래와 같습니다:

• 실수로 작업내용이 깨지는 것을 방지하기 위해 레퍼런드 대체 툴은 동일한 클래스/유형의 애셋으로만 불러올 수 있으나, 한 가지 예외는 모든 오브젝트가 머티리얼 또는 텍스처 유형일 때입니다. (즉 머티리얼과 데칼 머티리얼은 엄밀히 같은 유형은 아니라도 통합될 수는 있습니다.) 이는 머티리얼을 스태틱 메시로 통합하는 것과 같이 확실히 크래시를 유발하는 통합을 방지하기 위함입니다. 교차-유형 통합이 허용된 경우에도, 복수 유형을 통합하려 한다는 경고를 툴이 띄우게 됩니다.

• 레퍼런드 대체 툴이 사용자가 선택한 애셋을 항상 통합할 수 있는 건 아닙니다. 사용자가 통합할 애셋 중 하나로의 참조를 포함하는 애셋을 "통합 대상 애셋"으로 선택한 경우, 해당 애셋은 통합되지 않게 됩니다. 그런 작업을 허용하게 되면 "통합 대상 애셋"을 자신에게 참조하도록 만들게 되며, 분명 문제가 생기게 될 것입니다. 통합에 생략된 애셋이 있는 경우 통합 작업 끝에 경고창이 뜨게 됩니다.

• 레퍼런드 대체 툴은 문제없는 애셋인 경우에도 가끔, 어떤 이유로 인해 그 참조를 비울 수 없거나 그 자체를 지울 수 없는 경우에 통합에 실패하게 됩니다. 이런 실패 유형은 치명적인데, 일부는 통합되고 일부는 그대로인 "부분 통합" 상태가 되기 때문입니다. 이런 실패 유형은 꽤 드물지만, 만약 발생하는 경우 영향받은 애셋과 영향받을 수도 있는 UAsset 을 표시하는 경고창이 뜨게 됩니다. 영향받은 UAsset 을 저장해서는 안되며 , 저장해버리면 부분 통합의 재앙이 덮치게 됩니다.

• 실전 사례 에서 언급했듯이, 잠재적으로 영향받을 애셋을 페르소나 또는 블루프린트 에디터같은 다양한 하위에디터에서 연 상태로 레퍼런드 대체 툴을 활용하는 것은 문제의 소지가 매우 큽니다. 궁극적으로 대부분의 하위에디터를 띄워두고 참조를 바꿔버리면 제대로 반응하지 않게 되니, 통합 도중에 하위에디터를 사용하면 사용불가능한 상태가 되거나 잠재적 크래시 위험이 있습니다.

• 레퍼런드 대체 툴은 작업 시점에서 이미 로드된 UAsset 에 있는 통합 오브젝트로의 참조만 대체합니다. 로드안된 UAsset 에 남아있는 참조를 고치는 데는 오브젝트 리디렉터 에 의존합니다. 즉 딱히 필요하지 않은 경우엔 리디렉터를 무시하거나 덮어쓰거나 삭제하는 등의 조치를 취하지 않는 것이 좋다는 뜻입니다. 그렇지 않으면 UAsset 일부는 제대로 고쳐지고, 일부는 아니게 됩니다. 전에 대충 말씀드렸듯이, FixupRedirects 커맨드렛을 활용하여 이 문제를 경감시킬 수 있습니다.

• 현재로써는 통합 작업이 성공하면, 통합된 오브젝트 중 하나로의 참조를 포함하는 로드안된 UAsset 을 메모리에 로드하려 하기 전에 관련된 UAsset 저장을 하는 것이 좋습니다. 현재 미해결 콘텐츠 브라우저/오브젝트 리디렉터 버그로 인해, 참조 UAsset 을 저장하기 전에 로드해 버리면 통합된 애셋이 브라우저에 다시 나타나지 않는 버그가 생길 수 있습니다.