進行状況を永続化するときは、プレイヤーが獲得した成果を引き継ぎつつ、サバイバルプレイ中のあらゆる状態まで保存することは避けます。 拠点防衛ゲームでは、この区別が重要です。解放した谷やキャンプのアップグレードはワールドに残す成果になり得ますが、いま門を襲っている敵は通常、その夜のプレイに限った状態です。

AIアシスタントに既存のプロジェクトを編集させるなら、まず、すでに動いている機能と、変更してはいけない要素を伝えます。そのうえで、永続化する成果に保存範囲を絞ります。このガイドでは、松林の谷を舞台にした架空のプロトタイプで設計を説明します。実際の実装やプレイテストの報告ではありません。
ワールドの進行状況とその夜のプレイを分ける
コードを依頼する前に、ゲームを再起動しても残すべき状態を書き出します。まずはすべての変数を、ワールドに残る進行状況、セッションの設定、プレイ中の一時的な状態の3つに分けると整理しやすくなります。「進行状況」という言葉を曖昧に使い、いつの間にかプレイ途中の状態を丸ごとセーブする機能にまで範囲を広げないようにします。
| 状態 | 具体例 | 保存の基本方針 |
|---|---|---|
| ワールドに残る状態 | 地域の解放、研究済みの防衛設備、恒久的なキャンプの段階、備蓄済みの資源 | 明確なチェックポイントを通過した後に保存 |
| プレイヤー設定 | 音量、操作方式の選択、アクセシビリティ設定 | ワールドの進行状況とは別に保存 |
| 現在のプレイ状態 | 敵の位置、飛翔中の弾、一時的なシールド、未完了の夜 | 途中再開機能がすでにある場合を除き、リセット |
この架空の例では、夜をクリアすると信号塔が解放され、報酬を備蓄に加えられます。一方、進行中の敵ウェーブ、一時的なバリケードの残り耐久値、個々のクリーチャーの位置は、新しいプレイを始めるとリセットされます。機能の範囲はワールドに残る報酬の保存に絞り、昼に採集し、夜に防衛する既存のループを維持します。
ゲーム内ですでに使っている用語や識別子を使います。プロジェクトに地域IDやアップグレードIDがあるなら、そのIDを再利用します。セーブファイルには、変更の影響を受けやすいシーンノードのパスや、ローカライズで変わり得る表示名を使わず、同じ対象を継続して識別できる値を記録します。
変更前に既存プロジェクトの構成と動作を確認する
プロジェクトのコピーを使って、比較の基準を作ります。エンジンとそのバージョン、現在のセーブ動作、メインシーン、昼から夜への切り替え、報酬の計算方法、それぞれの処理を担うファイルを記録します。可能であれば、比較用に短い画面録画やスクリーンショットを残します。AIで生成したイラストを、変更前の動作を裏付ける資料として扱わないようにします。
AIアシスタントには、まず調査し、ファイル単位の変更計画を出すように依頼します。たとえば、昼夜の時計、採集、敵の出現、操作、戦闘は維持する、保存対象は備蓄済みの素材、解放済みの地域ID、恒久的なキャンプのアップグレードIDに限る、出現中の敵や一時的な効果は保存しない、編集前に変更対象のファイルをすべて挙げる、と指定できます。差分は小さく抑え、元に戻す手順も添えるように依頼します。
計画を承認する前に、実際のプロジェクトと照らし合わせます。既存のゲームが夜の終了時に報酬を記録しているなら、素材を拾うたびに保存するのではなく、その既存の処理の区切りで保存処理を呼び出します。新しく「夜の完了」イベントを追加する場合は、シーン遷移や再起動時に同じイベントが2回発火しないことを確認します。
バージョン管理を前提に保存範囲を設計する
シリアライズの詳細は、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は安全に拒否し、数値はゲームのルールで有効範囲が定義されている場合に限ってその範囲に収め、データを復旧できない場合は初期状態のプロファイルに切り替えます。
エクスポート先のプラットフォームに合わせて、エンジンがサポートするユーザーデータ用の保存先を選びます。Godotの安定版ドキュメントは、パッケージ化されたプロジェクトのリソースが読み取り専用になる場合があり、ユーザーデータ用のパスには書き込めることから、永続データに user:// を推奨しています。Unityのドキュメントでは、起動をまたいで保持するデータの保存先として Application.persistentDataPath を案内し、実際の場所はプラットフォームによって異なると説明しています。クラウド同期、バックアップ、暗号化、競合の解決は、どちらのパスを選んでも別途対応が必要な要件です。

