物語の分岐を保ちながらパズルの進行状況を保存する

AIを使って、既存の分岐型ストーリーゲームにパズルの進行状況を保存する機能を追加します。選択肢、後まで残る選択の結果、エンディングを維持し、変更前後のビルドを比較します。

Seele Editorial Team更新日 2026年11月16日

物語を変えるパズルなら、プレイヤーが戻ってきたときにも、解いたことがゲームに反映されていてほしいものです。だからといって、キー入力を一つひとつ保存する必要はありません。分岐型ストーリーゲームでは、保存されるクリア状態、一時的な試行状態、物語に反映される結果は、それぞれ別の状態です。これらを区別しておくと、AIを使った変更を既存の会話やエンディングのロジックに組み込みやすくなります。

架空の灯台の書斎で、開いた手がかりの台帳が物語の二つのルートにつながり、入力途中の一時的な暗証コードは別に描かれている。
状態の区切りを説明するための、架空の灯台のコンセプトアートです。ゲームのスクリーンショットではありません。

以下に登場する灯台の台帳は、説明用に作った架空の例です。実在するプロジェクトやテスト、プレイヤー調査をもとにしたものではありません。この例を参考に変更の方針を立て、実装について何かを述べる前に、実際のプロジェクトで動作を確認してください。

クリア状態、試行状態、物語への影響を分ける

まず、ゲームが現在どの情報を管理しているかを洗い出します。パズルには、制作時に設定したID、クリア状態、報酬、ヒントの段階、入力途中の内容、一つ以上の物語フラグなどがあるかもしれません。シーンを切り替えても残る値、ゲームを再起動しても残る値、意図的に一時扱いにする値をそれぞれ明確にします。同じ画面に表示されるというだけで、パズルに関するデータをすべて一つのセーブ用オブジェクトにまとめるのは避けましょう。

状態例決めること
パズルの定義手がかりの順序、正解の判定ルール、関連する物語上の展開制作時に定義するコンテンツとして、プロジェクトと一緒にバージョン管理する
クリア状態クリア済みの台帳パズルを示す固定ID再訪後もクリア状態を引き継ぐなら保存する
試行状態入力途中のコード、現在の選択、表示中のヒントリセットするか、途中から再開するかを明示的に決める
物語への影響会話フラグ、解放されたルート、エンディングの前提条件既存の物語状態の管理元を使う

この例では、台帳のパズルを初めて解くと、パズルIDが記録され、手がかりの発見を示す既存の物語フラグが立ちます。キャラクターが書斎を離れても、手がかりを見つけた記録は残ります。キーパッドに入力しかけた暗証コードは、退出時にリセットされます。パズルを開き直せば演出は再生できますが、同じ手がかりを再び獲得することはありません。この取り決め一つで、報酬の二重付与や分岐条件の不整合を防げます。

AIに編集を頼む前に物語の流れを追う

既存のパズルを一つ選び、操作の開始を検知する箇所から、次の会話や分岐に至るまでの流れを追います。クリアを判定するスクリプトやデータレコード、物語フラグの保存先、シーンが再読み込みされる仕組み、エンディングがフラグを読み取る方法を確認します。変更を加える前に、プロジェクトとサンプルのセーブデータをコピーしておきます。

AIには、その流れを整理し、最小限のパッチを提案するよう頼みます。会話の順序、選択肢が表示される条件、現在のエンディング、パズルの操作方法、ヒントの挙動など、維持すべき仕組みを具体的に挙げます。既存の物語フラグやイベントの仕組みを再利用し、変更予定のファイルも示すよう求めます。別の「パズル進行管理」の仕組みを追加する提案は、プロジェクトにある物語状態との整合性をどう保つのか理解してから判断しましょう。

識別子には、表示テキストとは独立した固定IDを使います。たとえば、後で編集や翻訳によってパズルのタイトルが変わっても、「ledger_solution」はそのままセーブキーとして使えます。固定IDがあれば、物語システムは翻訳済みのタイトルを検索せずにクリア状態を参照できます。

