게임 프로그래밍 저장 오류, 파일 형식부터 바꿀 필요 없다
1. 사라진 진행도가 파일에 있었는지부터 확인합니다
저장 실패와 복원 실패를 구분합니다
보스를 쓰러뜨리고 종료했는데 다시 켜니 보상이 사라졌나요? 이런 게임 저장 오류를 만났을 때 JSON을 바이너리로 바꾸기 전에, 값이 파일에 기록됐는지부터 확인해야 합니다. 기록 자체가 빠졌다면 형식을 바꿔도 같은 항목이 사라집니다.
체력은 돌아오는데 장비만 없어진다면 저장 직전, 파일 내부, 불러온 직후의 장비 ID를 비교합니다. 수집·기록·복원 중 값이 끊기는 구간을 찾는 것입니다. 아래 표에서 첫 점검 위치를 골라 보세요.
| 증상 | 먼저 볼 곳 | 확인할 증거 |
|---|---|---|
| 파일이 생기지 않음 | 경로와 쓰기 실패 처리 | 실제 저장 경로와 오류 코드 |
| 일부 항목만 초기화 | 필드 누락과 초기화 순서 | 파일 값과 적용 후 값 |
| 아이템이 두 배로 증가 | 기존 목록에 추가하는 로직 | 불러오기 전후 개수 |
- 같은 슬롯으로 재현합니다. 아이템 하나 획득, 저장, 종료, 재실행 순서를 고정합니다.
- 원본 파일을 복사합니다. 실패한 불러오기 뒤 자동 저장이 실행되면 원인을 담은 파일까지 덮일 수 있습니다.
배포한 게임에서만 실패한다면 실제 파일 경로도 비교합니다. 실행 위치에 의존하는 상대 경로는 엉뚱한 파일을 가리킬 수 있으므로, 엔진의 사용자 데이터 경로를 기준으로 확인합니다.
2. 실행 중인 객체와 저장할 데이터를 분리합니다
메모리 주소 대신 유지되는 ID를 남깁니다
장비 객체를 통째로 기록하면 코드 구조의 변경이 세이브 파일 구조에 번지기 쉽습니다. 별도의 저장 데이터에는 플레이어 ID, 아이템 ID, 수량처럼 다음 실행에서도 의미가 유지되는 값만 담습니다. 배열의 몇 번째 원소인지를 ID처럼 사용하면 정렬이나 아이템 추가 이후 엉뚱한 장비를 가리킬 수 있습니다.
- 아이템 종류와 개체를 구분합니다. 같은 검 두 자루라도 강화 수치가 다르다면 종류 ID 외에 개체별 ID가 필요합니다.
- 필드의 의미를 적습니다. 체력은 현재 값인지 최대 값인지, 퀘스트는 수락인지 완료인지 정의합니다.
- 재생성할 값은 제외합니다. 화면 표시 문자열이나 캐시처럼 원본 데이터에서 다시 계산할 수 있는 항목은 중복 저장을 줄입니다.
좌표의 기준과 숫자의 의미를 보존합니다
위치 값 세 개만 남기면 충분할까요? 부모 객체 기준의 로컬 좌표인지 월드 좌표인지, 어느 맵의 위치인지 함께 정해야 합니다. JSON에서는 엔진의 벡터 같은 자료형을 기본 숫자와 배열 등으로 변환하는 규칙도 필요하며, [Godot 공식 저장 문서](https://docs.godotengine.org/en/stable/tutorials/io/saving_games.html)에서도 이러한 자료형 제약을 설명합니다.
팁: 저장 항목 옆에 먼저 존재해야 하는 대상을 적어 보세요. 좌표에는 맵, 장비에는 소유자가 필요하다는 관계가 드러납니다.
사망 후 복귀 지점과 보상 지급 시점은 게임 규칙에 해당합니다. 협업에서는 기획자 용어 항목을 참고하며 담당자와 ‘어디까지 복원돼야 정상인가’를 먼저 합의합니다. 저장 범위를 문장으로 남기면 플레이 경험의 누락도 점검하기 쉽습니다.
3. 파일을 쓰는 도중 종료돼도 복구할 길을 만듭니다
완성된 새 파일을 확인한 뒤 교체합니다
기존 세이브 파일을 비우고 새 내용을 쓰는 도중 게임이 종료되면 이전 진행도와 새 진행도를 함께 잃을 수 있습니다. 임시 기록 → 검증 → 교체 순서로 설계하되, 이름 변경만으로 모든 플랫폼에서 전원 차단까지 안전해진다고 가정해서는 안 됩니다.
- 일관된 스냅샷을 만듭니다. 골드와 구매 아이템을 서로 다른 시점에서 읽지 않도록, 거래가 끝난 상태를 복사합니다.
- 별도 임시 파일에 기록합니다. 교체 제약을 줄이도록 대상과 같은 파일시스템에 두고, 쓰기 실패를 호출자에게 전달합니다.
- 다시 읽어 검증합니다. 구문 해석뿐 아니라 필수 필드, 슬롯 ID, 형식 버전이 기대한 값인지 확인합니다.
- 기존 정상본을 보존하며 교체합니다. 대상 운영체제와 엔진이 보장하는 교체 동작을 확인하고, 최초 저장처럼 기존 파일이 없는 경우도 처리합니다.
저장 요청이 겹치는 상황도 막습니다
비동기 저장 뒤 진행도가 되돌아간다면 완료 순서를 살펴보세요. 요청 A가 골드 100을 기록하는 동안 B가 골드 80을 먼저 저장하고, 늦게 끝난 A가 덮으면 구매 이전 값으로 돌아갑니다. 슬롯별 저장 큐로 쓰기를 직렬화하거나 이전 작업이 최신 결과를 덮지 못하도록 세대 번호를 확인하는 설계가 필요합니다.
- 성공 표시는 교체 완료 뒤에 냅니다. 요청을 접수했다는 이유만으로 ‘저장 완료’를 띄우지 않습니다.
- 백업도 검증합니다. 현재 파일이 손상됐다고 무조건 덮어쓰지 말고, 이전 정상본을 읽을 수 있는지 먼저 확인합니다.
전원 차단에 대비하려면 플랫폼에 따라 버퍼 동기화와 디렉터리 갱신까지 고려해야 합니다. 배포 대상 기기에서 쓰기 실패와 강제 종료 시험을 나누어 진행합니다. 실패 시에는 마지막 정상 저장 시각을 보여 주고 재시도할 수 있게 합니다.
4. 업데이트 뒤 깨지는 세이브는 버전으로 추적합니다
게임 버전과 저장 형식 버전을 나눕니다
새 필드를 추가한 뒤 예전 세이브가 열리지 않는다면 누락 값을 처리하는 규칙부터 확인합니다. 저장 형식 버전은 화면에 표시하는 게임 버전과 별도로 두는 편이 관리하기 쉽습니다. 배경음만 바뀐 업데이트와 장비 데이터 구조가 바뀐 업데이트를 같은 변환 작업으로 다룰 필요는 없습니다.
- 원본을 보존한 채 읽습니다. 변환에 실패해도 사용자의 파일은 그대로 남아야 합니다.
- 버전별로 순서대로 변환합니다. 형식 1에서 2, 2에서 3으로 바꾸는 작은 함수를 연결하면 문제 구간을 찾기 쉽습니다.
- 변환 결과를 검증합니다. 체력의 허용 범위, 중복 개체 ID, 존재하지 않는 아이템 참조 등을 확인합니다.
- 미지원 최신 형식은 중단합니다. 더 최신 게임에서 만든 파일을 읽지 못할 때 기본값으로 덮어쓰는 행동을 막습니다.
예를 들어 과거 파일에 난이도 항목이 없다면 당시 규칙과 같은 난이도를 기본값으로 넣을 수 있습니다. 반면 이미 존재하는 골드 값이 음수라고 무조건 0으로 바꾸면 데이터 손상의 원인을 숨길 수 있습니다. 없는 값의 보완과 잘못된 값의 처리를 구분하고, 자동 수정이 허용되는 항목만 명시합니다.
이전 형식의 정상본, 항목이 빠진 파일, 중간에서 잘린 파일을 시험용으로 보관합니다. 복원된 장비와 퀘스트를 검사하고, 실패한 파일이 자동 저장으로 훼손되지 않는지도 확인합니다.
5. 짧은 데모와 장기 운영 게임의 복구 범위는 다릅니다
저장 직전과 복원 직후를 연결해 시험합니다
저장 버튼과 불러오기 버튼이 각각 동작한다고 진행도가 보존되는 것은 아닙니다. 저장 → 종료 → 실행 → 복원을 한 과정으로 묶고, 같은 파일을 연속으로 두 번 불러와도 아이템이나 보상이 늘지 않는지 확인합니다. 로딩 중 퀘스트 완료 이벤트가 재발행되면 이미 받은 보상이 다시 지급될 수 있습니다.
- 복원 순서를 나눕니다. 맵과 객체를 만든 뒤 ID로 관계를 연결하고, 모든 값이 준비된 다음 일반 게임 이벤트를 재개합니다.
- 중단 지점을 바꿉니다. 임시 파일 기록 중, 검증 후, 교체 직전 등 개발용 중단 지점을 만들어 이전 정상본으로 돌아오는지 봅니다.
- 측정 대상을 구분합니다. 데이터 수집 시간, 파일 쓰기 시간, 복원 시간을 각각 기록해야 프레임 멈춤의 원인을 찾기 쉽습니다.
개발 경험을 공유한다면 어떤 실패를 재현했고 어떻게 복구했는지를 남깁니다. GDC 용어 항목에서 개발자 행사 용어를 살펴보고, 발표 자료에는 테스트용 파일과 재현 절차를 준비합니다.
유지할 진행도의 길이에 맞춰 선택합니다
짧은 게임 프로그래밍 데모를 만드는 독자라면 읽기 쉬운 저장 형식, 한 개 슬롯, 정상본 백업과 재시작 시험부터 구현하기를 권합니다. 업데이트를 이어 갈 게임을 운영하는 독자라면 형식 변환과 여러 세대의 정상본 보관을 먼저 설계하고, 클라우드를 쓴다면 두 기기의 저장 충돌 처리도 추가하기를 권합니다.

- 다음글게임 프로그래밍 데모를 공개할 개발자라면 엔진보다 범위를 먼저 보세요 26.10.14
등록된 댓글이 없습니다.
