미션 사이에 허브를 두면 각 런이 서로 이어지는 느낌을 줄 수 있습니다. 그만큼 새로 정해야 할 경계도 생깁니다. 런은 언제 끝나고, 보상은 언제 수령하며, 어떤 업그레이드가 다음 런까지 유지될까요? 메뉴나 재화를 추가하기 전에 이를 각각 별도의 상태 전이로 다루세요. 가장 안전한 확장 방법은 런 완료에서 허브를 거쳐 새 런을 시작하기까지의 흐름 하나를 완성하고, 그 과정에서 기존 진행도 관리 시스템을 재사용하는 것입니다.

이 가이드는 런이 반복되는 구조와 어떤 형태로든 진행도 시스템을 갖춘 기존 서바이버즈라이크 프로젝트를 전제로 합니다. 배달원과 작업장, 보상과 선택지는 모두 가상입니다. 설계는 실제 프로젝트에 맞게 조정하세요. 테스트를 진행한 프로젝트나 빌드는 없습니다.
런 상태와 메타 진행도 분리하기
런이 끝날 때 무엇이 초기화되고, 새 런을 시작한 뒤에도 무엇이 유지되는지 적어 보세요. 일시적인 무기 레벨, 체력 회복 아이템, 적 웨이브는 현재 런에 속합니다. 구매한 시작 아이템이나 캐릭터 해금 상태는 유지될 수 있습니다. 재화는 판단이 까다로울 수 있습니다. 런을 완료할 때 한 번 지급되나요? 허브에서 사용되나요? 아니면 두 가지에 모두 해당하나요? 같은 값이 두 역할을 맡는다면 각각의 상태 전이를 정확히 정의하세요.
| 상태 | 일반적인 유지 기간 | 기존 프로젝트에서 확인할 질문 |
|---|---|---|
| 런 보상 | 런 완료 후 수령할 때까지 | 다시 불러오거나 재방문하면 보상을 두 번 받을 수 있나요? |
| 런 빌드 | 현재 미션에만 적용 | 다음 런을 시작할 때 어떤 능력이 초기화되나요? |
| 허브 구매 | 설계에 따라 여러 런에 걸쳐 유지 | 영구 해금 상태를 어느 시스템에서 관리하나요? |
| 미사용 재화 | 설계에 따라 다름 | 다음 런에도 유지되나요, 소멸하나요, 아니면 해당 런에 귀속되나요? |
가상의 등불 작업장에서는 런을 완료하면 수령할 수 있는 보상이 생기고, 한 번의 구매로 시작 도구 하나가 해금되며, 일시적인 전투 업그레이드는 초기화됩니다. 설명을 위한 예시 규칙이며 실제 게임의 동작을 설명하는 것은 아닙니다. 상태의 경계를 명확히 하면 허브를 거치면서 이전 런의 빌드 전체가 새 미션으로 넘어가는 일을 막을 수 있습니다.
허브를 거쳐 다음 런으로 이어지는 흐름 설계하기
마지막 웨이브부터 다음 런을 시작하기까지의 순서를 따라가 보세요. 런이 끝나고 결과가 확정되면 보상을 계산합니다. 플레이어가 허브에 들어오면 선택지를 보여 주고, 구매를 확정한 뒤 새 런에 시작 상태를 전달합니다. 각 전이에서 어느 시스템이 데이터를 관리하는지, 플레이어가 게임을 종료하거나 이전 화면으로 돌아가면 어떻게 되는지 확인하세요.