一つのクリアイベントでパズルを物語につなぐ

パズルの操作処理と物語の更新は、一つの明確な接点でつなぎます。正解したとき、パズルは固定IDと反映すべき結果をイベントとして通知できます。物語状態の管理元は、そのIDがすでにクリア済みかを確認し、手がかりや報酬を一度だけ付与して、既存の分岐フラグを更新します。キーパッド、会話画面、日誌、エンディングが同じ事実をそれぞれ別に書き込む構成よりも、処理を確認しやすくなります。

データレコードの概念例は、次のようになります。

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

このスキーマは動作検証を行ったものではありません。プロジェクトですでに制作時のデータと実行時の状態を分けている場合は、コンテンツの定義とプレイヤーの進行状況も分けて管理します。存在しないパズルIDや廃止されたパズルIDの扱いを明示的に決め、名前の変更によって、そのパズルに依存する物語の選択が気づかないうちにすべて失われることを防ぎましょう。

灯台のパズルを解いた結果が、既存の物語の二つの分岐に伝わり、一時的な試行状態は消えていく。
イベントの流れを示す概念図です。パズルをクリアすると、ゲームがすでに管理している物語状態が更新されます。

保存方法は、エンジンがサポートするデータパスと、プロジェクトの既存の設計に合わせて選びます。Godotの安定版ドキュメントは、永続的なユーザーデータの保存先として user:// を推奨し、データ型やエンコーディングの制約と利点に触れながら、JSONを使ったシンプルな保存方法を示しています。Unityのドキュメントでは、実行をまたいで保持するデータの保存先として Application.persistentDataPath を説明しており、その場所はプラットフォームによって異なります。どちらのドキュメントも分岐する物語のモデル化までは規定しておらず、その設計はプロジェクトごとに決めます。

再プレイとリセットの挙動をわかりやすく定める

「パズルを再プレイする」には、いくつかの意味があります。プレイヤーが部屋を再訪する、手がかりの演出を見る、パズルをもう一度解く、物語フラグをリセットする、報酬を再び獲得する、といった行動が考えられます。どの挙動を意図しているのか決めておきましょう。物語に関わるパズルでは、ゲームが別の結果を明示的に許容している場合を除き、再プレイしても一度限りの結果は繰り返さないのが無難です。

リセットの範囲も決めます。章を最初からやり直す場合、その章に限られる手がかりはリセットし、日誌に永続的に残る項目は保持することもできます。物語を完全に最初から始める場合は、すべての進行状況を消去することもあります。すでに New Game Plus や章選択があるなら、パズル専用の例外を加えず、既存のリセットルールに従います。

選択の結果が後の分岐を変える場合は、クリア状態だけでなく、その分岐もテストします。日誌では「発見済み」と表示されていても、エンディングが古いフラグを読み取っていることがあります。物語状態の参照元とクリアイベントをそれぞれ一つにしておくと、こうした問題の原因を調べやすくなります。

AIには範囲を絞り、元に戻せる変更を頼む

たとえば、次のように範囲を指定できます。「既存の会話とエンディングの仕組みを維持してください。保存を追加するのはクリア済みパズルIDと、すでに定義されている物語上の結果だけにしてください。入力途中の内容はシーンを閉じたときにリセットし、同じ手がかりは二度付与しないでください。変更したファイルを列挙し、古いセーブデータをどう読み込むか説明してください。」パッチを受け入れる前に、差分とテストケースを提示してもらいます。

コードをレビューし、物語状態の管理元を経由しない書き込みがないか確認します。保存に失敗したときに永続的なクリアとして誤表示されないこと、シーンに入り直しても報酬が二重に付与されないこと、新しいフィールドがない古いセーブデータに意図したデフォルト値が設定されることを確認します。変更を戻せるようにコピーを残し、複製したセーブデータで移行をテストします。

再訪、再プレイ、分岐のケースを検証する

