기존 메트로배니아에 능력 하나를 추가하는 것만으로도 여러 잠긴 문에 예상치 못한 문제가 생길 수 있습니다. 선택 경로, 체크포인트 복귀, 보스에게 가는 길은 물론, 이전 저장 파일을 불러왔을 때 기대되는 월드 상태도 달라질 수 있습니다. 먼저 진행 상태와 의존 관계를 정리하세요. 그런 다음 현재 상태를 관리하는 시스템에 저장이 필요한 변경 하나만 추가하고 주변 경로를 테스트하세요.

이 가이드는 기존 프로젝트를 확장하는 개발자를 위한 것입니다. 예시에 등장하는 Glassroot는 가상의 월드입니다. 아래의 맵과 저장 플래그, 테스트 케이스를 각자의 프로젝트 구조에 맞게 활용하세요.
‘진행 상태 유지’의 의미 정의하기
저장 필드를 작성하기 전에 방을 이동하거나 체크포인트를 다시 불러오거나 게임을 완전히 재시작한 뒤에도 플레이어가 확인할 수 있어야 하는 변화를 정하세요. 한 번 얻은 대시는 계속 쓸 수 있고, 그 능력으로 연 돌 관문은 열린 채로 남을 수 있습니다. 임시 스위치, 적의 경계 상태, 전투 버프는 방을 다시 불러올 때 초기화될 수 있습니다. 어떤 상태를 유지할지는 게임 설계에서 정하고, 직렬화 로직은 그 결정을 반영합니다.
| 상태 유형 | 예시 | 결정할 사항 |
|---|---|---|
| 능력 | 대시, 벽 붙잡기, 이단 점프 | 영구적으로 획득하는가, 일시적으로 부여되는가, 특정 모드에서 초기화되는가? |
| 월드 변화 | 일방통행 관문 개방 | 월드 전체에서 유지되는가, 지역 단위로 유지되는가, 해당 장소를 떠날 때까지만 유지되는가? |
| 방 상태 | 레버 작동, 적 처치 | 방에 돌아왔을 때 이 상태를 복원해야 하는가? |
| 일시 효과 | 피격 시 번쩍이는 효과, 일시 강화 | 이 상태를 저장 파일에 기록할 일이 있는가? |
가상의 Glassroot 예시에서 탐험가는 대시를 영구적으로 획득하고, 이름이 붙은 돌 관문을 연 뒤, 짧은 순환 경로를 따라 중앙 허브로 돌아올 수 있습니다. 근처의 적은 해당 장소를 떠나면 다시 생성됩니다. 이는 예시를 위해 정한 규칙으로, 실제 동작을 테스트한 결과는 아닙니다. 프로젝트마다 초기화 규칙이 다를 수 있으니 코드를 바꾸기 전에 문서에 적어 두세요.
능력과 관문, 이동 경로 연결하기
맵에서 쓸 곳이 있어야 능력에 의미가 생깁니다. 각 능력이 필요한 관문, 능력을 얻기 전과 후에 갈 수 있는 방, 허브나 체크포인트로 돌아오는 길을 정리하세요. 선택해서 갈 수 있는 갈림길과 아래로 내려간 뒤 되돌아올 수 없는 구간도 포함하세요. 의존 관계를 맵에 표시하면 새 플래그로 의도한 문은 열었지만 복귀 경로가 막혀 플레이어가 갇히는 흔한 설계 오류를 발견할 수 있습니다.