허브의 스크립트에서 보상을 계산하는 동시에 결과 화면에서 같은 보상을 별도로 지급하는 구조는 피하세요. 런의 고유 식별자가 바뀌지 않도록 하고, 런 완료는 하나의 이벤트로 처리해 기존 진행도 관리 시스템으로 전달하는 편이 좋습니다. 같은 런을 다시 열었을 때 시스템은 보상이 이미 수령됐는지 알 수 있어야 합니다. 이는 검증할 설계 요건이며, 특정 코드베이스가 이미 그렇게 동작한다는 뜻은 아닙니다.
| 시점 | 상태 변화 | 주의할 오류 |
|---|---|---|
| 런 완료 | 점수와 지급 조건을 충족한 보상 확정 | 허브에 들어갈 때마다 보상을 다시 계산함 |
| 보상 수령 | 해당 런의 보상을 한 번만 수령 처리 | 다시 불러온 뒤 재화가 중복 지급됨 |
| 구매 | 재화를 차감하고 영구 해금 항목 추가 | 재화는 차감되지만 해금 상태가 저장되지 않음 |
| 새 런 | 메타 진행 상태를 바탕으로 새 런의 초기 상태 구성 | 일시적인 업그레이드가 다음 런에 넘어감 |
허브에서 이전 런의 요약을 보여 주면 플레이어가 선택하는 데 도움이 될 수 있습니다. 이 기록은 다음 미션을 초기화하는 데 쓰는 상태와 별도로 관리하세요. 게임에서 중도 포기, 재시도, 여러 저장 슬롯을 지원한다면 각 경로에 동일한 보상 수령 및 구매 규칙을 적용할지 정하세요.
기존 진행도 관리 시스템 확장하기
구현에 앞서 재화, 해금, 런 완료, 저장 데이터를 현재 어디에서 처리하는지 파악하세요. 기존 식별자와 초기화 함수를 재사용하세요. 메타 진행도 관리자를 하나 더 만들면 상태가 엇갈릴 수 있습니다. 허브에서는 아이템이 해금됐다고 표시하는데 런 초기화 로직은 여전히 다른 인벤토리를 읽는 식입니다.
AI에는 먼저 기존 흐름을 살펴보고 변경 범위가 가장 작은 패치를 제안해 달라고 요청하세요. 웨이브 진행 속도, 전투 조작, 런 종료 조건, 기존 보상 계산식, 저장 슬롯, 재시작 동작처럼 그대로 유지해야 할 항목을 구체적으로 명시하세요. 코드 변경을 승인하기 전에 변경할 파일과 데이터 필드 목록, 마이그레이션의 전제 조건, 롤백 절차를 요구하세요. 요약만 믿지 말고 실제 코드 변경 내역을 검토하세요.
SEELE의 현재 기능 안내에는 게임 아이디어를 구체화할 출발점을 만드는 기능과 플레이 가능한 게임의 유형이 소개되어 있습니다. 이를 활용해 별도의 서바이버즈라이크 콘셉트를 탐색하거나 허브 아이디어를 전달할 수 있습니다. 이 안내만으로는 SEELE이 기존 저장소를 편집하거나 저장 데이터를 마이그레이션할 수 있는지 확인할 수 없으므로, 통합에는 프로젝트에서 사용 중인 도구를 쓰세요.
기존 저장 데이터와 재시작 동작 보호하기
저장 데이터 사본을 사용해 새 허브 필드가 없을 때 어떤 일이 일어나는지 확인하세요. 기존 해금 상태를 유지하고 새 컬렉션을 비어 있는 상태로 초기화하는 방식이 안전한 기본값일 수 있지만, 적절한 규칙은 프로젝트마다 다릅니다. 스키마를 변경하기 전에 진행 중인 런, 미수령 보상, 이미 구매한 아이템, 재화 잔액을 어떻게 처리할지 정하세요.
Godot의 안정 버전 문서에서는 user://를 쓰기 가능한 사용자 데이터 경로로 설명하고, 파일 기반 저장 예제를 제공합니다. 또한 유지할 데이터를 식별하고 직렬화하는 방법을 보여 줍니다. 이 문서는 데이터를 어디에 어떻게 저장할지 살펴보는 데 도움이 되며, 어떤 허브 필드를 유지해야 하는지는 프로젝트에서 정해야 합니다. 기존 저장 시스템을 따르고 현재 엔진 버전과 대상 플랫폼을 확인하세요.
변경 전후의 스키마 버전, 추가한 필드, 대체값, 데이터를 읽지 못했을 때의 동작을 짧은 마이그레이션 메모로 남기세요. 비교할 수 있도록 변경하지 않은 저장 데이터 사본 하나를 보관하세요. 생성한 허브 이미지나 메뉴 목업을 기존 플레이어 데이터가 정상적으로 로드된다는 근거로 삼지 마세요.
허브를 상태 머신으로 테스트하기
핵심 흐름 전체를 아우르는 작은 구현부터 시작해 빌드, 저장 데이터 버전, 런 식별자, 수행한 조작, 예상 결과, 실제 결과를 기록하세요. 확인할 핵심은 상태 전이입니다. 런 완료 처리는 한 번만 일어나나요? 구매 결과는 유지되나요? 다음 런은 올바른 초기 상태에서 시작하나요? 아래 표는 테스트 계획안이며, 실제로 수행한 테스트 결과는 아닙니다.
| 시나리오 | 조작 | 예상 결과 |
|---|---|---|
| 정상 완료 | 런을 끝내고 허브에 들어감 | 확정된 보상이 하나 표시됨 |
| 재방문 | 결과 화면이나 허브에서 나갔다가 다시 열기 | 같은 런의 보상이 두 번 지급되지 않음 |
| 구매 | 재화를 사용해 항목 하나를 해금 | 재화 차감과 해금이 함께 반영됨 |
| 새 런 | 구매한 뒤 새 런 시작 | 영구 선택 사항이 적용되고 임시 빌드는 초기화됨 |
| 다시 불러오기 | 보상을 수령한 뒤 게임을 닫고 다시 불러오기 | 수령 상태와 구매 상태가 일관되게 유지됨 |
| 이전 저장 데이터 | 변경 전 저장 데이터 사본 불러오기 | 대체 처리로 게임을 계속 진행할 수 있음 |