検証項目には、物語のさまざまな時点での動作を含めます。以下は実際のプロジェクトで確認するための項目案であり、架空の例から得られたテスト結果ではありません。

ケース操作確認する期待結果
新規プロフィール既存のセーブデータがない状態で開始する過去のクリア済みパズルIDや分岐フラグが残っていない
クリア後に退出パズルを一つ解き、シーンから退出して戻るクリア状態と対応する手がかりの記録が整合したまま残る
入力途中で退出コードを一部だけ入力して退出する定めた仕様どおりに、試行状態がリセットされるか途中から再開される
再プレイクリア済みのパズルをもう一度開く演出が動作し、一度限りの報酬が重複しない
物語の分岐パズルの結果に依存する会話やエンディングまで進む分岐が同じ管理元から物語上の結果を読み取る
古いセーブデータ新しいフィールドが追加される前のセーブデータを複製し、使い捨てのコピーを読み込む移行によって記録済みの選択が維持され、安全なデフォルト値が設定される

ビルドのバージョン、プラットフォーム、検証用のセーブデータ、手順、期待した結果と実際の結果を記録します。失敗するケースがあれば、機能を拡張する前に、その状態遷移を修正します。コンセプトイラストや模擬インターフェースを、セーブデータの移行に成功した証拠として扱わないでください。

キャラクターが戻ってきても架空の灯台で見つけた手がかりの記録が残り、パズルの仕掛けは再び操作できる一方で、報酬は二度表示されない。
説明用のシーンです。再訪時と再プレイ時の挙動は、対象のプロジェクトで検証する必要があります。

よくある質問

分岐型ストーリーゲームでは、パズルのどの情報を保存すべきですか?

通常は、クリア済みのパズルIDと、既存の物語システムが参照する結果を保存します。未クリアのパズルを途中から再開する機能がすでにある場合を除き、現在の入力順序、入力途中のコード、一時的なヒントは別に扱います。

パズルを物語の分岐にどうつなげればよいですか?

固定のパズルIDを使い、一つの明確なクリアイベントを通じて、プロジェクトに既存の物語フラグや結果を更新します。会話、クエストの状態、エンディングと食い違う可能性のある別系統の分岐システムを作るのは避けましょう。

クリア済みのパズルは再プレイできるようにすべきですか?

演出の再表示、操作のやり直し、物語状態の変更をどこまで許すか、個別に決めます。報酬を二度付与せずに、パズルを再表示することはできます。クリア時の処理を変える前に、意図する挙動を文書にまとめておきましょう。

Godotでパズルの進行状況を永続化するにはどうすればよいですか?

Godotの安定版ドキュメントは、永続的なユーザーデータの保存先として user:// を推奨しています。保存のチュートリアルには、単純な状態をJSONで保存する例もあります。対象プラットフォームと必要なデータを確認してください。JSONのデータ型やエンコーディングの制約は引き続き適用されます。

パズルの進行状況を保存する機能を追加した後は、何をテストすべきですか?

新規プロフィール、パズル一つのクリア、拠点への帰還、再読み込み、結果に依存する分岐、再プレイ時の挙動、古いセーブデータをテストします。ビルドと手順を記録してください。物語の進行例だけでは、実際にテストした証拠にはなりません。

物語状態の参照元を一つに保つ

最初の変更は小さく抑えるのが一般に最も安全です。クリア済みの固定IDを保存し、クリアイベントを既存の物語システムに渡し、再プレイとリセットで何が起こるかを明確にします。実際のプロジェクトで再訪、分岐、移行、報酬の確認を終えたら、物語に必要な範囲でのみ、保存する状態を拡張します。

別のアイデアをブラウザーで遊べるプロトタイプにするなら、SEELE AI Game Makerを試してみてください。これは別途プロトタイプを作るための選択肢であり、既存プロジェクトを修正できると主張するものではありません。

参考資料

SEELE AI

このガイドをプレイできる作品に。

作りたいものを明確にし、Seele AI ワークスペースで改善を重ねましょう。

制作を始める