세이브, 현지화, 리소스 패키지 구성하기: 이후 업데이트 때 게임 전체를 다시 만들지 않으려면

업데이트 가능한 인터랙티브 영상 게임은 서사 로직, 플레이어 세이브, 현지화 텍스트, 미디어 리소스를 분리하고 안정적인 ID와 버전 매니페스트로 연결해야 합니다. 자막 한 구간을 수정한다고 모든 영상을 다시 패키징해서는 안 되고, 영상 하나를 교체한다고 기존 세이브가 무효화되어서는 안 되며, 언어를 추가한다고 전체 분기 로직을 복제해서도 안 됩니다.

로직 패키지는 노드, 조건, 선택지, 상태에 미치는 효과를 저장합니다. 텍스트 패키지는 언어별로 UI 텍스트, 자막, 메타데이터를 저장합니다. 미디어 패키지는 영상, 오디오, 이미지를 저장합니다. 세이브는 플레이어 상태와 필요한 버전 정보만 저장하고 콘텐츠를 복제하지 않습니다. 실행 시에는 논리적 에셋 ID를 통해 현재 언어와 플랫폼에 해당하는 파일을 찾습니다.

경계를 명확히 나누면 팀은 자막이나 인코딩을 독립적으로 업데이트할 수 있습니다. 대사 텍스트, 파일 경로, 조건을 하나의 스크립트에 모두 하드코딩하면 수정할 때마다 광범위한 회귀 테스트가 필요해집니다.

세이브에는 schemaVersion, 콘텐츠 버전, 현재 노드, 확정된 선택, 관계, 증거, 자원, 세계 상태, 읽은 에셋, 설정을 기록합니다. 노드 제목, 파일명, 표시 텍스트는 번역이나 편집 후 바뀔 수 있으므로 로직 판단에 사용하지 않습니다.

변수 이름, 타입, 기본값을 변경할 때마다 이전 스키마에서 새 스키마로 옮기는 마이그레이션을 작성합니다. 예를 들어 0–100의 신뢰도를 세 단계로 바꾼다면 각 구간이 어느 단계에 대응하는지 명확히 정해야 합니다. 마이그레이션에 앞서 세이브를 복사하고 검증하며, 실패하면 원본 세이브를 보존하고 이해할 수 있는 안내를 표시합니다. 아무 안내 없이 진행 상황을 초기화해서는 안 됩니다.

각 텍스트에는 안정적인 키를 사용하고 노드, 화자, 화면 맥락, 글자 수 제한, 변수 설명, 참고 영상을 함께 제공합니다. 맥락 없이 떨어져 있는 “좋아”, “계속” 같은 표현은 정확히 번역할 수 없습니다. 번역가는 그것이 동의인지, 만족의 표현인지, 버튼 조작인지 알아야 합니다. 선택지에도 플레이어의 의도를 설명해 번역 때문에 약속의 의미가 달라지지 않도록 해야 합니다.

자막은 타임코드를 공유할 수 있지만 텍스트 길이가 다르므로 줄바꿈과 미세한 타이밍 조정을 허용해야 합니다. 더빙은 언어에 따라 길이가 더 크게 달라지므로 상호작용이 나타나는 시점을 원어 오디오의 마지막 프레임에만 의존해서는 안 됩니다. 의사 현지화로 텍스트 길이 증가, 문자 집합, 누락된 글리프, UI 레이아웃을 미리 테스트합니다.

Steam은 상점과 게임의 언어 지원에 관한 문서를 제공하지만, 실제 출시 가능한 언어, 상점의 언어 표기, 빌드 설정은 출시 시점의 공식 요구 사항을 기준으로 해야 합니다. Steam 현지화 문서

일반적인 분할 기준에는 챕터, 언어, 플랫폼, 해상도가 있습니다. 초기 패키지에는 런타임, 도입부, 필요한 UI를 포함하고 이후 챕터는 필요할 때 다운로드할 수 있게 합니다. 다국어 더빙은 별도 패키지로 구성하고, 용량이 작은 자막은 기본 패키지에 포함할 수 있습니다. 너무 잘게 나누면 매니페스트, 요청, 디스크 단편화에 드는 비용이 증가합니다.

