스토리 분기를 살리면서 퍼즐 진행 상황 저장하기

AI를 활용해 기존 분기형 스토리 게임에 퍼즐 진행 상황을 저장하는 기능을 추가하세요. 선택지와 선택의 지속적인 결과, 엔딩을 유지하면서 변경 전후 빌드를 비교하세요.

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

스토리를 바꾸는 퍼즐이라면 플레이어가 돌아왔을 때도 게임이 그 풀이를 기억한다는 느낌을 줘야 합니다. 그렇다고 모든 키 입력을 저장할 필요는 없습니다. 분기형 스토리 게임에서 저장되는 퍼즐 완료 상태, 일시적인 풀이 시도 상태, 스토리에 반영되는 결과는 서로 다른 상태입니다. 이를 구분하면 AI로 수정할 때 기존 대화와 엔딩 로직에 자연스럽게 통합할 수 있습니다.

가상의 등대 서재에서 펼쳐진 단서 장부가 두 갈래의 스토리로 이어지고, 입력 도중인 임시 코드는 따로 표시됩니다.
상태 간 경계를 설명하기 위해 만든 가상의 등대 콘셉트 아트입니다. 실제 게임 화면은 아닙니다.

아래의 등대 장부는 설명을 위해 만든 가상의 예시입니다. 실제 프로젝트나 테스트, 플레이어 연구를 다룬 사례가 아닙니다. 이 예시를 참고해 변경 범위를 설계하고, 구현에 대해 단정하기 전에 실제 프로젝트에서 동작을 확인하세요.

퍼즐 완료 상태, 풀이 시도 상태, 스토리 결과 구분하기

먼저 게임이 현재 추적하는 항목을 나열하세요. 퍼즐에는 제작 시 지정한 ID, 완료 여부, 보상, 힌트 단계, 입력 중인 값, 하나 이상의 스토리 플래그가 있을 수 있습니다. 어떤 값이 장면이 바뀌어도 유지되는지, 어떤 값이 재시작 후에도 남는지, 어떤 값이 의도적으로 일시적인지 표시하세요. 한 화면에 표시된다는 이유만으로 퍼즐 관련 데이터를 모두 하나의 저장 객체로 묶지 마세요.

상태예시결정할 사항
퍼즐 정의단서 순서, 정답 판정 규칙, 연결된 스토리 전개 지점제작 단계에서 정의하고 프로젝트와 함께 버전 관리
완료해결한 장부 퍼즐의 고정 ID다시 돌아왔을 때도 완료 상태를 유지해야 한다면 저장
풀이 시도일부만 입력한 코드, 현재 선택 항목, 활성 힌트초기화할지 이어서 진행할지 명시적으로 결정
스토리 결과대화 플래그, 열린 경로, 엔딩의 선행 조건스토리 상태를 관리하는 기존 시스템 사용

예시에서는 장부 퍼즐을 처음 풀면 퍼즐 ID를 기록하고, 단서를 발견했다는 기존 스토리 플래그를 설정합니다. 캐릭터가 서재를 떠나도 단서를 찾았다는 기록은 남습니다. 키패드에 일부만 입력한 코드는 퇴장 시 초기화됩니다. 퍼즐을 다시 열면 연출을 재생할 수 있지만, 단서가 다시 지급되지는 않습니다. 이 규칙 하나로 보상 중복과 분기 조건의 불일치를 막을 수 있습니다.

AI에 수정을 요청하기 전에 스토리 흐름 추적하기

기존 퍼즐 하나를 골라 상호작용이 시작되는 지점부터 다음 대화나 분기로 이어지는 흐름을 따라가세요. 완료 여부를 결정하는 스크립트나 데이터 레코드, 스토리 플래그의 저장 위치, 장면을 다시 불러오는 방식, 엔딩이 해당 플래그를 읽는 방식을 파악하세요. 변경에 앞서 프로젝트와 샘플 저장 데이터의 복사본을 만들어 두세요.

AI에 이 흐름을 정리하고 수정 범위가 가장 작은 패치를 제안해 달라고 하세요. 대화 순서, 선택지 표시 조건, 현재 엔딩, 퍼즐 조작 방식, 힌트 동작은 그대로 유지해야 한다고 명시하세요. 기존 스토리 플래그나 이벤트 처리 방식을 재사용하고, 수정할 파일 목록을 알려 달라고 요청하세요. 별도의 ‘퍼즐 진행 상황’ 시스템을 제안받았다면 프로젝트의 기존 스토리 상태와 일관성을 어떻게 유지하는지 파악한 뒤에 채택하세요.

화면에 표시되는 텍스트 대신 고정 식별자를 사용하세요. 나중에 편집하거나 번역하면서 퍼즐 제목이 바뀌어도 ‘ledger_solution’은 저장 키로 계속 사용할 수 있습니다. 고정 ID가 있으면 스토리 시스템이 번역된 제목을 검색할 필요 없이 퍼즐의 완료 상태를 참조할 수 있습니다.

하나의 완료 이벤트로 퍼즐과 스토리 연결하기

