사건의 전개 로직을 유지하면서 탐정 게임의 퍼즐 해결 기록 저장하기

AI로 탐정 게임에 퍼즐 진행 상황 저장 기능을 추가하세요. 증거, 단서의 연결 관계, 사건의 결론, 저장 데이터의 무결성을 유지하는 방법을 소개합니다.

Seele Editorial Team수정일 2026년 11월 16일

탐정 게임은 플레이어가 확보한 증거를 기억해야 하지만, 세우다 만 가설까지 모두 저장할 필요는 없습니다. 해결한 퍼즐, 수집한 단서, 진행 중인 추론, 사건의 결론은 각각 다른 상태입니다. 이를 한 덩어리로 관리하면 증거가 중복되거나 오래된 가설이 스토리 전개의 기준이 되는 상태를 덮어쓸 수 있습니다.

가상의 탐정이 항구 사무실에서 수집한 증거를 살펴보고 있으며, 사건 보드 옆에는 해결한 황동 퍼즐이 놓여 있습니다.
랜턴 부두(Lantern Pier)는 설명을 위해 만든 가상의 미스터리입니다. 실제 사건이나 테스트 사례는 아닙니다.

이 가이드에서는 가상의 항구 미스터리를 다룹니다. 프로젝트나 수사 진행, 저장 데이터 마이그레이션을 실제로 테스트한 바는 없습니다. 목표는 이미 정상적으로 작동하는 증거 수집과 결론 도출 흐름을 유지하면서 퍼즐 진행 상황을 저장하는 것입니다.

증거, 퍼즐 해결 기록, 추론 시도, 사건의 결론을 구분하기

현재 게임이 추적하는 항목을 나열하세요. 증거에는 고정 ID와 출처가 있을 수 있고, 퍼즐에는 해결 여부를 나타내는 플래그가 있을 수 있습니다. 추론 보드에는 임시로 배치한 단서가 있을 수 있고, 사건에는 결론이나 챕터 상태가 저장될 수 있습니다. 방을 나가거나, 게임을 종료하거나, 챕터를 다시 시작하거나, 새 사건을 시작할 때 어떤 값을 유지할지 정하세요.

상태예시저장 여부를 판단할 질문
증거사진, 메모, 물리적 단서의 ID사건의 증거 목록에 남는가?
퍼즐 결과황동 자물쇠 퍼즐 해결돌아왔을 때 퍼즐을 건너뛰는가, 다시 보여 주는가?
추론 시도현재 단서 배치세우다 만 가설을 이어서 검토할 수 있어야 하는가?
결론분기 플래그 또는 사건 결과어느 서사 시스템이 이 상태를 관리하는가?

가상의 랜턴 부두 사건에서는 자물쇠 퍼즐을 풀면 고정된 퍼즐 ID를 기록하고 증거 보드에 단서 하나를 추가합니다. 탐정이 방을 나가면 가설을 세우기 위해 임시로 배치한 단서가 초기화됩니다. 최종 결론은 기존 사건 상태가 계속 결정합니다. 이 규칙은 설명용 예시이며 실제 탐정 게임의 구현을 보고한 내용은 아닙니다.

퍼즐 완료 처리를 기존 사건 시스템에 연결하기

플레이어가 퍼즐을 조작하는 순간부터 단서를 얻고 대화나 결론이 해금되기까지의 흐름을 따라가 보세요. 증거 ID, 챕터 플래그, 엔딩을 어느 시스템이 관리하는지 확인하세요. AI가 코드를 수정하기 전에 이 흐름을 정리하도록 요청하세요. 사건 상태는 한 시스템에서 관리하고, 증거 보드와 내용이 어긋날 수 있는 별도의 퍼즐 인벤토리는 만들지 마세요.

퍼즐을 풀면 고정된 퍼즐 ID와 의도한 결과를 담은 완료 이벤트를 한 번 발생시키세요. 사건 시스템은 해당 이벤트가 이미 기록됐는지 확인하고, 단서를 한 번만 추가한 뒤 그 단서를 필요로 하는 분기를 해금할 수 있습니다. 애니메이션이 다시 재생되거나 씬을 다시 불러와도 같은 증거가 또 지급되어서는 안 됩니다.

화면에 표시되는 문구 대신 ID를 사용하세요. 단서의 이름이 바뀌거나 번역되더라도 저장 키는 그대로 유지할 수 있습니다. 다음 버전에서 단서나 퍼즐이 삭제된다면 ID를 마이그레이션할지, 항목을 숨길지, 이미 완료한 사건을 위해 이전 기록을 보존할지 정하세요.

수집한 단서와 해결한 퍼즐 하나가 같은 사건 보드에 연결되며, 사건의 결론은 임시 가설을 세우는 과정과 별도로 관리됩니다.
하나의 사건 시스템이 퍼즐 완료 이벤트를 받고, 그에 따른 스토리 전개를 관리해야 합니다.

다시 플레이할 때 어떤 동작을 지원할지 정하기

