카드 해금 상태를 유지하려면 저장 필드만 바꾸면 될 것 같지만, 스토리 게임에서는 플레이어가 정보를 접하는 순서도 지켜야 합니다. 챕터가 해금되어도 공개 시점에 이르기 전까지 해당 챕터의 카드는 숨길 수 있습니다. 카드를 수집해도 활성 덱에 넣지 않을 수 있습니다. 저장 흐름을 확장하기 전에 이러한 상태를 각각 모델링한 뒤, 챕터를 전환하거나 이전 저장 데이터를 불러올 때 어떻게 동작하는지 테스트하세요.

이 가이드는 기존 카드 기반 스토리 게임 프로젝트를 대상으로 합니다. 아래의 기록관, 카드, 챕터 분기, 공개 규칙은 설명을 위해 만든 가상의 예시입니다. 프로젝트의 실제 콘텐츠 모델과 스포일러 방지 정책에 맞게 적용하세요.
접근, 발견, 선택 상태를 구분하기
먼저 카드와 관련된 상태를 나열하고 각 상태가 얼마나 오래 유지되는지 정리하세요. ‘해금’은 챕터에 들어갈 수 있다는 뜻일 수 있습니다. ‘수집’은 플레이어가 증거 카드를 찾았다는 뜻일 수 있습니다. ‘공개’는 스토리에서 카드 앞면이나 텍스트를 보여 주었다는 뜻일 수 있습니다. ‘선택’은 임시 열람용 덱에 넣은 카드나 대화 선택지를 가리킬 수 있습니다. 불리언 값 하나로 이 네 가지를 모두 판단하면 화면 표시와 스토리 로직이 서로 어긋날 수 있습니다.
| 상태 | 의미 | 초기화 관련 확인 사항 |
|---|---|---|
| 접근 | 플레이어가 챕터나 분기에 들어갈 수 있음 | 새 세션을 시작하거나 챕터를 다시 플레이해도 접근 권한이 유지되는가? |
| 발견 | 특정 카드나 단서를 찾았음 | 챕터를 초기화하면 발견 기록이 사라질 수 있는가? |
| 공개 | 스토리에서 카드 내용을 보여 주었음 | 메뉴에 카드 이미지나 텍스트를 언제부터 표시할 수 있는가? |
| 선택 | 카드가 활성 덱에 들어 있거나 현재 선택되어 있음 | 장면이나 한 회차가 끝나면 선택이 해제되는가? |
가상의 메리디언 기록 보관소에서는 황동 열쇠 카드를 발견하면 컬렉션에 추가되고, 이후 장면에서 그 카드에 얽힌 이야기가 공개됩니다. 챕터 접근 권한은 별도의 분기 플래그가 제어합니다. 플레이어가 다른 챕터를 시작하면 임시 열람용 덱은 초기화됩니다. 이는 설명을 위한 설계 규칙이며, 실제 게임에서 관찰한 동작은 아닙니다.
해금 시 이후 스토리가 노출되지 않게 하기
챕터 목록, 컬렉션 화면, 손패와 덱, 대화 선택지, 다시 플레이 메뉴에서 각각 플레이어에게 무엇을 보여 줄지 정하세요. 접근 권한을 유지하더라도 모든 화면에 카드 제목, 이미지, 설명을 공개할 필요는 없습니다. 잠겨 있거나 아직 발견하지 못한 카드는 자리 표시자로 보여 주면 스토리 세부 내용을 숨기면서 컬렉션의 구성을 유지할 수 있습니다.