一貫したチェックポイントで保存する
チェックポイントには、報酬とワールドの変化がすでに確定した時点を選びます。この例なら、夜を終え、勝敗を確定させ、報酬の素材を一度だけ備蓄に加え、獲得条件を満たした恒久アップグレードを解放し、整合性の取れたスナップショットを1つ書き込んでから、翌日の採集を始める流れが考えられます。厳密な順序は既存のプロジェクトによって異なります。現在の動作を維持し、処理の順序を明確にします。
書き込みが途中で中断される場合も考えます。慎重に設計するなら、まず新しい一時ファイルに書き込み、読み込めることを検証してから、以前のセーブファイルと置き換えます。プラットフォームが対応していれば、復旧用のコピーを1つ残します。あらゆる端末やストレージ障害に対して完全に安全だとは約束しないようにします。保存先のディレクトリがない場合、書き込みに失敗した場合、ファイルの形式が不正な場合の動作を決めておきます。分かりやすいメッセージを表示し、可能な限り以前のデータを保持し、気づかないうちに報酬を二重に付与することを防ぎます。
可能であれば、チェックポイントの処理を冪等にします。保存後にシーンが再読み込みされても、同じ夜の完了イベントで報酬が再び加算されないようにします。たとえば、完了したプレイの識別子やチェックポイントのマーカーをスナップショットと一緒に保存し、次の状態が確立してからその識別子やマーカーを消去する方法があります。この機能のためだけに新しいイベントシステムを作るのではなく、プロジェクトの既存の構成に合わせます。
AIには小さく元に戻せる変更を依頼する
変更してよいファイル、引き継ぐ状態、リセットする状態、保存のタイミング、維持する既存システム、実施すべき具体的な確認項目を、AIアシスタントに明示します。前提を置く場合は、編集前に説明してもらいます。編集後は、差分を計画と照らし合わせ、シリアライズのコードを確認し、想定した保存範囲の外で書き込みが行われていないか調べます。
変更前のプロジェクトのコピーと、旧セーブデータのサンプルを残しておきます。初期の確認段階では、正常と分かっている唯一のセーブデータを新しいビルドで上書きしないようにします。永続化を簡単にするためにゲームループの置き換え、資源バランスの変更、戦闘処理の書き直しを提案されたら、依頼範囲を絞り、より小さなパッチを求めます。
新規開始・再開・復旧のケースを検証する
正常に起動するかどうかは、確認項目の1つにすぎません。簡単なテスト表を使い、ビルド、プラットフォーム、手順、期待される結果、実際の結果、プロファイルが新規か移行済みかを記録します。以下はテスト計画のひな形で、実施済みのテスト結果を示すものではありません。
| ケース | 準備・操作 | 期待される結果 |
|---|---|---|
| 新規プロファイル | テスト用のセーブファイルを削除するか名前を変更する | 仕様に記載された初期状態のキャンプで始まり、以前の解放状態が残っていない |
| 夜の完了 | 恒久的な報酬を1つ獲得し、チェックポイントに到達する | 報酬は一度だけ備蓄に加わり、既存のループはこれまでどおり次のフェーズに移る |
| 既存プロファイルでの再開 | ゲームを正常に終了してから再起動する | 恒久的な解放状態は引き継がれ、一時的な敵ウェーブやバフは引き継がれない |
| 旧スキーマ | 前のバージョンのセーブデータをコピーして読み込む | 移行後も確認済みの進行状況が保持され、新しいスキーマバージョンが記録される |
| 不正なファイル・書き込みの中断 | 形式が不正な使い捨てのコピーを使うか、テスト用の書き込みを安全に中断する | 復旧時の挙動が分かりやすく、報酬が二重に付与されない |
元のプロジェクトと変更後のビルドも並べて比較します。採集時の操作、敵が出現するタイミング、夜への切り替え、アップグレードの費用が、機能要件として明示された変更を除いて従来どおりであることを確認します。書き込み可能なパスやエクスポートしたビルドの動作はプラットフォームごとに異なるため、対象プラットフォームすべてで確認を繰り返します。テストの記録はパッチと一緒に保管し、計画を作っただけでテストに合格したと記載しないようにします。