플레이어는 애니메이션을 다시 보거나, 퍼즐을 다시 풀거나, 다른 분기를 탐색하거나, 챕터를 초기화하기 위해 이미 해결한 퍼즐을 다시 찾을 수 있습니다. 각각 별개의 동작입니다. 애니메이션만 다시 재생할 때는 증거 상태를 그대로 둘 수 있고, 새 분기로 진행할 때는 별도의 결론 기록을 생성할 수 있습니다. 실제 게임에서 어떤 동작을 지원할지 정의하세요.

챕터 재시작과 ‘새 게임’의 동작에 유의하세요. 챕터를 다시 시작할 때 해당 챕터의 퍼즐 진행 상황을 지우고 수사 일지는 유지한다면 그 규칙을 명시하세요. 새 사건을 시작할 때 사건 데이터를 모두 지우더라도 해당 사건과 무관하게 프로필에서 해금한 항목까지 삭제되지 않도록 하세요. 가능하면 기존 초기화 흐름을 재사용하고 퍼즐 전용 삭제 규칙의 추가는 피하세요.

온라인이나 여러 기기에서 진행 상황을 관리하려면 충돌 해결 방식을 따로 설계해야 합니다. 이 글은 프로젝트에서 현재 사용하는 로컬 사건 저장 모델을 전제로 합니다. 게임이 이미 기기 간 동기화를 지원하고 해당 동작을 테스트한 경우에만 동기화가 된다고 안내하세요.

저장 형식에 버전을 부여하고 이전 사건 기록 보존하기

프로젝트에서 지원하는 저장 경로와 직렬화 방식을 사용하세요. Godot 안정 버전 문서에서는 user://를 데이터를 지속적으로 보관할 수 있는 쓰기 가능한 경로로 설명하며, 파일 기반 저장 예제도 제공합니다. 대상 플랫폼과 현재 엔진 버전을 확인하세요. 저장 형식에는 스키마 버전 관리, 누락된 필드의 기본값, 형식이 잘못된 데이터의 복구 방식도 필요합니다.

이전 사건 저장 데이터의 복사본으로 마이그레이션을 테스트하세요. 불러오기 전후의 증거 ID, 해결한 퍼즐 ID, 수사 일지 항목, 결론 플래그를 비교하세요. 기존 플레이어의 스토리 진행 상태에 어떤 영향을 주는지 먼저 살핀 뒤 새 필드의 기본값을 ‘해결’ 또는 ‘미해결’로 정하세요.

개발 중에는 사건 ID, 퍼즐 ID, 이벤트 수신 여부, 증거 추가 여부, 결론 플래그 변경 여부, 저장 버전을 간단한 이벤트 로그에 남기세요. 이렇게 하면 상태 업데이트가 멈췄는지, 아니면 UI가 이전 보드를 표시하고 있는지 쉽게 파악할 수 있습니다.

단서에 증거의 출처 기록하기

퍼즐을 풀어 증거가 해금될 때, 사건 시스템에서 출처 관계를 사용한다면 그 관계도 기록하세요. 단서 ID를 해당 단서를 처음 얻은 방이나 대화, 물체에 연결할 수 있습니다. 그러면 수사 일지에서 탐정이 그 사실을 어떻게 알게 되었는지 설명할 수 있고, 여러 단서를 요구하는 분기의 문제도 더 쉽게 추적할 수 있습니다.

삽화나 생성된 증거 이미지로 실제 단서 기록을 대신하지 마세요. 저장 데이터에는 게임이 실제로 읽는 고정 ID와 사건에 반영된 결과를 담으세요. 플레이어가 증거를 버리거나 다시 확인할 수 있다면 기존 수사 일지의 동작을 따르고, 별도의 증거 목록을 새로 만들지 마세요.

AI에 범위가 좁고 되돌릴 수 있는 변경 요청하기

AI 어시스턴트에 작업 조건을 명확히 전달하세요. 증거 수집, 대화 순서, 챕터 초기화, 엔딩, 퍼즐 조작 방식을 유지하세요. 저장 대상으로 정한 해결한 퍼즐의 ID와 그 결과만 보존하고, 완료하지 않은 시도는 임시 상태로 두세요. 변경한 파일과 마이그레이션 동작, 변경을 되돌리는 절차를 정리하도록 하세요. 코드를 수정하기 전에 패치 계획부터 요청하세요.

코드 변경 내역을 검토하면서 증거를 중복 기록하는 부분, 화면 표시 문구를 ID로 사용하는 부분, 퍼즐과 스토리 관리자 양쪽에 결론을 저장하는 부분이 있는지 확인하세요. 상태를 알고 있는 사건 저장 파일 하나를 회귀 테스트용 데이터로 보관하세요. AI가 퍼즐을 통과시키기 위해 엔딩 로직을 변경했다면 해당 변경을 저장 기능 요청에서 분리해 별도로 검토하세요.

가상의 탐정이 같은 사건 보드로 돌아오자 수집한 단서는 그대로 남아 있고, 가설을 세우기 위해 임시로 배치한 단서는 초기화되어 있습니다.
다시 불러왔을 때의 동작을 보여 주는 예시입니다. 실제 빌드에서 어떤 상태가 유지되고 어떤 상태가 초기화되는지 확인하세요.

증거 수집, 재방문, 다시 플레이, 마이그레이션 검증하기