퍼즐 상호작용에서 스토리 상태를 갱신하는 경로를 하나로 정하세요. 정답이 입력되면 퍼즐은 고정 ID와 의도한 스토리 결과를 담은 이벤트를 보낼 수 있습니다. 스토리 상태를 관리하는 시스템은 해당 ID가 이미 완료 처리됐는지 확인하고, 단서나 보상을 한 번만 지급한 뒤 기존 분기 플래그를 갱신합니다. 키패드, 대화 화면, 일지, 엔딩이 각각 같은 사실을 따로 기록하는 방식보다 점검하기 쉽습니다.

데이터 레코드의 개념 예시는 다음과 같습니다.

{
  "schema_version": 1,
  "solved_puzzle_ids": ["lighthouse_ledger"],
  "story_flags": {
    "keeper_clue_found": true,
    "north_stairs_open": false
  }
}

이 스키마는 테스트를 거치지 않았습니다. 프로젝트에서 이미 제작 단계의 데이터와 실행 중 상태를 구분한다면, 콘텐츠 정의와 플레이어 진행 상황도 따로 관리하세요. 누락됐거나 더 이상 사용하지 않는 퍼즐 ID의 처리 방식을 명시하세요. 퍼즐 이름을 바꿨다는 이유로 그 퍼즐에 의존하는 스토리 선택지가 아무런 표시 없이 모두 사라지는 일이 없어야 합니다.

등대 퍼즐을 풀어 생긴 하나의 결과가 기존 스토리 분기 두 곳으로 전달되고, 일시적인 풀이 시도 상태는 사라집니다.
퍼즐 완료 이벤트가 게임에서 이미 관리하고 있는 스토리 상태를 어떻게 갱신하는지 보여 주는 개념도입니다.

엔진이 지원하는 데이터 경로와 프로젝트의 기존 구조에 맞춰 저장 방식을 선택하세요. Godot 안정 버전 문서는 영구 사용자 데이터에 user://를 권장하고 간단한 JSON 저장 예제를 제공하며, 데이터 타입과 인코딩에 따른 제약도 설명합니다. Unity는 실행 간에 유지되는 데이터에 사용할 Application.persistentDataPath를 문서화하고 있으며, 실제 위치는 플랫폼마다 다릅니다. 두 문서 모두 분기형 스토리를 어떻게 모델링해야 하는지 규정하지 않습니다. 프로젝트에서 결정할 사항입니다.

다시 플레이할 때와 초기화할 때의 동작을 쉽게 설명하기

‘퍼즐을 다시 플레이한다’는 말은 여러 뜻으로 해석될 수 있습니다. 플레이어가 방을 다시 방문하거나, 단서 애니메이션을 보거나, 퍼즐을 다시 풀거나, 스토리 플래그를 초기화하거나, 보상을 다시 받는다는 뜻일 수 있습니다. 어떤 동작을 의도하는지 정하세요. 스토리 퍼즐에서는 게임이 다른 결과를 명시적으로 지원하는 경우를 제외하고, 퍼즐을 다시 플레이해도 일회성 결과가 반복되지 않도록 하는 것이 안전한 기본값입니다.

초기화 범위도 정하세요. 챕터를 다시 시작할 때는 해당 챕터에만 적용되는 단서를 초기화하되 영구 일지 항목은 유지할 수 있습니다. 스토리를 처음부터 새로 시작하면 진행 상황을 모두 지울 수도 있습니다. 게임에 이미 뉴 게임 플러스나 챕터 선택 기능이 있다면 퍼즐에만 적용되는 예외를 추가하는 대신 기존 초기화 규칙을 따르세요.

선택의 결과가 이후 스토리 분기에 영향을 준다면 퍼즐 완료 상태와 함께 해당 분기도 테스트하세요. 일지에는 단서를 ‘발견함’으로 표시되는데 엔딩은 여전히 이전 플래그 값을 읽을 수 있습니다. 기준이 되는 스토리 상태와 완료 이벤트를 각각 하나로 유지하면 이런 문제를 진단하기 쉽습니다.

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

변경 범위를 정한 요청은 이렇게 작성할 수 있습니다. 기존 대화 및 엔딩 시스템을 유지하세요. 해결한 퍼즐의 ID와 이미 정의된 스토리 결과만 저장하세요. 입력 중인 값은 장면이 닫힐 때 기존처럼 초기화하세요. 단서를 두 번 지급하지 마세요. 변경한 파일을 나열하고 이전 버전의 저장 데이터를 어떻게 불러올지 설명하세요. 패치를 수락하기 전에 변경 내역(diff)과 테스트 케이스를 요청하세요.

코드를 검토해 스토리 상태를 관리하는 시스템을 거치지 않고 값을 쓰는 부분이 있는지 확인하세요. 저장에 실패했는데도 완료 상태가 영구 저장된 것처럼 표시되지는 않는지, 장면에 다시 들어갔을 때 보상이 두 번 지급되지는 않는지, 새 필드가 없는 이전 저장 데이터에 의도한 기본값이 적용되는지 확인하세요. 변경을 되돌릴 수 있도록 복사본을 보관하고, 저장 데이터의 복사본으로 마이그레이션을 테스트하세요.