| 의존 관계 | 능력 획득 전 | 능력 획득 후 | 회귀 테스트에서 확인할 사항 |
|---|---|---|---|
| 금이 간 장애물 | 보이지만 통과할 수 없음 | 대시로 부수거나 통과할 수 있음 | 플레이어가 체크포인트로 돌아갈 수 있는가? |
| 높은 발판 | 필수 경로가 아님 | 능력으로 지름길이 열림 | 지름길을 이용하면 필수 튜토리얼을 건너뛰게 되는가? |
| 보스 봉인 | 보스에게 가는 길이 닫혀 있음 | 월드 플래그가 입장을 허용함 | 저장 파일을 불러왔을 때 봉인 상태와 보스 상태가 어긋날 수 있는가? |
표는 실제 맵을 기준으로 작성하세요. 정해진 진행 순서를 건너뛰어 도달할 수 있는 경로가 있다면, 이를 허용할지, 막을지, 아니면 테스트 항목으로만 남길지 결정하세요. 플레이어의 이동 경로와 게임에서 의도한 자유도를 파악하기 전에는 전역 잠금을 추가해 예상 밖의 경로를 ‘수정’하지 마세요.
진행 상태를 한 시스템에서 관리하기
기존 프로젝트에서 능력, 관문, 방 다시 불러오기, 체크포인트, 저장을 어떻게 처리하는지 살펴보세요. 인벤토리나 월드 플래그를 이미 관리하는 시스템을 찾으세요. 가능하면 별도의 진행 상태 관리자를 만들기보다 해당 시스템을 확장하세요. ‘대시 획득’ 상태를 두 곳에서 독립적으로 관리하면 값이 어긋날 수 있습니다. HUD에는 능력이 표시되는데 관문 로직은 여전히 이전 값을 읽는 식입니다.
계속 유지해야 하는 변경 사항에는 바뀔 수 있는 방의 표시 이름 대신 gate_moss_archive_open처럼 안정적인 식별자를 사용하세요. 새 필드를 추가하기 전에 이전 저장 파일에 적용할 기본값을 정하세요. 저장 파일에 관문 플래그가 없다면 관문을 닫힌 채로 둘지, 보스 플래그를 기준으로 상태를 정할지, 일회성 마이그레이션 규칙을 적용할지 결정하고 문서에 남기세요.
Godot의 안정 버전 문서는 user://를 쓰기 가능한 사용자 데이터 경로로 설명하고 파일 기반 저장 예제를 제공합니다. 저장 튜토리얼에서는 상태를 유지할 오브젝트를 식별하고 관련 데이터를 직렬화하는 방법도 보여 줍니다. 이 자료는 저장과 직렬화를 위한 참고 자료이며, 메트로배니아에 권장하는 저장 스키마를 제시하지는 않습니다. 엔진 버전을 확인하고, 가능한 범위에서 프로젝트의 기존 저장 구조를 유지하세요.
가능하면 씬 트리 전체보다 적은 데이터만 저장하세요. 안정적인 능력 ID와 월드 플래그만으로도 방의 시각적 상태를 복원할 수 있습니다. 모든 노드를 무작정 저장하면 나중에 씬을 리팩터링하기 어려워질 수 있습니다. 기존 게임에서 이미 오브젝트를 직렬화한다면 그 방식을 따르고, 상태를 올바르게 복원하는 데 필요한 값만 추가하세요.
AI에 변경 범위를 명확히 지정하기
AI는 프로젝트를 살펴보거나 패치 제안을 검토하는 데 도움을 줄 수 있습니다. 요청에는 그대로 유지해야 할 조건을 명시하세요. 예를 들면 다음과 같습니다.
수정에 앞서 기존 진행 상태와 저장 흐름을 살펴보세요. 플레이어 이동 방식, 방의 연결 구조, 보스 순서, 체크포인트 동작, 기존 능력 ID는 변경하지 마세요. 현재 상태를 관리하는 시스템을 통해 새 능력 하나와 그 능력에 의존하는 관문의 상태를 저장하는 최소 변경안을 제안하세요. 먼저 관련 파일과 마이그레이션에 적용할 가정을 나열하세요. 그런 다음 되돌릴 수 있는 패치 계획, 영향을 받는 경로, 새 저장 파일과 기존 저장 파일, 이전 버전 저장 파일의 테스트 항목을 보여 주세요. 이 프로젝트에서 실제로 실행하지 않은 테스트를 통과했다고 말하지 마세요.
코드 변경 내역을 검토하면서 상태를 관리하는 곳이 중복되지는 않았는지, 표시용 텍스트를 저장 키로 사용하지는 않았는지, 이전 저장 파일에 어떤 가정을 적용했는지, 방 이동 방식이 바뀌었는지 확인하세요. 파일별 변경 요약과 구체적인 롤백 방법을 요청하세요. 도구에서 콘셉트나 코드 제안만 생성했다면 실제 게임에 통합하거나 테스트했다는 근거가 되지 않습니다.
SEELE의 카탈로그는 글로 작성한 아이디어를 바탕으로 게임을 만들 수 있으며, RPG, 러너, 슈팅, 로그라이크 등 플레이 가능한 게임 장르를 지원한다고 설명합니다. 별도로 플레이 가능한 콘셉트를 탐색하거나 진행 방식에 관한 아이디어를 전달할 때 활용할 수 있습니다. 카탈로그만으로는 SEELE가 기존 저장소를 수정하거나 저장 파일을 마이그레이션할 수 있는지 확인할 수 없습니다. 그런 변경에는 프로젝트의 기존 작업 절차를 사용하세요.
이전 저장 파일을 보존하고 마이그레이션 규칙 정하기
마이그레이션은 반드시 저장 파일의 복사본으로 테스트하고, 유일한 원본은 사용하지 마세요. 해당 파일에 어떤 새 필드가 빠져 있고 게임이 어떤 기본값을 적용하는지 정리하세요. 이미 획득한 능력이 아무런 표시 없이 사라지지 않는지, 관문이 예기치 않게 초기화되지 않는지, 이전 완료 플래그가 여전히 의도한 의미를 갖는지 확인하세요. 진행 설계가 크게 바뀐다면 저장 스키마에 버전을 부여하고 마이그레이션 동작을 명시하세요.
마이그레이션 문서에는 이전 스키마 버전과 새 스키마 버전, 추가되거나 이름이 바뀐 필드, 대체값, 파싱 실패 시의 동작을 기록하세요. 복구 동작은 기존 게임 설계에 맞추세요. 저장 화면을 본뜬 카드는 이 규칙을 설명하는 데 쓸 수 있지만, 호환성은 대상 빌드에서 실제로 불러와야 확인할 수 있습니다.
한 구간을 처음부터 끝까지 검증한 뒤 확장하기
능력 하나, 그 능력에 의존하는 관문 하나, 복귀 경로 하나를 구현하세요. 같은 방식을 모든 지역에 적용하기 전에 전체 순환 경로를 테스트하세요. 빌드, 저장 버전, 방, 테스트 단계, 예상 상태, 실제 상태를 기록하세요. 검사에 실패하면 능력 획득, 직렬화, 불러올 때의 상태 복원, 방 진입, 시각적 피드백 중 어디에서 불일치가 생겼는지 확인하세요.
| 테스트 케이스 | 실행할 동작 | 확인할 결과 |
|---|---|---|
| 새 저장 파일 | 능력 없이 시작 | 관문이 닫혀 있고 의도한 초반 경로로 이동할 수 있음 |
| 능력 획득 | 능력을 얻고 해당 관문을 통과 | 능력과 월드 플래그가 한 번씩 갱신됨 |
| 되돌아가기 | 해당 장소를 떠났다가 순환 경로를 통해 복귀 | 관문, 체크포인트, 맵의 상태가 서로 일치함 |
| 다시 불러오기 | 저장하고 종료한 뒤 다시 불러오기 | 능력과 유지되어야 할 관문 상태가 복원됨 |
| 이전 저장 파일 | 변경 전 저장 파일의 복사본을 불러오기 | 기본값 적용이나 마이그레이션을 거친 뒤에도 진행할 수 있는 경로가 남아 있음 |
| 초기화 | 프로젝트에 정의된 재시작 동작 실행 | 유지되는 값과 일시적인 값이 문서에 명시된 규칙을 따름 |
아래의 가상 체크포인트 이미지는 획득한 능력이 유지되고 길이 열린 상태를 보여 줍니다. 실제로 실행 중인 게임에서 얻은 결과는 아닙니다.

