カードの解放状態を引き継ぐには、セーブデータのフィールドを変更するだけで済みそうに見えます。しかし、物語ゲームでは、プレイヤーが情報を知る順序も守る必要があります。章が解放されていても、物語の中で内容が明かされるまでは、その章のカードを非表示にしておく場合があります。カードを入手しても、使用中のデッキに入っているとは限りません。セーブ処理を拡張する前に、これらの状態を個別にモデル化し、そのうえで章の切り替えと旧バージョンのセーブデータをテストします。

このガイドは、既存のカード型物語ゲームのプロジェクトを対象としています。以下に登場する資料管理人、カード、章の分岐、公開ルールは、説明のための架空の例です。実際のプロジェクトのコンテンツモデルとネタバレ防止方針に合わせて調整してください。
アクセス・発見・選択の状態を分ける
まず、カードに関わる状態を洗い出し、それぞれがいつまで有効かを整理します。「解放済み」は、章に入れることを指す場合があります。「入手済み」は、プレイヤーが証拠カードを見つけた状態を指すことがあります。「公開済み」は、カードの表面やテキストが物語の中でプレイヤーに提示された状態です。「選択済み」は、一時的な閲覧用デッキや会話の選択肢に関わる状態を指す場合があります。この4つの状態を1つの真偽値で判定すると、画面表示と物語の進行ロジックにずれが生じることがあります。
| 状態 | 意味 | リセット時の主な確認事項 |
|---|---|---|
| アクセス | プレイヤーが章や分岐に入れる | セッションを開始し直したり章を再プレイしたりしても、アクセスできるか? |
| 発見 | 特定のカードや手がかりを見つけた | 章をリセットすると発見の記録が消えることはあるか? |
| 公開 | カードの内容が物語の中で明かされた | カードのイラストやテキストをいつからメニューに表示できるか? |
| 選択 | カードが使用中のデッキに入っているか、現在の選択肢として選ばれている | シーンや1回のプレイが終わると選択状態は解除されるか? |
架空のメリディアン資料館では、真鍮の鍵のカードを見つけるとコレクションに追加され、その鍵にまつわる経緯は後のシーンで明かされます。章へのアクセスは別の分岐フラグで制御します。一時的な閲覧用デッキは、プレイヤーが別の章を始めるとリセットされます。これらは設計例であり、実際のゲームで確認した挙動ではありません。
解放による先の展開のネタバレを防ぐ
章一覧、コレクション画面、手札やデッキ、会話の選択肢、再プレイメニューのそれぞれで、プレイヤーに何を見せるかを決めます。アクセスできる状態を保存しても、すべての画面にカード名や画像、説明を表示する必要はありません。未解放や未発見を示すプレースホルダーを使えば、物語の詳細を伏せたままコレクションの構成を示せます。