재방문, 다시 플레이, 스토리 분기 검증하기

스토리의 여러 진행 지점을 검증 항목에 포함하세요. 아래 표는 실제 프로젝트에서 확인할 항목을 제안한 것으로, 가상의 예시에서 얻은 테스트 결과가 아닙니다.

검증 항목동작확인할 예상 결과
새 프로필기존 저장 데이터 없이 시작이전에 완료한 퍼즐 ID나 분기 플래그가 남아 있지 않음
퍼즐 완료 후 퇴장퍼즐 하나를 풀고 장면을 나갔다가 돌아옴완료 상태와 해당 단서가 일관되게 유지됨
미완료 시도코드의 일부만 입력하고 퇴장명시한 설계에 따라 시도 상태를 초기화하거나 이어서 진행함
다시 플레이해결한 퍼즐을 다시 엶연출이 정상적으로 표시되고 일회성 보상이 중복 지급되지 않음
스토리 분기퍼즐 결과에 의존하는 대화나 엔딩까지 진행분기가 동일한 기준 상태에서 퍼즐 결과를 읽음
이전 저장 데이터새 필드가 추가되기 전의 저장 데이터 복사본을 불러옴마이그레이션이 기존 선택 기록을 유지하고 안전한 기본값을 설정함

빌드 버전, 플랫폼, 테스트용 저장 데이터, 재현 단계, 예상 결과와 실제 결과를 기록하세요. 검증에 실패한 항목이 있으면 기능을 확장하기 전에 해당 상태 전환을 수정하세요. 콘셉트 일러스트나 모의 인터페이스를 저장 데이터 마이그레이션에 성공했다는 증거로 사용하지 마세요.

캐릭터가 돌아온 뒤에도 가상의 등대 단서는 기록에 남아 있고, 퍼즐 장치를 다시 이용할 수 있지만 보상이 두 번 표시되지는 않습니다.
설명을 위한 장면입니다. 재방문과 다시 플레이 시의 동작은 대상 프로젝트에서 확인해야 합니다.

자주 묻는 질문

분기형 스토리 게임에서 어떤 퍼즐 정보를 저장해야 하나요?

일반적으로 해결한 퍼즐의 ID와 기존 스토리 시스템에서 참조하는 스토리 결과를 저장합니다. 게임이 미완료 퍼즐을 이어서 푸는 기능을 이미 지원하는 경우가 아니라면, 현재 입력 순서, 일부만 입력한 코드, 임시 힌트는 별도로 처리하세요.

퍼즐을 스토리 분기에 어떻게 연결해야 하나요?

고정 퍼즐 ID를 사용하고, 하나의 명확한 완료 이벤트를 통해 프로젝트의 기존 스토리 플래그나 결과를 갱신하세요. 대화, 퀘스트 상태, 엔딩과 불일치할 수 있는 별도의 분기 시스템을 만들지 마세요.

이미 해결한 퍼즐을 다시 플레이할 수 있게 해야 하나요?

연출만 다시 보여 줄지, 퍼즐을 다시 풀 수 있게 할지, 스토리 상태까지 바꿀 수 있게 할지 각각 정하세요. 보상을 중복 지급하지 않고도 퍼즐을 다시 보여 줄 수 있습니다. 완료 처리 흐름을 변경하기 전에 의도한 동작을 문서화하세요.

Godot에서 퍼즐 진행 상황을 어떻게 저장하나요?

Godot 안정 버전 문서는 영구 사용자 데이터에 user://를 권장하며, 간단한 상태를 JSON으로 저장하는 튜토리얼을 제공합니다. 현재 대상 플랫폼과 저장할 데이터의 요구 사항을 확인하세요. JSON의 데이터 타입과 인코딩 제약은 그대로 적용됩니다.

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

새 프로필, 퍼즐 하나를 완료한 상태, 허브로 돌아가는 동작, 다시 불러오기, 퍼즐 결과에 의존하는 분기, 다시 플레이할 때의 동작, 이전 버전의 저장 데이터를 테스트하세요. 빌드와 테스트 단계를 기록하세요. 예시용 스토리 흐름은 실제 테스트를 수행했다는 증거가 아닙니다.

스토리 상태의 단일 기준 유지하기

보통은 작은 변경부터 시작하는 것이 가장 안전합니다. 해결한 퍼즐의 고정 ID를 저장하고, 완료 이벤트는 기존 스토리 시스템을 거치게 하며, 다시 플레이와 초기화가 각각 어떤 동작을 뜻하는지 명확히 정하세요. 실제 프로젝트에서 재방문, 분기, 마이그레이션, 보상 검증을 통과한 뒤 스토리에 필요한 범위에서만 저장 모델을 확장하세요.

별도로 브라우저에서 플레이할 수 있는 프로토타입 아이디어를 시험해 보고 싶다면 SEELE AI Game Maker를 사용해 보세요. 이는 별도의 프로토타입을 만드는 방법이며, 기존 프로젝트를 수정할 수 있다는 주장은 아닙니다.

출처

SEELE AI

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

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

만들기 시작