자주 묻는 질문
메트로배니아의 진행 시스템에서는 어떤 상태를 유지해야 하나요?
방을 떠나거나 게임을 다시 시작한 뒤에도 설계상 필요한 상태만 저장하세요. 획득한 능력, 열린 일방통행 관문, 보스전 결과, 지속되는 월드 변화가 여기에 해당합니다. 일시적인 전투 효과와 저장하지 않는 방 내 상호작용은 별도로 관리하세요. 저장 필드는 기존 게임에서 상태를 관리하는 시스템과 초기화 규칙에 맞추세요.
기존 경로에 문제가 생기지 않도록 능력을 추가하려면 어떻게 해야 하나요?
해당 능력이 필요한 관문을 모두 맵에 표시하고, 능력을 얻기 전에도 의도한 경로를 최소 하나는 이용할 수 있는지 확인하세요. 복귀 경로와 체크포인트, 정해진 진행 순서를 건너뛰는 경로, 선택적으로 방문할 수 있는 방을 점검하세요. 맵을 검토 자료로 활용한 뒤 실제 빌드에서 각 경로를 검증하세요.
저장 파일을 불러온 뒤에도 한 번 연 관문은 열려 있어야 하나요?
관문 개방이 영구적인 월드 변화라면 안정적인 관문 ID나 월드 플래그를 저장하고, 불러올 때 그 상태를 바탕으로 방을 복원하세요. 임시 스위치에 해당한다면 방 상태로 관리하세요. 의도한 이동 경로를 기준으로 결정하고, 어떤 경우에 관문이 초기화되는지 플레이어에게 알려 주세요.
Godot는 유지해야 하는 게임 데이터를 어디에 저장하나요?
Godot의 안정 버전 문서는 user://를 쓰기 가능한 사용자 데이터 경로로 설명하고 파일 기반 저장 예제를 보여 줍니다. 대상 플랫폼과 현재 엔진 버전을 확인한 뒤, 가능하면 프로젝트의 기존 저장 계층을 사용하세요. 어떤 게임 상태를 유지할지는 문서에서 정해 주지 않습니다.
새 진행 시스템을 어떻게 안전하게 테스트할 수 있나요?
저장 파일의 복사본을 사용하고, 새 게임 시작, 능력 획득, 해당 능력이 필요한 관문, 되돌아가기, 체크포인트 다시 불러오기, 이전 저장 파일 불러오기를 테스트하세요. 빌드, 저장 버전, 방, 예상 결과를 기록하세요. 가상의 맵이나 모의 인터페이스는 테스트 계획을 설명할 수 있지만 실제 빌드가 테스트를 통과했다는 근거는 되지 않습니다.
순환 경로가 제대로 작동하는지 확인한 뒤 확장하기
계속 유지해야 하는 능력과 월드 변화마다 관련 관문, 복귀 경로, 초기화 규칙, 저장을 담당하는 시스템을 정리하세요. 한 구간을 구현한 뒤 능력 획득, 되돌아가기, 다시 불러오기, 이전 저장 파일의 동작을 검증하고 나서 맵 전체에 같은 방식을 적용하세요. 이렇게 하면 기존 게임의 진행 구조를 파악하기 쉬운 상태로 유지하면서 더 안전하게 확장할 수 있습니다.
이 순환 경로를 바탕으로 별도의 플레이 가능한 아이디어를 구상하고 싶다면 SEELE AI Game Maker를 사용해 보세요. 콘셉트를 만드는 데 활용할 수 있는 도구이며, 기존 프로젝트를 마이그레이션하는 도구는 아닙니다.