コンテンツIDと併せて公開ルールを記録します。分岐ごとに、前提となるイベント、アクセスを解放するフラグ、カードを初めて公開してよいシーンを記録します。そのうえで、公開の直前と直後にセーブデータを読み込み直してテストします。UIだけを修正すると、あるメニューでネタバレを隠せても、会話の選択を促す表示や生成されたサムネイルに情報が出てしまうことがあります。
| プレイヤーが見る箇所 | ネタバレ防止の確認事項 | 確認方法 |
|---|---|---|
| 章一覧 | 物語のテキストを表示せずに、アクセスできることを示せるか? | 未解放・解放済み・再プレイ時の表示を確認する |
| コレクション | 未発見のカードからネタバレが起きないか? | カード名、イラスト、プレビュー、ツールチップを確認する |
| 使用中のデッキ | 有効な選択だけが表示されるか? | カードの公開状態が切り替わる各タイミングで、シーンを開始・終了する |
| 会話 | 後で登場するカードが、それより前の選択肢に影響することはあるか? | 解放イベントの前後のセーブデータを読み込み直す |
カードの表示名よりも、変わらないコンテンツIDを優先します。テキストやイラストは変更やローカライズの対象になりますが、archive_key_card のようなキーは、引き続き同じストーリーデータを参照する必要があります。アクセスルールは、既存の物語進行やコンテンツを管理する箇所にまとめ、個別の条件がメニューやシーンに散在しないようにします。
既存のセーブとコンテンツモデルを拡張する
プロジェクトが章、所持品、実績、現在の選択をどのように保存しているかを確認します。可能な範囲で、既存のセーブスロットとリセットの挙動を再利用します。新たに「カード解放マネージャー」を設けると、表示するシーンを決める物語進行システムと判定が食い違うことがあります。フィールドを追加する前に、どこが分岐フラグの正式な管理元かを特定してください。
Godotの安定版ドキュメントにあるセーブのチュートリアルでは、どの情報を保存するかを決め、必要なデータをシリアライズする方法を紹介しています。これはGodot固有の例であり、物語ゲームのデータスキーマを規定するものではありません。Godotを使っている場合は、実際に使用しているエンジンのバージョンを確認し、プロジェクトの現在のセーブ構成に従います。別のエンジンを使っている場合は、そのエンジンのドキュメントとプロジェクトの慣例に従ってください。
旧バージョンのセーブデータに新しいカード用フィールドがない場合の挙動を明確にします。コレクションの対象が増えたからといって、記録のないカードを一律に解放済みにしないでください。既存の章フラグからアクセス状態を導出するか、発見済みカードの一覧を空で初期化するか、一度限りの移行処理を実行するかを決めます。使用中のデッキを引き継ぐのは、旧バージョンのゲームでも永続化の対象だった場合に限ります。
編集前にAIに物語の進行を調べてもらう
関連するコンテンツID、セーブデータのモデル、章の切り替え、公開イベント、既存のリセットの挙動をAIに渡します。アクセス、発見、選択の各状態が、どこで読み書きされるかを整理するよう依頼します。実装に入る前の依頼範囲を絞り、対象ファイルの一覧、必要最小限のデータ変更、移行時のデフォルト値、ネタバレの確認項目、ロールバック手順を提示するよう求められます。差分を確認し、旧フィールドを参照したままのUIの処理経路がないかを調べます。
編集前に、既存のカードと物語進行のセーブ処理を調べてください。章へのアクセス、発見済みのカード、公開状態、現在の選択を別々に管理してください。現在の分岐順序、章のリセット、ローカライズID、セーブスロットを維持してください。まず、各状態の管理元と影響を受けるファイルを特定してください。次に、旧セーブデータに適用するデフォルト値、ネタバレの確認項目、ロールバック手順を含む、必要最小限の変更を提案してください。プロジェクト内でテストするまでは、状態が引き継がれると断言しないでください。
SEELEのカタログでは、文章で書いたアイデアからゲームを作る方法と、プレイ可能なゲームのカテゴリが紹介されています。別のカード型物語ゲームの構想を検討したり、シーンの方向性を伝えたりする用途に役立つ可能性があります。カタログの記載から、SEELEが既存の物語ゲームのコードベースを編集したり、プレイヤーのセーブデータを移行したりできるとは判断できません。
復旧できる状態を保ちながら慎重に移行する
旧バージョンのセーブデータのコピーを使います。新旧のスキーマバージョン、追加したフィールド、デフォルト値、カードIDが存在しなくなった場合の挙動を記録します。移行前後のアクセス状態と発見状態を比較できるよう、手を加えていないコピーを残しておきます。解析や移行に失敗した場合は、唯一のセーブデータを不完全な状態で上書きせず、プロジェクトで定められた復旧手順に従います。