테스트가 실패하면 어느 전이에서 상태가 예상과 달라지는지 확인하세요. 보상 생성, 수령, 구매, 저장, 런 초기화 중 어느 단계인지 파악하면 수정 범위를 좁히고 롤백하기도 쉬워집니다. 새 흐름이 프로젝트의 실제 회귀 테스트를 통과할 때까지 기존 흐름을 사용할 수 있게 유지하세요.
자주 묻는 질문
미션 사이 업그레이드 허브는 어떤 역할을 해야 하나요?
플레이어가 완료한 런의 성과를 바탕으로 제한된 선택지 중에서 고르고, 영구 해금 항목을 확인하고, 다음 런을 시작할 수 있는 공간을 마련하세요. 선택형 수집 요소, 영구 진행도, 이번 런의 보상은 화면에서 명확히 구분하세요. 허브는 게임의 기존 진행도 관리 시스템과 초기화 규칙을 재사용해야 합니다.
어떤 업그레이드가 다음 런에도 유지되어야 하나요?
구매한 시작 도구나 해금한 캐릭터 선택지처럼, 설계상 새 런에서도 유지할 선택만 남기세요. 일시적인 강화 효과는 런과 함께 초기화해야 합니다. 허브 인터페이스를 만들기 전에 재화, 난이도 조정 요소, 미사용 토큰을 유지할지 정하세요.
허브를 추가할 때 보상이 중복 지급되지 않게 하려면 어떻게 해야 하나요?
런 완료를 하나의 이벤트로 처리하고, 보상은 기존 진행도 관리 시스템을 통해 지급하세요. 재화를 추가하기 전에 해당 런의 보상이 이미 수령됐는지 기록하세요. 허브 재방문, 다시 불러오기, 도중에 중단된 상태 전이를 테스트해 재시도 시 같은 보상이 두 번 지급되지 않는지 확인하세요.
Godot에서 영구 업그레이드 데이터는 어디에 저장해야 하나요?
Godot의 안정 버전 문서에서는 user://를 쓰기 가능한 사용자 데이터 경로로 설명하고, 파일 기반 저장 예제를 제공합니다. 현재 엔진 버전과 플랫폼을 확인하고 기존 프로젝트의 저장 계층을 따르세요. 어떤 업그레이드를 유지할지는 게임 설계에서 정해야 합니다.
플레이어의 저장 데이터를 위험에 빠뜨리지 않고 새 업그레이드 허브를 테스트하려면 어떻게 해야 하나요?
저장 데이터 사본을 사용하고 현재 빌드와 저장 데이터 버전을 기록하세요. 런 완료, 한 번의 구매, 허브에서 나갔다가 다시 들어오기, 새 런 시작, 다시 불러오기, 이전 저장 데이터 불러오기를 테스트하세요. 새 흐름이 의도대로 동작할 때까지 비교를 위해 기존 진행도 흐름을 사용할 수 있게 유지하세요.
다음 런으로 이어지는 허브 만들기
업그레이드 화면은 명확한 처리 규칙 하나를 따르게 하세요. 런의 결과를 확정하고, 보상을 한 번만 수령하게 하고, 다음 런에도 유지될 선택지를 제시한 뒤, 그 결과가 반영된 진행 상태를 바탕으로 다음 런을 초기화합니다. 더 많은 재화나 허브 기능으로 이 방식을 확장하기 전에 재방문, 다시 불러오기, 구매, 이전 저장 데이터가 올바르게 처리되는지 확인하세요.
이 흐름을 바탕으로 별도의 플레이 가능한 콘셉트를 구상하려면 SEELE AI Game Maker를 사용해 보세요. 프로토타입 제작의 출발점으로 쓸 수 있으며, 기존 프로젝트를 편집하는 도구는 아닙니다.


