Unreal Engine “Asset has been saved with empty engine version” 경고 안전하게 해결하기

empty engine version의 정확한 뜻#

경고 문구만 보면 major, minor, patch가 모두 비어 있다고 생각하기 쉽다. 실제 engine 분기는 SavedByEngineVersion이 유효한 changelist를 가지고 있는지에 초점을 둔다. 동작을 단순화하면 아래 조건으로 정리된다.

1
NeedsEngineVersionChecks
2
    && !FPlatformProperties::RequiresCookedData()
3
    && !Summary.SavedByEngineVersion.HasChangelist()
4
    && FEngineVersion::Current().HasChangelist()

즉 일반적인 uncooked/editor package load에서 다음이 모두 맞을 때 경고한다.

1. 이 loader가 engine-version 검사를 수행하는 경로다.
2. package summary의 SavedByEngineVersion changelist가 없거나 0이다.
3. target Editor build에는 nonzero changelist가 있다.

Asset이 즉시 손상됐다는 판정은 아니다. Engine은 package를 load하되 저장 engine의 정확한 호환성을 판단할 근거가 부족하므로 경고한다.

Package summary에 저장되는 버전 정보#

.uasset과 .umap 앞부분의 FPackageFileSummary는 package 내용을 읽기 위한 목차와 여러 version field를 가진다.

FEngineVersion에는 major, minor, patch, changelist, branch가 포함된다. 이 경고의 핵심은 SavedByEngineVersion.GetChangelist() == 0이다.

CL0 package는 engine-version 호환성 비교에서 매우 관대하게 취급될 수 있다. 그렇다고 Object Version과 Custom Version 검사까지 모두 사라지는 것은 아니다. “문제없이 load됐으니 완전히 호환된다”도, “경고가 있으니 파일이 깨졌다”도 정확한 해석이 아니다.

왜 changelist 0으로 저장되는가#

주로 아래와 같은 이유로 발생한다.

• Engine/Build/Build.version의 Changelist가 0인 source build로 source Asset을 저장했다.
• 오래된 package가 완전한 engine-version field를 갖기 전에 만들어졌다.
• 별도 branch나 custom fork에서 version metadata를 만들지 않은 build를 사용했다.
• CL0 build에서 저장한 콘텐츠를 나중에 Launcher 또는 promoted build로 열었다.

“UE 5.3.1 migration이 경고를 만들었다”고 바로 결론 내리면 안 된다. 4.27-Plus build가 이미 CL0 package를 만들었고, nonzero-CL UE 5.3.1이 이를 처음 경고했을 가능성도 있다.

먼저 warning log의 package를 하나 골라 이전 build와 target build의 Build.version, source control history, package 저장 시점을 확인한다.

두 방법은 같은 해결책이 아니다#

일반적인 migration의 목표는 경고 문구를 없애는 것이 아니라 실제 배포에 사용할 target engine으로 package를 다시 저장하고 결과를 검증하는 것이다.

대량 resave 전에 확인할 것#

1
$ueRoot = 'C:\Program Files\Epic Games\UE_5.3'
2
$buildVersionFile = Join-Path $ueRoot 'Engine\Build\Build.version'
3
$buildVersion = Get-Content -LiteralPath $buildVersionFile -Raw |
4
    ConvertFrom-Json
5

6
$buildVersion |
7
    Select-Object MajorVersion, MinorVersion, PatchVersion,
8
                  Changelist, CompatibleChangelist,
9
                  IsLicenseeVersion, IsPromotedBuild
10

11
if ([int64]$buildVersion.Changelist -eq 0) {
12
    throw 'Target engine changelist is 0. Resaving will not repair the metadata.'
13
}

안전한 ResavePackages 명령#

다음 PowerShell 예시는 실행 파일과 project가 실제로 존재하는지, target changelist가 nonzero인지 확인한 뒤 project 범위의 CL0 package만 다시 저장한다.

1
$ueRoot = 'C:\Program Files\Epic Games\UE_5.3'
2
$projectFile = 'D:\Projects\MyGame\MyGame.uproject'
3
$editorCmd = Join-Path $ueRoot 'Engine\Binaries\Win64\UnrealEditor-Cmd.exe'
4
$buildVersionFile = Join-Path $ueRoot 'Engine\Build\Build.version'
5

6
if (-not (Test-Path -LiteralPath $editorCmd)) {
7
    throw "UnrealEditor-Cmd.exe not found: $editorCmd"
8
}
9

10
if (-not (Test-Path -LiteralPath $projectFile)) {
11
    throw "uproject not found: $projectFile"
12
}
13

14
$buildVersion = Get-Content -LiteralPath $buildVersionFile -Raw |
15
    ConvertFrom-Json
16

17
if ([int64]$buildVersion.Changelist -eq 0) {
18
    throw 'Target engine changelist is 0. Resaving will not repair the metadata.'
19
}
20

21
& $editorCmd $projectFile `
22
    -run=ResavePackages `
23
    -OnlyUnversioned `
24
    -ProjectOnly `