아래 항목은 테스트 제안이며 랜턴 부두에서 얻은 결과는 아닙니다.

테스트 상황수행할 동작확인할 내용
새 사건기존 데이터가 없는 프로필로 시작이전 단서나 결론이 나타나지 않음
퍼즐 해결단서를 얻는 퍼즐 하나를 해결증거가 한 번만 추가되고 분기 상태가 갱신됨
방 재방문방을 나갔다가 다시 들어감퍼즐의 해결 여부와 사건 보드가 정해진 규칙대로 표시됨
완료하지 않은 시도완료하기 전에 방을 나감정해진 규칙에 따라 시도가 초기화되거나 이어짐
다시 플레이해결한 퍼즐과 다시 상호작용증거가 중복되거나 의도하지 않은 결론이 생기지 않음
이전 사건이전 버전의 저장 데이터 복사본을 불러옴단서와 스토리 플래그가 일관되게 유지됨

빌드 버전, 사건 ID, 퍼즐 ID, 저장 버전, 수행 단계, 예상 결과, 실제 결과를 기록하세요. 화면에 표시되는 수사 일지와 실제 분기 동작을 모두 확인하세요. 모형으로 만든 증거 보드만으로는 저장된 단서가 올바른 엔딩을 해금한다는 사실을 입증할 수 없습니다.

자주 묻는 질문

탐정 게임에서 어떤 진행 상황을 저장해야 하나요?

수집한 증거 ID, 해결한 퍼즐 ID, 스토리 전개에 영향을 주는 사건 결과를 저장하세요. 진행 중인 추론, 선택한 보드 배치, 임시 힌트는 게임이 이미 이어서 진행하는 기능을 지원하는 경우를 제외하면 별도의 상태로 관리하세요. 프로젝트에서 현재 사용하는 사건 관련 용어와 기록 형식을 따르세요.

퍼즐을 풀면 사건 보드에 어떻게 반영해야 하나요?

기존에 사건 상태를 관리하는 시스템에 완료 이벤트를 한 번 전달하세요. 이 시스템은 퍼즐 ID를 기록하고, 의도한 단서나 결론을 해금하며, 반복해서 상호작용해도 같은 증거가 두 번 지급되지 않도록 할 수 있습니다. 보드와 사건 모델은 같은 상태 관리 시스템을 참조하도록 하세요.

플레이어가 탐정 게임의 퍼즐을 다시 플레이할 수 있어야 하나요?

다시 플레이하는 목적이 연출을 다시 보는 것인지, 퍼즐을 새로 시도하는 것인지, 사건의 다른 분기로 진행하는 것인지 정하세요. 애니메이션을 다시 재생하는 것만으로 증거가 중복되거나 이전 결론이 예고 없이 덮어써져서는 안 됩니다. 무엇이 초기화되는지 플레이어가 알 수 있도록 다시 플레이할 때의 동작을 문서에 명시하세요. 저장된 결과와 새 분기를 시도하는 상태는 별도로 관리하세요.

탐정 게임의 증거와 퍼즐 상태는 어디에 저장해야 하나요?

프로젝트에서 지원하는 영구 데이터 경로와 버전이 관리되는 저장 모델을 사용하세요. Godot 안정 버전 문서에서는 user://와 파일 기반 저장 방식을 설명합니다. 형식을 선택하기 전에 현재 엔진 버전과 대상 플랫폼을 확인하세요. 저장할 필드가 실제 프로젝트와 대상 플랫폼에 적합한지도 확인하세요.

추론 진행 상황 저장 기능을 추가한 뒤 무엇을 테스트해야 하나요?

새 사건 시작, 단서 수집, 퍼즐 해결, 증거 보드 재방문, 다시 불러오기, 다시 플레이하기, 이전 저장 데이터 불러오기를 테스트하세요. 실제 테스트에 사용한 사건과 빌드를 기록하세요. 가상의 단서 연결 관계는 테스트 결과가 될 수 없습니다. 실제로 관찰한 결과를 기록할 때 사건 ID와 저장 버전도 포함하세요.

사건 상태를 한곳에서 관리하기

이미 수사 진행을 관리하는 시스템을 통해 고정 ID로 식별하는 퍼즐 결과와 증거가 사건에 미친 결과를 저장하세요. 게임이 이어서 진행하는 기능을 명시적으로 지원하는 경우를 제외하면 완료하지 않은 시도는 임시 상태로 유지하세요. 단서 시스템을 확장하기 전에 실제 프로젝트에서 재방문, 다시 플레이, 이전 저장 데이터 불러오기가 어떻게 동작하는지 확인하세요.

브라우저에서 플레이할 수 있는 별도의 프로토타입을 구상 중이라면 SEELE AI Game Maker를 사용해 보세요. 이 링크는 별도의 프로토타입을 만들기 위한 것으로, 기존 탐정 게임의 사건 시스템을 수정하는 용도는 아닙니다.

출처

SEELE AI

이 가이드를 플레이할 수 있는 작품으로 만드세요.

구체적인 기획으로 시작해 Seele AI 워크스페이스에서 개선하세요.

만들기 시작