よくある質問
拠点防衛サバイバルゲームでは、次回のプレイに何を引き継ぐべきですか?
解放済みの地域、恒久的なキャンプのアップグレード、備蓄済みの資源など、ワールドに残すと決めた成果を保存します。プレイ途中のセーブにすでに対応している場合を除き、現在の敵の位置、一時的な効果、未完了の夜のプレイ状態は保存対象から外します。こうすると、意図した報酬だけが残り、次回のプレイに何が引き継がれるのかを説明しやすくなります。
Godotのゲームでは、プレイヤーの進行状況をどこに保存すべきですか?
Godotの安定版ドキュメントは、永続化するプレイヤーデータの保存先として user:// を推奨しています。エクスポートしたゲームの実行中は、プロジェクトのリソースが読み取り専用の場合がありますが、user:// には書き込めるためです。保存方法を決める前に、最新のドキュメントと対象プラットフォームを確認します。セーブデータの形式の選定と検証は、保存先の選定とは別に行います。
進行状況の保存機能を追加するとき、既存のセーブデータを壊さないためにはどうすればよいですか?
スキーマバージョンを追加し、解放項目やアップグレードに安定したIDを割り当て、移行処理を明示します。旧セーブデータのコピーを残して新しいビルドで読み込み、分かっている進行状況が保たれていることを確認してから、元のデータを上書きします。プレイヤーの唯一のセーブデータを開く前に、使い捨てのコピーで移行をテストします。
夜を終えたとき、どのタイミングで保存すべきですか?
夜の結果が確定してから次の日が始まるまでの間に、明確なチェックポイントを設けて保存します。無関係な複数のシステムから報酬の一部ずつを書き込むことは避け、進行状況を整合性の取れたスナップショット1つにまとめて保存し、復旧に使える直前のファイルを残します。既存のゲームが一度だけ到達する処理の区切りを選びます。
読み込みに成功すれば、セーブシステムの安全性は確認できたといえますか?
いいえ。新規プロファイル、夜の完了時のセーブ、ファイルが存在しない場合や形式が不正な場合、旧スキーマ、書き込みの中断もテストします。各ケースの後に、対象プラットフォームで昼夜のループと報酬を確認します。結果はケースごとに記録します。計画だけでは、テストに合格した証拠にはなりません。
永続化は動作を確認しやすい範囲から始める
ワールドが前に進んだと感じられる最小限の状態から永続化します。バージョン付きのスナップショット、明確に定めたチェックポイント1つ、移行計画、再現可能なテストケース数件があれば、あらゆる戦闘イベントと結びついたセーブシステムよりも確認しやすくなります。この範囲の実装が実際のプロジェクトで安定してから、計画的に対象を広げます。
ブラウザーで遊べる別のゲームのアイデアを試したい場合は、SEELE AI Game Maker をお試しください。ここでは、別のプロトタイプを作る手段として紹介しています。既存のプロジェクトを編集・修復するツールとしての紹介ではありません。


