既存のメトロイドヴァニアにアビリティを追加すると、鍵のかかった扉だけでなく、ほかの箇所にも気づかないうちに不具合が生じることがあります。任意ルート、チェックポイントへの戻り方、ボスへの到達条件、古いセーブデータが前提とするワールドの状態まで変わる可能性があります。まず進行状況と依存関係を整理し、次にプロジェクトで現在状態を管理している仕組みを通じて、永続化する変更を一つだけ加え、その周辺のルートをテストします。

このガイドは、既存のプロジェクトを拡張する開発者を対象としています。一から作り直すためのガイドではありません。例に登場するGlassrootは架空の世界です。以下のマップ、セーブ用フラグ、テストケースは、各自のアーキテクチャに合わせて使う計画資料として扱ってください。
「進行状況の永続化」が何を意味するかを定義する
セーブデータにフィールドを追加する前に、部屋の移動、チェックポイントからの再読み込み、ゲームの完全な再起動を経ても残したい、プレイヤーにとって目に見える変化を明確にします。たとえば、一度獲得したダッシュは引き続き使えるようにし、そのアビリティで開けた石のゲートは開いたままにできます。一時的なスイッチの状態、敵の警戒状態、戦闘中のバフは、部屋の再読み込み時にリセットしてもかまいません。これらはシリアライザーではなく、ゲームデザインで決めることです。
| 状態の種類 | 例 | 決めること |
|---|---|---|
| アビリティ | ダッシュ、壁つかまり、二段ジャンプ | 一度獲得したら使い続けられるのか、一時的に付与されるのか、モードによってリセットされるのか。 |
| ワールドの変化 | 一方通行のゲートを開けた | ワールド全体で保持するのか、エリア単位で保持するのか、その場を離れるまで保持するのか。 |
| 部屋の状態 | レバーを引いた、敵を倒した | 部屋に戻ったときにこの状態を復元するのか。 |
| 一時的な効果 | 被ダメージ時の点滅、一時的な強化 | セーブファイルに記録する必要があるか。 |
架空の例であるGlassrootでは、探検家がダッシュを恒久的に獲得し、名前の付いた石のゲートを開け、短い周回ルートで中央ハブに戻れます。近くの敵はその場を離れると復活します。これはルール例であり、テストで確認した挙動ではありません。実際のリセットルールはプロジェクトによって異なるため、コードを変更する前に書き出しておきます。
アビリティとゲート、ルートの対応を整理する
マップに使いどころがあってこそ、アビリティは役に立ちます。そのアビリティに依存するすべてのゲート、獲得前後に到達できる部屋、ハブやチェックポイントへの戻り道を一覧にします。任意の分岐や、落ちたあとに引き返せない場所も含めます。依存関係をマップに示すと、新しいフラグで目的の扉は開いたものの、プレイヤーが戻り道の反対側に取り残されるという、よくある設計ミスに気づけます。

