영구 진행도는 플레이어가 얻은 성과를 보존하되, 한 차례의 생존 플레이에서 일어나는 모든 일을 영구 상태로 남기지는 않아야 합니다. 기지 방어 게임에서는 이 구분이 중요합니다. 해금한 계곡이나 캠프 업그레이드는 월드에 남길 수 있지만, 지금 정문을 공격하는 적은 대개 오늘 밤의 플레이에만 속합니다.

AI 어시스턴트로 기존 프로젝트를 수정할 때는 이미 잘 작동하는 기능과 그대로 유지해야 할 동작부터 설명하세요. 그런 다음 영구적으로 남길 결과에만 저장 범위를 한정하세요. 이 글에서는 가상의 소나무 계곡 프로토타입으로 설계를 설명합니다. 실제 구현이나 플레이테스트를 보고하는 글은 아닙니다.
월드 진행도와 오늘 밤의 플레이 상태 구분하기
코드 작성을 요청하기 전에 재시작 후에도 남겨야 할 상태를 적어 두세요. 먼저 모든 변수를 영구 월드 진행도, 세션 설정, 일시적인 플레이 상태의 세 그룹으로 나눠 보세요. ‘진행도’라는 말 때문에 작업 범위가 플레이 도중의 상태 전체를 저장하는 기능으로 슬그머니 넓어지지 않도록 주의하세요.
| 상태 | 예시 | 기본 저장 방침 |
|---|---|---|
| 영구 월드 상태 | 해금한 지역, 연구를 마친 방어 수단, 영구 캠프 등급, 비축 자원 | 명확한 체크포인트를 지난 뒤 저장 |
| 플레이어 환경설정 | 음량, 조작 방식, 접근성 옵션 | 월드 진행도와 별도로 저장 |
| 현재 플레이 상태 | 적의 위치, 날아가는 투사체, 임시 보호막, 끝나지 않은 밤 | 플레이 도중부터 이어하기를 이미 지원하는 경우를 제외하고 초기화 |
가상의 예시에서는 밤을 무사히 넘기면 신호탑을 해금하고 보상을 비축할 수 있습니다. 새 플레이가 시작되면 진행 중이던 적의 공세, 임시 바리케이드의 남은 내구도, 각 몬스터의 위치는 초기화됩니다. 이렇게 하면 월드 보상을 남기면서 낮에는 채집하고 밤에는 방어하는 기존 루프를 유지하는 데 작업 범위를 한정할 수 있습니다.
게임에서 이미 쓰는 용어와 식별자를 사용하세요. 프로젝트에 지역 ID나 업그레이드 ID가 있다면 별도의 명명 체계를 만들지 말고 재사용하세요. 저장 파일에는 현지화 과정에서 달라질 수 있는 표시 이름이나 변경에 취약한 씬 노드 경로 대신, 같은 대상을 안정적으로 가리키는 식별 정보를 기록하세요.
수정하기 전에 기존 프로젝트 파악하기
프로젝트 사본을 만들어 변경 전 기준으로 삼으세요. 엔진과 버전, 현재 저장 동작, 메인 씬, 낮에서 밤으로 넘어가는 과정, 보상 계산 방식, 그리고 각 시스템을 담당하는 파일을 기록하세요. 가능하면 나중에 직접 비교할 수 있도록 짧은 화면 녹화나 스크린샷을 남겨 두세요. AI로 만든 삽화를 변경 전 상태의 증거처럼 제시하지 마세요.
AI 어시스턴트에게 먼저 프로젝트를 살펴보고 파일별 수정 계획을 제안해 달라고 요청하세요. 예를 들어 이렇게 범위를 정할 수 있습니다. ‘낮과 밤을 전환하는 시계, 채집, 적 생성, 조작, 전투는 그대로 유지해 주세요. 비축한 재료, 해금한 지역 ID, 영구 캠프 업그레이드 ID만 저장해 주세요. 현재 등장한 적이나 임시 효과는 저장하지 말고, 편집 전에 수정할 모든 파일을 나열해 주세요.’ 변경분을 작게 유지하고 되돌리는 방법도 간단히 적어 달라고 하세요.
계획을 받아들이기 전에 실제 프로젝트와 대조해 검토하세요. 현재 게임이 밤이 끝날 때 보상을 기록한다면, 자원을 주울 때마다 저장하지 말고 기존의 보상 처리 시점에 저장 호출을 추가하세요. 새로운 ‘밤 완료’ 이벤트를 도입한다면 씬을 전환하거나 재시작할 때 이벤트가 두 번 발생하지 않는지 확인하세요.
스키마 버전을 포함한 저장 경계 설계하기
직렬화 세부 사항은 load_world_progress()와 save_world_progress(snapshot) 같은 함수로 구성된 작은 인터페이스 뒤에 두세요. 게임플레이 시스템은 값을 요청하거나 처리 결과를 전달하고, 각 시스템이 공유 파일의 일부를 따로 쓰는 일은 피하세요. 이렇게 하면 전투 코드를 다시 작성하지 않고도 저장 코드를 더 쉽게 검토하고 테스트하거나 교체할 수 있습니다.
간단한 개념 모델은 아래와 같습니다. 설계를 보여 주는 예시이며, 테스트를 거친 저장 파일 형식은 아닙니다.
{
"schema_version": 1,
"world_id": "pine_valley",
"completed_nights": 3,
"banked_materials": {"wood": 42, "ore": 8},
"unlocked_regions": ["pine_valley", "old_quarry"],
"camp_upgrade_ids": ["signal_tower_t1"]
}
첫 릴리스부터 스키마 버전을 사용하세요. 형식이 바뀌면 마이그레이션 로직에서 이전 버전의 기록과 현재 버전의 기록을 구분할 수 있습니다. 지역과 업그레이드에는 안정적인 ID를 사용하세요. UI에 표시되는 이름이 바뀌어도 저장에 쓰는 ID는 그대로 둘 수 있습니다. 데이터를 읽을 때 값을 검증하세요. 알 수 없는 ID는 안전하게 거부하고, 게임 규칙에 유효 범위가 정의된 숫자만 그 범위 안으로 보정하세요. 기록을 복구할 수 없다면 초기 상태의 프로필로 시작하세요.
내보내기 대상 플랫폼에서 엔진이 지원하는 사용자 데이터 저장 방식을 선택하세요. Godot의 안정 버전 문서는 패키징된 프로젝트 리소스가 읽기 전용일 수 있고 사용자 경로에는 쓸 수 있으므로, 영구 데이터에 user://를 사용할 것을 권장합니다. Unity는 실행 간에 유지되는 데이터에 Application.persistentDataPath를 사용하도록 문서화하고 있으며, 실제 위치는 플랫폼에 따라 달라진다고 설명합니다. 어느 경로를 선택하든 클라우드 동기화, 백업, 암호화, 충돌 해결은 별도의 요구사항으로 다뤄야 합니다.