25
    -Unattended `
26
    -UTF8Output
27

28
if ($LASTEXITCODE -ne 0) {
29
    throw "ResavePackages failed with exit code $LASTEXITCODE"
30
}

실행 파일과 .uproject 경로는 PowerShell argument로 전달하므로 공백이 있어도 안전하다. cmd.exe나 batch file로 옮긴다면 각각을 명시적으로 quote해야 한다.

UE 4.27에서는 실행 파일 이름만 다르다.

1
$editorCmd = Join-Path $ueRoot 'Engine\Binaries\Win64\UE4Editor-Cmd.exe'

Cook의 -UnVersioned와 혼동하지 않기#

이름이 비슷한 기능은 목적이 다르다.

Cooking Content은 cook option의 별도 목적을 설명한다. source Asset 경고를 고치려고 cook의 -UnVersioned를 바꾸지 않는다.

실행 뒤 반드시 검증하기#

commandlet exit code 0만으로 migration이 끝난 것은 아니다.

1. Saved/Logs에서 LogLinker, LogContentCommandlet, Skipping, Warning, Error, [REPORT]를 확인한다.
2. source control에서 예상한 .uasset과 .umap만 바뀌었는지 본다.
3. 예상보다 많은 binary가 바뀌었다면 target engine conversion, redirector, custom version이 함께 적용됐는지 조사한다.
4. 같은 명령을 한 번 더 실행해 추가 resave 대상이 남지 않는지 확인한다.
5. 주요 map을 열고 Blueprint compile, Asset validation, gameplay smoke test를 수행한다.
6. clean cook와 package build를 실행한다.
7. 원래 warning이 사라졌는지, 새 serialization·load warning이 생기지 않았는지 비교한다.
8. 결과를 engine migration 전용 commit 또는 changelist로 분리한다.

ResavePackages는 header byte 몇 개만 patch하는 도구가 아니다. 각 package를 실제로 load하고 저장하므로 target engine의 serialization conversion과 editor-side save 동작이 적용된다. binary diff가 넓을 수 있는 이유다.

ZeroEngineVersionWarning은 언제 쓰는가#

False와 0은 bool parser에서 같은 warning toggle 값으로 동작한다.

1
; Config/DefaultEngine.ini
2
[Core.System]
3
ZeroEngineVersionWarning=False

어느 표기를 쓰든 다음은 변하지 않는다.

• package의 SavedByEngineVersion을 수정하지 않는다.
• 호환성을 검증하거나 복구하지 않는다.
• cook output과 source Asset을 고치지 않는다.
• process의 log message만 억제한다.

값은 process에서 일찍 읽힐 수 있으므로 설정을 바꾼 뒤 Editor와 commandlet을 다시 시작한다. PC 재부팅은 필요 없다.

조직이 의도적으로 CL0 source build를 사용하고, 별도 Object/Custom Version과 test matrix로 위험을 관리하며, 이 warning이 예상된 noise라는 결정을 내린 경우에는 억제를 고려할 수 있다. 일반 project migration에서 log를 깨끗하게 보이게 하려고 사용하는 해결책은 아니다.

Cook과 compatibility에 미치는 영향#

warning은 기본적으로 warning이므로 항상 cook을 중단시키지는 않는다. CI가 warning을 error로 승격하면 project policy 때문에 실패할 수 있다. 더 중요한 위험은 package가 어느 nonzero changelist build에서 저장됐는지 근거가 없어 engine-version compatibility 검사가 관대해진다는 점이다.

• warning을 숨겨도 compatibility risk는 그대로다.
• target UE5에서 resave한 Asset이 이전 UE4.27에서 다시 열린다고 기대하지 않는다.
• standard UE4.27→UE5 forward migration 가능성과 4.27-Plus custom fork의 serializer 호환성은 별개다.
• plugin의 Custom Version이 있다면 target version의 upgrade path를 따로 test한다.
• third-party content를 수정할 권한이 없으면 vendor update나 별도 migration copy를 검토한다.

UE5의 Migration Guide는 UE4.27 project를 UE5로 가져올 수 있지만 새 engine에서 저장한 Asset을 이전 engine으로 되돌리는 workflow를 보장하지 않는다고 경고한다.

흔한 실수#

• 경로에 공백이 있는데 실행 파일과 .uproject를 하나의 문자열 명령으로 조립함
• -ProjectOnly 없이 mounted Engine content까지 넓게 순회함
• Editor를 열어 둔 채 external commandlet로 같은 package를 저장함
• target Build.version의 changelist가 0인데 resave를 반복함
• dirty working tree에서 실행해 기존 Asset 변경과 migration diff를 섞음
• Perforce 자동 checkout과 자동 submit을 검토 없이 켬
• ZeroEngineVersionWarning=0을 metadata repair로 오해함
• Cook -UnVersioned를 source Asset 경고의 반대 option으로 오해함
• UE5에서 저장한 Asset을 UE4 branch에 다시 복사함
• warning 수만 줄고 새 load/cook error가 생겼는지 확인하지 않음

결론#

Asset has been saved with empty engine version은 대개 source package의 SavedByEngineVersion changelist가 0인데 target Editor는 nonzero changelist를 가진 상황을 뜻한다. Asset은 load되지만 정확한 저장 engine을 근거로 한 compatibility 판단이 느슨해진다.

안전하게 해결하려면 target engine의 changelist부터 확인하고 canary Asset을 수동 저장해 원인을 검증한다. 그런 다음 깨끗한 복사본이나 source-control changelist에서 ResavePackages -OnlyUnversioned -ProjectOnly를 실행하고, binary diff, log, map load, Blueprint compile, clean cook와 package를 모두 확인한다.

ZeroEngineVersionWarning=0은 의도적인 CL0 pipeline에서 noise를 억제하는 설정일 뿐이다. package metadata를 복구하지 않으므로 일반 migration의 두 번째 해결책으로 나열해서는 안 된다.

참고 자료#

• Epic Games: Versioning of Assets and Packages
• Epic Games UE 4.27: Versioning of Assets and Packages
• Epic Games: FPackageFileSummary
• Epic Games: FEngineVersionBase
• Epic Games: FBuildVersion
• Epic Games: UResavePackagesCommandlet
• Epic Games: Updating projects to newer versions
• Epic Games: Content Cooking
• Epic Developer Community: empty engine version forum answer