각 패키지에는 버전, 의존성, 크기, 체크섬, 선택 사항 여부를 나타내는 표시가 있습니다. 챕터에 진입하기 전에 필요한 패키지가 온전한지 검증합니다. 중단된 다운로드는 이어받을 수 있어야 하며, 검증에 실패하면 다시 받아야 합니다. 캐시를 삭제할 때 세이브를 삭제하지 않고, UI에는 어떤 콘텐츠를 다시 다운로드할 수 있는지 설명합니다.

노드는 VID_C03_N010_MAIN을 참조하고, 리소스 매니페스트는 플랫폼, 언어, 품질에 따라 실제 파일로 연결합니다. 새 인코딩을 배포할 때는 매니페스트와 패키지만 업데이트하고 노드는 변경하지 않습니다. 매니페스트 자체에도 서명이나 무결성 검증이 필요합니다. 업데이트가 일부만 적용되어 로직이 존재하지 않는 파일을 가리키는 상황을 방지하기 위해서입니다.

업데이트 실패 시 롤백할 수 있도록 이전 매니페스트를 일정 기간 보관합니다. 클라이언트가 시작되면 먼저 로직 패키지, 리소스 패키지, 세이브 스키마가 함께 실행될 수 있는지 호환성을 판단해야 합니다. 서로 맞지 않는 조합으로 게임에 진입하게 해서는 안 됩니다.

콘텐츠 업데이트가 현재 챕터를 바꾼다면 메인 메뉴, 챕터 종료 시점, 명확한 안내 후 재시작 같은 안전한 시점에 적용합니다. 플레이어가 시청하는 도중에 노드를 교체하지 않습니다. 핫 업데이트 전에 트랜잭션 체크포인트를 저장하고, 업데이트 후에는 마이그레이션을 실행한 뒤 재현 가능한 위치에서 재개합니다.

이미 출시된 스토리에서는 가급적 노드 ID를 재사용하지 않고 기존 선택의 의미를 임의로 바꾸지 않는 것이 좋습니다. 반드시 재구성해야 한다면 이전 노드와 새 노드의 대응 관계를 만들고 가능한 모든 세이브에 대해 자동 테스트를 수행합니다.

플랫폼, 언어, 화질, 챕터의 조합을 나열하고 반드시 테스트해야 하는 대표 설정을 표시합니다. 기본 로직은 매번 전체 회귀 테스트를 수행하고, 미디어 교체는 참조, 첫 프레임, 자막을 중점적으로 확인합니다. 세이브 마이그레이션에는 과거 버전의 샘플을 사용합니다. 누락된 키, 고립된 리소스, 중복 ID, 잘못된 의존성, 패키지 용량의 비정상적인 증가를 자동으로 검사합니다.

실제로 로드한 매니페스트, 패키지, 에셋의 버전을 로그에 기록해야 사용자 제보가 들어왔을 때 재현할 수 있습니다. 단계적 배포와 캐시 때문에 서로 다른 조합이 생기므로 “최신 버전”이라는 정보만으로는 부족합니다.

핵심 콘텐츠가 다운로드에 의존한다면 서버를 사용할 수 없을 때 구매한 플레이어가 이미 다운로드한 챕터에 계속 접근할 수 있는지, 필요한 인증을 어떻게 캐시할지, 설치 패키지를 보관할 수 있는지 고려해야 합니다. 구체적인 사업 및 플랫폼 방안은 다르지만, 이 위험은 아키텍처 설계 단계에서 논의해야 합니다. 서비스가 종료될 때 모든 노드에 온라인 매니페스트가 필요하다는 사실을 뒤늦게 알아서는 안 됩니다.

다음 단계: 로직, 텍스트, 미디어, 세이브 네 계층의 의존성 다이어그램을 그리고, 기존 세이브 하나로 “영상 교체＋언어 추가＋변수 이름 변경” 업데이트를 연습해 보세요. 마이그레이션, 롤백, 오프라인 복구를 모두 완료할 수 있어야 유지보수 가능한 아키텍처라고 할 수 있습니다.