일관된 체크포인트에서 저장하기
보상과 월드 변경이 모두 확정된 시점을 체크포인트로 삼으세요. 예시에서는 밤을 마치고 승패를 확정한 뒤 비축 재료를 한 번 지급하고, 획득한 영구 업그레이드가 있다면 해금한 다음, 일관된 스냅샷 하나를 저장하고 다음 날의 채집을 시작할 수 있습니다. 정확한 순서는 기존 프로젝트에 따라 달라집니다. 현재 동작을 유지하면서 처리 순서를 명확히 정하세요.
파일을 쓰다가 중단되는 상황도 고려하세요. 안전을 우선하는 설계라면 데이터를 새 임시 파일에 쓰고 다시 읽을 수 있는지 확인한 뒤 기존 저장 파일을 교체합니다. 플랫폼에서 허용한다면 복구할 수 있는 사본 하나를 남겨 두세요. 모든 기기나 저장장치 장애에서 완벽한 안전을 보장한다고 약속하지 마세요. 저장 디렉터리가 없거나, 쓰기에 실패하거나, 파일 형식이 잘못된 경우의 동작을 정하세요. 알아보기 쉬운 메시지를 표시하고, 가능하면 이전 데이터를 보존하며, 아무런 안내 없이 보상이 두 번 지급되는 일을 막으세요.
가능하면 체크포인트가 멱등성을 갖도록 설계하세요. 저장 후 씬을 다시 불러왔을 때 같은 ‘밤 완료’ 이벤트가 처리되어도 보상이 다시 추가되면 안 됩니다. 한 가지 방법은 완료된 플레이의 식별자나 체크포인트 표식을 스냅샷에 함께 저장하고, 다음 상태가 확정된 뒤에만 지우는 것입니다. 기능 하나를 위해 새 이벤트 시스템을 추가하기보다는 기존 프로젝트 구조에 맞춰 구현하세요.
AI에 작고 되돌릴 수 있는 변경 요청하기
AI 어시스턴트에게 수정 가능한 파일, 저장해야 할 상태, 초기화해야 할 상태, 저장 시점, 유지해야 할 기존 시스템, 기대하는 검증 항목을 명확히 전달하세요. 편집 전에 어떤 가정을 했는지 설명해 달라고 하세요. 편집 후에는 변경분을 계획과 대조하고 직렬화 코드를 검토한 뒤, 정해 둔 저장 경계 밖에서 파일을 쓰는 곳이 있는지 찾아보세요.
변경 전 프로젝트 사본과 이전 버전의 저장 파일 예시를 보관하세요. 초기 검증 중에는 정상이라고 확인된 유일한 저장 파일을 새 빌드가 덮어쓰지 않도록 하세요. AI 어시스턴트가 저장 구현을 단순화하기 위해 게임 루프를 교체하거나, 자원 밸런스를 바꾸거나, 전투 코드를 다시 작성하자고 제안하면 요청 범위를 좁혀 더 작은 패치를 요청하세요.
신규 시작, 재접속, 복구 시나리오 검증하기
게임이 정상적으로 실행되는지는 여러 검증 항목 중 하나입니다. 간단한 테스트 표를 만들고 빌드, 플랫폼, 재현 절차, 예상 결과, 실제 결과, 그리고 신규 프로필인지 이전 버전에서 마이그레이션한 프로필인지 기록하세요. 아래 표는 테스트 계획의 양식이며, 이미 수행한 테스트의 결과는 아닙니다.
| 검증 사례 | 준비 방법 | 예상 결과 |
|---|---|---|
| 신규 프로필 | 테스트용 저장 파일을 삭제하거나 이름 변경 | 문서에 명시된 기본 캠프에서 시작하며 이전에 해금된 항목이 남아 있지 않음 |
| 밤 완료 | 영구 보상 하나를 획득하고 체크포인트에 도달 | 보상이 한 번만 비축되고 기존 루프가 이전과 동일하게 다음 단계로 넘어감 |
| 기존 프로필로 재접속 | 게임을 정상 종료한 뒤 다시 실행 | 영구 해금 항목이 복원되고 일시적인 적 공세와 버프는 초기화됨 |
| 이전 스키마 | 이전 버전에서 만든 저장 파일의 사본을 불러옴 | 마이그레이션이 기존 진행도를 보존하고 새 스키마 버전을 기록함 |
| 형식이 잘못되었거나 쓰기가 중단된 파일 | 형식이 잘못된 폐기용 사본을 사용하거나 테스트 파일 쓰기를 안전하게 중단 | 복구 동작을 이해할 수 있고 보상이 중복 지급되지 않음 |
원본 프로젝트와 변경한 빌드도 나란히 비교하세요. 기능 요구사항에 변경이 명시된 경우를 제외하고 채집 조작, 적의 등장 시점, 밤 단계 전환, 업그레이드 비용이 그대로인지 확인하세요. 쓰기 가능한 경로와 내보낸 빌드의 동작은 플랫폼마다 다르므로 각 대상 플랫폼에서 검증을 반복하세요. 테스트 기록을 패치와 함께 보관하고, 계획만 세운 테스트를 통과했다고 기록하지 마세요.