| 依存関係 | アビリティ獲得前 | アビリティ獲得後 | 回帰テストで確認すること |
|---|---|---|---|
| ひび割れた障壁 | 見えるが通過できない | ダッシュで壊すか通り抜けられる | プレイヤーはチェックポイントに戻れるか。 |
| 高い足場 | 通らなくても進める | アビリティで近道が開ける | 近道によって必須のチュートリアルを飛ばせてしまわないか。 |
| ボスへの道を塞ぐ封印 | ボスへのルートは閉じたまま | ワールドフラグによって先へ進める | セーブを読み込んだときに、封印とボスの状態が食い違うことはないか。 |
表は実際のマップに即して作ります。シーケンスブレイクで到達できるルートがあれば、仕様として認めるのか、塞ぐのか、ひとまずテスト対象にするのかを決めます。プレイヤーがたどる経路と、ゲームでどこまで自由な移動を認めたいかを把握するまでは、ゲーム全体に適用されるロックを追加して、想定外のルートを「修正」しないでください。
進行状況の管理を一か所に集約する
既存のプロジェクトで、アビリティ、ゲート、部屋の再読み込み、チェックポイント、セーブがどう処理されているかをたどります。インベントリやワールドフラグをすでに管理しているシステムを見つけ、可能であれば、進行状況を管理する仕組みを別に作らず、そのシステムを拡張します。「ダッシュ獲得済み」という状態を二か所で独立して持つと、値が食い違うことがあります。たとえば、HUDにはアビリティが表示されているのに、ゲートの判定は古い値を参照したまま、という事態が起こります。
永続化する変更には、後から変わり得る部屋の表示名ではなく、gate_moss_archive_open のような安定した識別子を使います。新しいフィールドが存在しない古いセーブデータに適用する既定値も決めておきます。ゲートのフラグがない場合は、ゲートを閉じたままにするのか、ボスのフラグから状態を決めるのか、一度限りの移行ルールを適用するのか。意図を持って選び、文書に残します。
Godotの安定版ドキュメントでは、user:// を書き込み可能なユーザーデータの保存先として説明し、ファイルに保存する例を掲載しています。セーブのチュートリアルでは、永続化するオブジェクトを特定し、必要なデータをシリアライズする方法も紹介しています。これらは保存とシリアライズの参考資料であり、メトロイドヴァニア向けの推奨スキーマを示すものではありません。利用しているエンジンのバージョンを確認し、実用上可能な限り、プロジェクトの既存のセーブ構成を維持します。
可能であれば、保存するデータはシーンツリー全体よりも小さくします。安定したアビリティIDとワールドフラグだけで、部屋の見た目を復元できる場合があります。何も考えずにすべてのノードを永続化すると、後からシーンをリファクタリングしにくくなります。すでにオブジェクトをシリアライズしているゲームでは、既存の規約に従い、正しく復元するために必要な値だけを追加します。
変更範囲を明確にしてAIに依頼する
AIはプロジェクトの調査やパッチ案の検討に役立ちます。依頼の際は、変えてはいけない条件を明示します。たとえば、次のように依頼できます。
編集する前に、既存の進行管理とセーブ処理の流れを調べてください。プレイヤーの移動、部屋のつながり、ボスの順序、チェックポイントの挙動、既存のアビリティIDは変更しないでください。現在の状態管理の仕組みを使い、新しいアビリティ一つと、それに依存するゲート一つを永続化するための最小限の変更を提案してください。まず、対象ファイルと移行時の前提を列挙してください。次に、元に戻せるパッチ計画、影響を受けるルート、新規セーブ、既存セーブ、旧バージョンのセーブそれぞれのテストを示してください。このプロジェクトで実際にテストを実行した場合に限り、ゲームがテストに合格したと報告してください。
差分を確認し、同じ状態を管理する仕組みが重複していないか、表示用テキストをセーブキーに使っていないか、古いセーブデータについてどんな前提を置いているか、部屋の移動処理に変更がないかを確認します。ファイルごとの変更概要と、明確な切り戻し手順も求めます。ツールがコンセプトやコード案を出しただけでは、ゲームへの組み込みやテストが行われた証拠にはなりません。
SEELEのカタログでは、文章で書いたアイデアからゲームを作成でき、RPG、ランナー、シューター、ローグライクなど、プレイ可能なゲームのジャンルに対応していると説明しています。既存プロジェクトとは別にプレイ可能なコンセプトを試したり、進行のアイデアを伝えたりする用途に使えます。カタログからは、SEELEが既存のリポジトリを編集したり、セーブデータを移行したりできるとは確認できません。こうした変更には、プロジェクトで使っている既存の作業手順を用いてください。
古いセーブデータを保護し、移行ルールを定める
移行テストにはセーブデータの複製を使い、唯一のコピーは使わないでください。そのファイルに存在しない新規フィールドと、ゲームが適用する既定値を一覧にします。獲得済みのアビリティがいつの間にか失われていないか、ゲートが予期せずリセットされないか、古いクリア済みフラグが移行後も意味を持つかを確認します。進行の設計が大きく変わる場合は、セーブスキーマにバージョンを付け、移行時の挙動を明示します。
移行手順の文書には、旧スキーマと新スキーマのバージョン、追加または改名したフィールド、代替値、データの解析に失敗した場合の挙動を記載します。復旧時の挙動は、ゲームの既存の設計に合わせます。セーブデータのカードを模した図でこの取り決めを説明することはできますが、互換性を確認できるのは、対象ビルドで実際に読み込んだときだけです。
拡張前に一つのバーティカルスライスで検証する
アビリティを一つ、それに依存するゲートを一つ、戻り道を一つ実装します。同じ方式をすべてのエリアに適用する前に、一連の流れを通してテストします。ビルド、セーブデータのバージョン、部屋、操作手順、期待した状態、実際に確認した状態を記録します。テストで問題が見つかったら、アビリティの獲得、シリアライズ、ロード時の復元、入室処理、画面上のフィードバックのどこで食い違いが生じたかを切り分けます。
| テストケース | 操作 | 確認すること |
|---|---|---|
| 新規セーブ | アビリティを持たない状態で開始する | ゲートが閉じており、想定された序盤のルートを通れる |
| アビリティの獲得 | アビリティを獲得し、対応するゲートを通る | アビリティの状態とワールドフラグがそれぞれ一度だけ更新される |
| 来た道に戻る | その場を離れ、周回ルートを通って戻る | ゲート、チェックポイント、マップの状態に食い違いがない |
| 再読み込み | セーブしてゲームを終了し、再度読み込む | アビリティと永続化したゲートの状態が復元される |
| 古いセーブデータ | 変更前のセーブデータの複製を読み込む | 既定値または移行処理によって、プレイを続けられるルートが確保されている |
| リセット | プロジェクトで想定されている再スタート操作を行う | 永続化する値と一時的な値が、文書化したルールに従う |
以下の架空のチェックポイント画像は、アビリティが保持され、ルートが開いた状態を示す例です。実際に動作しているゲームから得た結果ではありません。

