모든 인사이트

기술과 교육 기록

게임 업데이트 뒤에도 이전 저장 데이터를 불러오려면

저장 형식의 버전과 변환 규칙을 구분하고, 업데이트·다른 기기·실패 상황에서 진행 상태를 보존하는 검수 방법을 정리한다.

기록 상자와 노트, 붓을 그린 수채화풍 삽화

업데이트 전에는 저장 파일에 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으로 시작하거나, 값의 의미를 확인하지 않고 새로운 재화와 합쳐서는 안 된다.

변환 과정에서는 지원하는 버전인지, 필수 값과 자료형이 맞는지, 게임이 정한 범위를 벗어나지 않는지 확인한다. 이전 형식을 읽는 기능과 새 형식으로 쓰는 기능을 나눠 두면 어느 경계에서 실패했는지 조사하기 쉽다. 구체적인 직렬화·버전 관리 구현은 사용하는 엔진과 프로젝트에 맞춰 정해야 한다.

원본을 보존한 채 변환 결과 확인하기

아래는 이 글에서 제안하는 변환 검수 순서다. 저장 장치와 플랫폼의 파일 처리 기능에 따라 구현 방법은 달라진다.

  1. 시험용 사본에서 파일의 버전과 데이터를 읽는다.
  2. 지원하는 이전 버전에만 정해 둔 변환 규칙을 적용한다.
  3. 재화, 아이템, 체크포인트 등 보존할 값을 원본과 대조한다.
  4. 새 형식으로 저장한 결과를 다시 읽어 실제 플레이를 이어 간다.
  5. 검증에 실패하면 기존 원본을 보존하고 복구·재시도 방법을 안내한다.

파일이 없다는 경우와 파일은 있지만 읽을 수 없다는 경우를 구분한다. 두 상황을 모두 ‘처음 실행’으로 처리해 새 저장을 덮어쓰면, 조사할 원본까지 잃을 수 있다. 지원하지 않는 미래 버전의 파일도 임의로 초기화하지 않는다. 다운그레이드를 허용할지, 현재 빌드에서는 열 수 없다고 안내할지를 별도 정책으로 정한다.

변환은 여러 번 시도했을 때 재화나 보상이 중복 지급되지 않는지도 확인한다. 새 형식에 도달한 파일을 다시 읽었는데 이전 변환 규칙이 또 실행된다면 버전 판별과 저장 시점을 살펴야 한다.

클라우드 파일과 다른 기기의 상태도 확인하기

Steam Cloud 문서는 현재 Steam 사용자마다 구분되는 저장 경로를 사용하도록 안내하고, 여러 플랫폼을 지원할 때 동기화 설정과 경로 재정의를 고려하도록 설명한다. 따라서 한 PC의 새 파일만 확인하고 시험을 마치지 않는 편이 좋다.

다음은 자체 시험 표다. 모든 게임이 이 상황을 지원한다는 뜻은 아니며, 실제 지원 범위에 맞춰 선택한다.

상황 확인할 내용
이전 공개 빌드에서 만든 저장을 새 빌드로 열기 진행 상태를 보존하고 새 형식으로 다시 읽을 수 있는가
한 계정이 다른 기기에서 이어 하기 같은 슬롯을 찾고 기기별 설정과 진행 데이터를 의도대로 구분하는가
로컬 파일과 동기화된 파일의 진행이 다름 선택한 파일과 결과를 확인할 수 있고 원본을 보존하는가
저장 공간 부족이나 쓰기 실패 성공으로 표시하지 않고 재시도·안내 경로가 있는가
읽을 수 없는 값이나 지원하지 않는 버전 초기화로 숨기지 않고 실패를 구분해 처리하는가

‘저장 중’과 ‘저장 완료’도 구분한다. Epic의 비동기 저장 예시는 완료 콜백에 성공 여부가 전달되는 구조를 설명한다. 저장 요청을 시작했다는 사실만으로 화면에 완료를 표시하지 않도록 구현과 안내를 함께 확인한다.

업데이트 시험에 사용할 과거 파일을 남기기

새 기능 시험용 파일만 만들지 말고 지원할 이전 버전별로 시험 파일을 보관한다. 각 파일에는 만든 빌드, 저장 형식 버전, 예상 재화·아이템·진행 상태, 필요한 콘텐츠 조건을 연결한다. 실제 플레이어의 개인정보나 계정 정보를 복사하기보다 검수 목적의 데이터를 준비한다.

배포 전에는 이전 파일을 읽고, 저장하고, 종료한 뒤 다시 읽는 경로까지 확인한다. 단순 복구 절차는 백업과 복구 검수 글에서 다루었다. 이 글의 초점은 파일의 존재뿐 아니라 업데이트 전후에 그 안의 진행 상태가 같은 의미로 유지되는지 확인하는 데 있다.

참고 자료

모든 인사이트로 돌아가기