자주 묻는 질문
기지 방어 생존 게임에서는 게임을 다시 실행해도 어떤 상태가 남아야 하나요?
해금한 지역, 영구 캠프 업그레이드, 비축 자원처럼 월드에 남기기로 한 결과를 저장하세요. 게임에서 플레이 도중 저장하는 기능을 이미 지원하는 경우를 제외하고, 현재 적의 위치와 임시 효과, 끝나지 않은 밤의 진행 상태는 저장에서 제외하세요. 이렇게 하면 의도한 보상만 남고, 다음 플레이가 어떤 상태에서 시작되는지 설명하기 쉽습니다.
Godot 게임에서 플레이어 진행도는 어디에 저장해야 하나요?
Godot의 안정 버전 문서는 영구 플레이어 데이터에 user:// 경로를 권장합니다. 내보낸 게임을 실행할 때 프로젝트 리소스는 읽기 전용일 수 있지만 user://에는 쓸 수 있기 때문입니다. 저장 방식을 정하기 전에 최신 문서와 대상 플랫폼을 확인하세요. 저장 경로를 정하는 것만으로는 저장 형식이 결정되거나 검증되지 않습니다.
진행도 저장 기능을 추가할 때 기존 저장 파일이 깨지는 것을 어떻게 막을 수 있나요?
스키마 버전을 추가하고 해금 항목과 업그레이드에 안정적인 ID를 부여한 뒤, 마이그레이션 절차를 명확히 정하세요. 이전 저장 파일의 사본을 보존하고 새 빌드에서 불러와, 기존 진행도가 유지되는지 확인한 후에 원본을 덮어쓰세요. 플레이어의 유일한 저장 파일을 열기 전에 폐기해도 되는 사본으로 마이그레이션을 테스트하세요.
밤이 끝난 뒤 언제 저장해야 하나요?
밤의 결과가 확정되고 다음 날이 시작되기 전에 미리 정해 둔 체크포인트에서 저장하세요. 서로 관련 없는 여러 시스템이 보상의 일부를 각각 기록하는 방식은 피하세요. 일관된 진행도 스냅샷 하나를 저장하고 복구할 수 있는 이전 파일을 보관하세요. 기존 게임 흐름에서 정확히 한 번만 도달하는 지점을 선택하세요.
한 번 불러오는 데 성공하면 저장 시스템이 안전하다고 볼 수 있나요?
아니요. 신규 프로필, 밤 완료 후 저장한 파일, 파일이 없거나 형식이 잘못된 경우, 이전 스키마, 파일 쓰기가 중단된 경우도 테스트하세요. 대상 플랫폼에서 각 사례를 검증한 뒤 낮과 밤의 루프와 보상이 제대로 동작하는지 확인하세요. 결과를 각각 기록해 두세요. 계획만으로는 테스트 통과를 입증할 수 없습니다.
검증할 수 있도록 영구 저장 범위를 작게 유지하기
월드가 한 단계 발전했다는 느낌을 주는 최소한의 영구 상태부터 시작하세요. 버전이 명시된 스냅샷 하나, 명확한 체크포인트 하나, 마이그레이션 계획, 반복해서 확인할 수 있는 몇 가지 테스트 사례는 모든 전투 이벤트에 얽힌 저장 시스템보다 검토하기 쉽습니다. 실제 프로젝트에서 이 범위의 기능이 안정적으로 작동하면 필요한 부분부터 차근차근 확장하세요.
브라우저에서 플레이할 수 있는 별도의 게임 아이디어를 실험해 보고 싶다면 SEELE AI Game Maker를 사용해 보세요. 별도의 프로토타입을 만드는 방법이며, 기존 프로젝트를 편집하거나 복구하는 도구로 소개하는 것은 아닙니다.