架空の台帳はチームが確認すべき点を説明するためのもので、実際のセーブデータの挙動を証明するものではありません。読み込み後に、実際の章一覧、コレクション、使用中のデッキ、会話を確認します。後で回帰不具合が発生したときに同じ経路を再現できるよう、テスト記録にはセーブデータのバージョンと章IDを含めてください。
公開やリセットの前後をテストする
新規プロフィール、分岐が解放される直前と直後、章の再プレイ後、旧セーブデータのコピーを使った場合をそれぞれテストします。次の表は、これから実施する確認項目を示したもので、実施済みのテスト結果ではありません。
| ケース | 操作 | 確認内容 |
|---|---|---|
| 新規プロフィール | 章一覧とコレクション画面を開く | 以前の解放状態が残っておらず、ネタバレも表示されない |
| 解放イベント | 分岐へのアクセス条件を満たす | 意図したアクセス状態だけが変わる |
| カードの発見 | ストーリーカードまたは証拠カードを見つける | 正しいIDでコレクションが1回だけ更新される |
| シーンでの公開 | 物語の中でカードの内容が明かされる場面まで進める | 適切なタイミングでカードの内容が表示される |
| 章のリセット | 章を再プレイするか、最初からやり直す | 引き継ぐアクセス状態と一時的な選択状態が、それぞれルールどおりに扱われる |
| 旧セーブデータ | 旧バージョンのセーブデータのコピーを読み込む | 移行後も獲得済みのコンテンツが保持され、先の展開に関する詳細は非表示のままになる |
ビルド、セーブスキーマ、章、カードID、操作、期待した状態、実際に確認した状態を記録します。誤ったカードが表示された場合は、複数のシステムに修正を加える前に、データ移行、分岐条件の判定、コレクションの絞り込み、公開タイミング、UIのキャッシュのどこに原因があるかを特定します。
よくある質問
物語ゲームでは、どのカードの解放状態を引き継ぐべきですか?
章やセッションをまたいでも利用できるべきストーリーやコレクションの解放状態を引き継ぎます。使用中のデッキ、ドラフト中の一時的な選択、1回のプレイに限られる効果は、設計上意図して引き継ぐ場合を除き、別に管理します。変わらないコンテンツIDを使い、リセットのルールをプレイヤーが確認できるようにしてください。
証拠カードの入手とストーリーの解放には、同じフラグを使うべきですか?
通常、これらのフラグで管理する状態は異なります。プレイヤーがカードを見つけても該当する章が解放されない場合や、章を解放してもカードを選択しない場合があります。表示、絞り込み、リセットを独立して行う必要があるなら、それぞれを別の状態としてモデル化します。可能であれば、プロジェクトの既存のコンテンツモデルを再利用してください。
ストーリーカードの進捗を保存する際、ネタバレを防ぐにはどうすればよいですか?
解放済みの内容と、現在の章や画面で公開済みの内容を分けます。アクセスを許可するフラグを保存しつつ、UIでは物語の公開順序を守れます。章の切り替わりでセーブデータを読み込み直し、プレビュー、コレクション画面、会話に先の展開が早く表示されないことを確認してください。
旧バージョンのカードのセーブデータは、新しい解放システムにどう移行すべきですか?
旧セーブデータのコピーを読み込み、既知のカードIDを新しいスキーマに対応づけ、存在しないフィールドのデフォルト値を定義します。獲得済みコンテンツやプレイヤーが選んだデッキは、設計上引き継ぐべきものを保持します。移行のバージョンを記録し、実際のプロジェクトでテストに合格するまで、復元できる元データを残してください。
架空の資料館の例で、カードの解放状態が引き継がれることを証明できますか?
いいえ。架空の例でカードの分類や公開ルールを明確にすることはできますが、引き継ぎを確認するには、対象ビルドで実際にセーブし、読み込み直し、章を切り替える必要があります。ビルドとセーブデータのバージョン、解放済みと想定されるカード、各操作の後にゲームに表示された内容を記録してください。
物語の進行に合わせて状態を引き継ぐ
アクセス、発見、公開、現在の選択の各状態を、物語で意図した順序に沿って管理します。既存の一元的な管理元を再利用し、セーブデータのコピーを使って移行し、コンテンツが変わる章の境目をすべてテストします。そうすることで、プレイヤーが獲得したストーリーの進捗を失ったり、後で明かされる内容を先に見せたりせずに、チームはカードの進行システムを拡張できます。
別のカード型物語ゲームの構想を検討するなら、SEELE AI Game Makerを試してみてください。構想を形にするための出発点であり、セーブデータの移行ツールではありません。