콘텐츠 ID 옆에 공개 규칙을 적어 두세요. 분기마다 먼저 발생해야 할 이벤트, 접근을 해금하는 플래그, 카드를 처음 공개할 수 있는 장면을 기록하세요. 그런 다음 공개 직전과 직후에 저장 데이터를 다시 불러와 테스트하세요. UI만 수정하면 한 메뉴에서는 스포일러가 가려져도 대화 프롬프트나 생성된 썸네일에는 여전히 드러날 수 있습니다.
| 플레이어가 보는 화면 | 확인할 질문 | 검증 방법 |
|---|---|---|
| 챕터 목록 | 스토리 텍스트를 노출하지 않고 접근 가능 여부를 표시하는가? | 잠긴 상태, 해금된 상태, 다시 플레이할 때의 상태를 확인합니다 |
| 컬렉션 | 아직 발견하지 않은 카드에서 스포일러가 드러나지 않는가? | 제목, 이미지, 미리보기, 툴팁을 확인합니다 |
| 활성 덱 | 유효한 선택만 표시되는가? | 각 공개 시점의 전후에 장면에 들어갔다가 나옵니다 |
| 대화 | 나중에 등장하는 카드가 앞선 선택지에 영향을 줄 수 있는가? | 해금 이벤트 전후의 저장 데이터를 각각 불러옵니다 |
카드 표시 이름보다 안정적인 콘텐츠 식별자를 사용하세요. 텍스트와 이미지는 바뀌거나 현지화될 수 있지만, archive_key_card 같은 키는 계속 같은 스토리 레코드를 가리켜야 합니다. 특수 조건을 메뉴와 장면 곳곳에 흩어 두기보다, 스토리나 콘텐츠를 이미 관리하는 시스템에 접근 규칙을 두세요.
기존 저장 및 콘텐츠 모델 확장하기
프로젝트에서 챕터, 인벤토리, 업적, 현재 선택 항목을 어떻게 저장하는지 추적하세요. 가능하면 기존 저장 슬롯과 초기화 동작을 재사용하세요. 새 ‘카드 해금 관리자’가 표시할 장면을 결정하는 스토리 시스템과 서로 다른 판단을 내릴 수 있습니다. 필드를 추가하기 전에 분기 플래그의 기준이 되는 데이터가 어디에 있는지 확인하세요.
Godot 안정 버전 문서의 저장 튜토리얼에서는 유지할 정보를 정하고 관련 데이터를 직렬화하는 방법을 보여 줍니다. 이는 특정 엔진의 예시이며, 스토리 데이터에 적용해야 하는 표준 스키마는 아닙니다. Godot을 사용하는 프로젝트라면 실제 엔진 버전을 확인하고 프로젝트의 현재 저장 구조를 따르세요. 다른 엔진을 사용한다면 해당 엔진의 문서와 프로젝트의 기존 규칙을 따르세요.
이전 저장 데이터에 새 카드 필드가 없을 때 어떻게 처리할지 명확히 정하세요. 컬렉션이 커졌다는 이유만으로 누락된 카드를 모두 해금 상태로 처리하지 마세요. 기존 챕터 플래그에서 접근 권한을 가져올지, 발견 기록을 비워 둔 채 초기화할지, 일회성 마이그레이션을 실행할지 결정하세요. 기존 게임에서 활성 덱을 계속 저장해 왔다면 그 상태를 유지하세요.
수정 전에 AI로 스토리 흐름 점검하기
관련 콘텐츠 ID, 저장 모델, 챕터 전환, 공개 이벤트, 기존 초기화 동작을 AI에 알려 주세요. 접근, 발견, 선택 상태를 각각 어디에서 읽고 쓰는지 정리하도록 요청하세요. 요청 범위를 좁혀 구현 전에 수정 대상 파일 목록, 최소한의 데이터 변경 사항, 마이그레이션 기본값, 스포일러 점검 항목, 롤백 계획을 제시하게 할 수 있습니다. 변경 사항을 검토하면서 이전 필드를 계속 사용하는 UI 경로가 있는지 확인하세요.
수정하기 전에 기존 카드 및 스토리 저장 흐름을 점검하세요. 챕터 접근 권한, 발견한 카드, 공개 상태, 현재 선택 상태를 각각 구분하세요. 기존 분기 순서, 챕터 초기화 동작, 현지화 ID, 저장 슬롯을 유지하세요. 먼저 각 상태를 관리하는 시스템과 영향을 받는 파일을 파악하세요. 그런 다음 이전 저장 데이터에 적용할 기본값, 스포일러 점검 항목, 롤백 절차를 포함해 변경 범위가 가장 작은 방안을 제안하세요. 프로젝트에서 테스트하기 전에는 상태가 정상적으로 유지된다고 단정하지 마세요.
SEELE의 카탈로그는 글로 작성한 아이디어를 바탕으로 게임을 만드는 기능과 플레이할 수 있는 게임의 카테고리를 소개합니다. 별도의 카드 기반 스토리 게임 콘셉트를 탐색하거나 장면의 연출 방향을 전달하는 데 도움이 될 수 있습니다. 카탈로그만으로는 SEELE이 기존 스토리 게임의 코드베이스를 수정하거나 플레이어의 저장 데이터를 마이그레이션할 수 있는지 확인할 수 없습니다.
신중하게 마이그레이션하고 복구할 수 있게 하기
이전 저장 데이터의 복사본을 사용하세요. 이전 스키마 버전과 새 스키마 버전, 추가한 필드, 기본값, 카드 ID가 더 이상 존재하지 않을 때의 동작을 기록하세요. 마이그레이션 전후의 접근 권한과 발견 기록을 비교할 수 있도록 수정하지 않은 복사본을 보관하세요. 파싱이나 마이그레이션에 실패하면 프로젝트의 기존 복구 절차를 따르세요. 유일한 저장 데이터를 불완전한 상태로 덮어쓰지 마세요.

