
업데이트 전에는 저장 파일에 coins: 300을 기록했는데, 새 버전에서는 currencies.gold를 읽도록 바꿨다고 하자. 새 버전에서 만든 파일은 잘 열려도 이전 파일을 읽는 경로는 별도로 시험해야 한다. 예전 값을 어디로 옮길지 정하지 않았다면 플레이어가 모은 재화를 이어받지 못할 수 있다.
이 글에서는 저장 형식이 달라지는 가상의 예제로 변환 규칙과 시험 순서를 살펴본다. 기준은 파일이 열리는지에 그치지 않는다. 이전의 재화와 진행 상태가 유지되고, 다시 저장한 뒤에도 플레이를 이어 갈 수 있어야 한다.
빌드 번호와 저장 형식의 버전을 나누기
Unreal Engine의 저장·불러오기 안내는 필요한 상태를 SaveGame 객체에 담아 기록하고 다시 읽는 흐름을 설명한다. 과거 데이터의 의미를 새 구조로 옮기는 규칙은 프로젝트에서 따로 정해야 한다.
코드나 아트만 바꾼 빌드와 저장 데이터의 구조가 달라진 빌드는 구별할 수 있다. 아래는 개념을 설명하기 위한 자체 JSON 예시다. Unreal의 실제 SaveGame 파일 형식을 뜻하지 않는다.
이전 형식:
{
"schemaVersion": 1,
"coins": 300,
"checkpoint": "forest_gate"
}
새 형식:
{
"schemaVersion": 2,
"currencies": { "gold": 300 },
"checkpoint": "forest_gate"
}
이 게임에서는 예전 coins가 새 gold와 같은 재화를 뜻한다고 합의했다고 가정한다. 그러면 버전 1의 값을 버전 2의 해당 위치로 옮기는 규칙을 작성할 수 있다. 이름이 달라졌다는 이유로 잔액을 0으로 시작하거나, 값의 의미를 확인하지 않고 새로운 재화와 합쳐서는 안 된다.
변환 과정에서는 지원하는 버전인지, 필수 값과 자료형이 맞는지, 게임이 정한 범위를 벗어나지 않는지 확인한다. 이전 형식을 읽는 기능과 새 형식으로 쓰는 기능을 나눠 두면 어느 경계에서 실패했는지 조사하기 쉽다. 구체적인 직렬화·버전 관리 구현은 사용하는 엔진과 프로젝트에 맞춰 정해야 한다.
원본을 보존한 채 변환 결과 확인하기
아래는 이 글에서 제안하는 변환 검수 순서다. 저장 장치와 플랫폼의 파일 처리 기능에 따라 구현 방법은 달라진다.
- 시험용 사본에서 파일의 버전과 데이터를 읽는다.
- 지원하는 이전 버전에만 정해 둔 변환 규칙을 적용한다.
- 재화, 아이템, 체크포인트 등 보존할 값을 원본과 대조한다.
- 새 형식으로 저장한 결과를 다시 읽어 실제 플레이를 이어 간다.
- 검증에 실패하면 기존 원본을 보존하고 복구·재시도 방법을 안내한다.
파일이 없다는 경우와 파일은 있지만 읽을 수 없다는 경우를 구분한다. 두 상황을 모두 ‘처음 실행’으로 처리해 새 저장을 덮어쓰면, 조사할 원본까지 잃을 수 있다. 지원하지 않는 미래 버전의 파일도 임의로 초기화하지 않는다. 다운그레이드를 허용할지, 현재 빌드에서는 열 수 없다고 안내할지를 별도 정책으로 정한다.
변환은 여러 번 시도했을 때 재화나 보상이 중복 지급되지 않는지도 확인한다. 새 형식에 도달한 파일을 다시 읽었는데 이전 변환 규칙이 또 실행된다면 버전 판별과 저장 시점을 살펴야 한다.
클라우드 파일과 다른 기기의 상태도 확인하기
Steam Cloud 문서는 현재 Steam 사용자마다 구분되는 저장 경로를 사용하도록 안내하고, 여러 플랫폼을 지원할 때 동기화 설정과 경로 재정의를 고려하도록 설명한다. 따라서 한 PC의 새 파일만 확인하고 시험을 마치지 않는 편이 좋다.
다음은 자체 시험 표다. 모든 게임이 이 상황을 지원한다는 뜻은 아니며, 실제 지원 범위에 맞춰 선택한다.
| 상황 | 확인할 내용 |
|---|---|
| 이전 공개 빌드에서 만든 저장을 새 빌드로 열기 | 진행 상태를 보존하고 새 형식으로 다시 읽을 수 있는가 |
| 한 계정이 다른 기기에서 이어 하기 | 같은 슬롯을 찾고 기기별 설정과 진행 데이터를 의도대로 구분하는가 |
| 로컬 파일과 동기화된 파일의 진행이 다름 | 선택한 파일과 결과를 확인할 수 있고 원본을 보존하는가 |
| 저장 공간 부족이나 쓰기 실패 | 성공으로 표시하지 않고 재시도·안내 경로가 있는가 |
| 읽을 수 없는 값이나 지원하지 않는 버전 | 초기화로 숨기지 않고 실패를 구분해 처리하는가 |
‘저장 중’과 ‘저장 완료’도 구분한다. Epic의 비동기 저장 예시는 완료 콜백에 성공 여부가 전달되는 구조를 설명한다. 저장 요청을 시작했다는 사실만으로 화면에 완료를 표시하지 않도록 구현과 안내를 함께 확인한다.
업데이트 시험에 사용할 과거 파일을 남기기
새 기능 시험용 파일만 만들지 말고 지원할 이전 버전별로 시험 파일을 보관한다. 각 파일에는 만든 빌드, 저장 형식 버전, 예상 재화·아이템·진행 상태, 필요한 콘텐츠 조건을 연결한다. 실제 플레이어의 개인정보나 계정 정보를 복사하기보다 검수 목적의 데이터를 준비한다.
배포 전에는 이전 파일을 읽고, 저장하고, 종료한 뒤 다시 읽는 경로까지 확인한다. 단순 복구 절차는 백업과 복구 검수 글에서 다루었다. 이 글의 초점은 파일의 존재뿐 아니라 업데이트 전후에 그 안의 진행 상태가 같은 의미로 유지되는지 확인하는 데 있다.