よくある質問
メトロイドヴァニアの進行システムでは何を永続化すべきですか?
部屋を出たりゲームを再起動したりした後も、設計上必要な状態だけを永続化します。獲得したアビリティ、開けた一方通行のゲート、ボス戦の結果、長期的に残るワールドの変化などです。一時的な戦闘効果や、保存対象外の部屋内での操作は別に扱います。フィールドは、既存ゲームの状態管理の仕組みとリセットルールに合わせます。
既存のルートを壊さずにアビリティを追加するにはどうすればよいですか?
そのアビリティに依存するすべてのゲートをマップに示し、獲得前でも想定どおりに通れるルートが少なくとも一つあることを確認します。戻り道、チェックポイント、シーケンスブレイク、任意で立ち寄れる部屋も確認します。マップをレビュー資料として使い、そのうえで各ルートを実際のビルドで検証します。
開いたゲートはセーブデータを読み込んだ後も開いたままにすべきですか?
ゲートが恒久的なワールドの変化を表す場合は、安定したゲートIDかワールドフラグを保存し、読み込み時にその状態から部屋を復元します。一時的なスイッチであれば、部屋の状態として保持します。想定するルートに合わせて決め、リセット時の挙動をプレイヤーに伝えます。
Godotでは永続化するゲームデータをどこに保存しますか?
Godotの安定版ドキュメントでは、user:// を書き込み可能なユーザーデータの保存先として説明し、ファイルに保存する例を掲載しています。対象プラットフォームと現在使用しているエンジンのバージョンを確認し、可能であればプロジェクトの既存のセーブ処理を使います。どのゲーム状態を永続化するかは、ドキュメントで定められているわけではありません。
新しい進行の仕組みを安全にテストするにはどうすればよいですか?
セーブデータの複製を使い、新規プレイ、アビリティの取得、対応するゲート、来た道への戻り、チェックポイントからの再読み込み、古いセーブデータの読み込みをテストします。ビルド、セーブデータのバージョン、部屋、期待する結果を記録します。架空のマップやモック画面はテスト計画の説明には使えますが、実際のビルドがテストに合格した証拠にはなりません。
一連の流れを確認してから拡張する
永続化するアビリティやワールドの変化ごとに、対応するゲート、戻り道、リセットルール、セーブデータを管理する仕組みを整理します。まず一つのバーティカルスライスを実装し、獲得、引き返し、再読み込み、古いセーブデータでの挙動を検証してから、同じ方式をマップ全体に広げます。こうすることで、既存ゲームの進行の仕組みを把握しやすいまま、安全に拡張できる土台を作れます。
この一連の進行をもとに、別のプレイ可能なアイデアを形にしたい場合は、SEELE AI Game Makerを試してみてください。コンセプトを形にするための選択肢であり、既存のプロジェクトを移行するツールではありません。