예시 장부는 팀이 검토해야 할 항목을 설명하는 데 도움이 되지만, 실제 저장 데이터가 어떻게 동작하는지 입증하지는 못합니다. 데이터를 불러온 뒤 실제 챕터 목록, 컬렉션, 활성 덱, 대화를 확인하세요. 나중에 회귀 문제가 발생했을 때 같은 경로를 재현할 수 있도록 테스트 기록에 저장 데이터 버전과 챕터 ID를 포함하세요.
공개 및 초기화 시점의 전후 동작 테스트하기
새 프로필, 분기 해금 직전과 직후, 챕터를 다시 플레이한 뒤, 이전 저장 데이터의 복사본을 불러온 상태에서 각각 테스트하세요. 다음 표는 수행할 점검 항목이며, 완료된 테스트 결과는 아닙니다.
| 테스트 상황 | 실행할 동작 | 검증 항목 |
|---|---|---|
| 새 프로필 | 챕터 목록과 컬렉션 화면을 엽니다 | 이전에 해금된 상태가 남아 있거나 스포일러가 나타나지 않습니다 |
| 해금 이벤트 | 분기 접근 조건을 충족합니다 | 의도한 접근 상태만 바뀝니다 |
| 카드 발견 | 스토리 카드나 증거 카드를 찾습니다 | 올바른 ID로 컬렉션이 한 번만 갱신됩니다 |
| 장면에서 카드 공개 | 스토리에서 카드가 공개되는 시점까지 진행합니다 | 카드 내용이 올바른 시점에 표시됩니다 |
| 챕터 초기화 | 챕터를 다시 플레이하거나 재시작합니다 | 유지되는 접근 권한과 임시 선택 상태가 각각의 규칙에 따라 처리됩니다 |
| 이전 저장 데이터 | 이전 버전 저장 데이터의 복사본을 불러옵니다 | 마이그레이션 후에도 획득한 콘텐츠는 유지되고 이후 스토리의 세부 내용은 숨겨집니다 |
빌드, 저장 스키마, 챕터, 카드 ID, 실행한 동작, 예상 상태, 실제로 관찰한 상태를 기록하세요. 잘못된 카드가 표시되면 여러 시스템을 수정하기 전에 마이그레이션, 분기 조건 판정, 컬렉션 필터링, 공개 시점, UI 캐싱 중 어디에서 문제가 발생했는지 확인하세요.
자주 묻는 질문
스토리 게임에서 어떤 카드 해금 상태를 유지해야 하나요?
챕터나 플레이 세션이 바뀌어도 이용할 수 있어야 하는 스토리 또는 컬렉션 콘텐츠의 해금 상태를 유지하세요. 활성 덱, 임시 드래프트 선택, 한 회차에만 적용되는 효과는 설계상 유지할 필요가 있는 경우를 제외하고 별도로 관리하세요. 안정적인 콘텐츠 ID를 사용하고 플레이어가 초기화 규칙을 확인할 수 있게 하세요.
증거 카드 수집과 스토리 해금에 같은 플래그를 써야 하나요?
일반적으로 두 상태는 서로 다른 판단을 나타냅니다. 플레이어는 해당 챕터를 해금하지 않고도 카드를 발견할 수 있고, 카드를 선택하지 않고도 챕터를 해금할 수 있습니다. 게임에서 각 상태를 독립적으로 표시하거나 필터링하거나 초기화해야 한다면 별도로 모델링하세요. 가능하면 프로젝트의 기존 콘텐츠 모델을 재사용하세요.
스토리 카드 진행 상황을 저장할 때 스포일러를 어떻게 방지하나요?
해금된 콘텐츠와 현재 챕터나 화면에서 공개된 콘텐츠를 구분하세요. 저장되는 플래그로 접근 권한을 부여하면서도 UI에서는 스토리의 공개 순서를 지킬 수 있습니다. 챕터가 바뀌는 시점에 저장 데이터를 다시 불러와 테스트하고, 미리보기, 컬렉션 화면, 대화에서 이후 콘텐츠가 너무 일찍 노출되지 않는지 확인하세요.
이전 카드 저장 데이터를 새 해금 시스템으로 어떻게 마이그레이션하나요?
이전 저장 데이터의 복사본을 불러오고, 확인된 카드 식별자를 새 스키마에 매핑하고, 누락된 필드의 기본값을 정의하세요. 설계 의도에 따라 획득한 콘텐츠와 플레이어가 선택한 덱을 유지하세요. 마이그레이션 버전을 기록하고 실제 프로젝트 테스트를 통과할 때까지 복구할 수 있는 원본을 보관하세요.
모형 기록 보관소로 카드 해금 상태가 유지되는지 검증할 수 있나요?
검증할 수 없습니다. 모형으로 카드 그룹과 공개 규칙을 설명할 수는 있지만, 상태가 유지되는지 확인하려면 대상 빌드에서 실제로 저장하고 다시 불러온 뒤 챕터를 전환해야 합니다. 빌드 버전과 저장 데이터 버전, 해금될 것으로 예상한 카드, 각 동작 후 게임에 표시된 내용을 기록하세요.
스토리 전개에 맞게 상태 유지 설계하기
접근, 발견, 공개, 현재 선택 상태가 의도한 스토리 전개 순서에 맞도록 관리하세요. 하나의 기준 데이터 원천을 재사용하고, 저장 데이터의 복사본으로 마이그레이션을 진행하고, 콘텐츠가 바뀌는 모든 챕터 경계에서 테스트하세요. 이렇게 하면 이미 획득한 스토리 진행 상태를 잃거나 이후에 공개될 내용을 미리 드러내지 않으면서 카드 진행 시스템을 확장할 수 있습니다.
별도의 카드 기반 스토리 게임 콘셉트를 탐색하고 싶다면 SEELE AI Game Maker를 사용해 보세요. 새 콘셉트를 구상하는 데 활용할 수 있으며, 저장 데이터 마이그레이션 기능을 제공하는 도구는 아닙니다.


