はじめに
Godot 4.x+Claude Code+MCPでスマホ横向き向けFPS視点の3D脱出ゲームを作る連載の第5回です。
前回までの記事はこちらです。
- 環境構築とプロジェクト作成
- Claude Code + godot-mcp セットアップ
- 【Godot 4.x】3D脱出ゲームを作ってみる①〜3Dプロジェクト作成とシーン構成〜
- 【Godot 4.x】3D脱出ゲームを作ってみる②〜FPSプレイヤーの実装〜
- 【Godot 4.x】3D脱出ゲームを作ってみる③〜タップインタラクトとズームカメラの実装〜
- 【Godot 4.x】3D脱出ゲームを作ってみる④〜プリミティブな3連ダイヤル錠ギミックの実装〜(前回)
今回は、④で実装したダイヤル錠ギミックの進行状況を、アプリ再起動後も保持できるようにします。Godotのローカルストレージ(user:// 領域)を使った保存・復元の実装から、保存データを消去する「RESET」ボタンの追加、そして将来ギミックが増えても壊れない設計への見直しまでを、Claude Codeとのやり取りをプロンプト単位で振り返る形式でまとめます。
この記事でやること
ダイヤルの選択状態を user:// へJSON形式で保存・復元できるようにし、開錠した瞬間の状態も併せて保存します。画面左上に常時表示する「RESET」ボタンを追加し、今後ギミックが増えても共通コードを変更しなくていい設計への見直しも行います。
想定環境
| 項目 | 内容 |
|---|---|
| OS | macOS(Apple Silicon) |
| Godot | 4.7 stable |
| Claude Code | 最新版 |
| godot-mcp | セットアップ済み |
| 解像度 | 1870×840(横向き) |
1. DETAIL→GIMMICK復帰時にダイヤル選択状態を保存
プロンプト:
ダイヤル錠のDETAILからGIMMICKに切り替わるタイミングで、ローカルストレージにダイヤル選択状態を保持してください
GameState に detail_exited シグナルを追加し、DETAIL→GIMMICKへ戻る唯一の合流点である player.gd の _restore_gimmick_view() 内でこれを発行するようにしました(正解到達による復帰・ジョイスティック操作による手動離脱のどちらも通ります)。dial_digit.gd には、保存済みの値を見た目の回転も含めて即座に反映できる set_value() を追加しています。dial_lock.gd が GameState.detail_exited を購読し、離脱時に3つのダイヤルの値を user://dial_lock_state.json へJSON形式で保存、_ready() 時に既存ファイルがあれば読み込んで各ダイヤルに復元するようにしました。
# dial_lock.gd(抜粋)
const SAVE_PATH = "user://dial_lock_state.json"
func _save_state():
var file = FileAccess.open(SAVE_PATH, FileAccess.WRITE)
file.store_string(JSON.stringify({
"values": [digits[0].value, digits[1].value, digits[2].value],
"solved": _is_solved
}))
func _load_state():
if not FileAccess.file_exists(SAVE_PATH):
return
var file = FileAccess.open(SAVE_PATH, FileAccess.READ)
var data = JSON.parse_string(file.get_as_text())
for i in digits.size():
digits[i].set_value(data["values"][i])
「DETAIL→GIMMICKへ戻るタイミング」を1箇所のシグナル(detail_exited)に集約したことで、正解到達・手動離脱のどちらのルートを通っても保存漏れが起きない構成にしています。
2. 開錠した瞬間の状態も保存
プロンプト:
ダイヤル錠で開錠した瞬間にその状態をローカルストレージに保存してください
保存フォーマットを {"values": [...], "solved": bool} の辞書に拡張しました。「OK」ボタン押下で正解が成立した直後(unlock() / open_drawer() 呼び出し直後)に _save_state() を呼ぶよう _on_ok_pressed() を変更し、開錠した瞬間の状態を即座に保存するようにしています。_load_state() 側では solved: true が保存されていれば起動時に _is_solved = true とし unlock() を呼んで解錠済み状態を復元します(引き出しの自動オープンは行わず、GIMMICK中のタップで開く既存の挙動に統一しています)。
「ダイヤルを合わせた状態」と「解錠済みかどうか」は別の情報なので、同じ保存データの中でも別フィールド(values / solved)として持たせておくと、復元時の分岐がシンプルになります。
3. RESETボタンの追加とローカルストレージのクリア
プロンプト:
画面の左上に常にローカルストレージを空にするボタンを設置してください。ラベルは「RESET」
ここは怪しかったので、実装後に一回尋ねてみました
プロンプト:
今後ギミックを追加してもRESET関連の実装は変更しなくても大丈夫ですか?
Claude:
⏺ いいえ、現状は完全ではありません。GameState.save_data_clearedシグナルの購読自体は汎用的なので、新しいギミックがそれを
購読して自分の状態をリセットする分にはRESETボタン側の変更は不要です。しかしGameState.clear_save_data()が削除するファイ
ルパスはDIAL_LOCK_SAVE_PATH一つだけにハードコードされているため、新しいギミックが別のセーブファイルを持つ場合、そのフ
ァイルは削除されずに残ってしまいます。
おすすめは、ファイル削除の責任をGameState側から各ギミック自身に移すことです。clear_save_data()はシグナル発行だけにし、
各ギミックがsave_data_clearedを受けて「自分のセーブファイルを消す+自分の状態をリセットする」処理を自前で行うようにす
れば、以後ギミックを追加してもGameStateもRESETボタンも一切変更不要になります。この修正を今やりますか?
やはり想定と異なっていたので、修正してもらいました
scenes/ui/reset_button.tscn(Button)と scripts/ui/reset_button.gd を新規作成し、常時表示の CanvasLayer 配下に配置して画面左上に固定表示しました。押されると GameState.clear_save_data() を呼び出します。
拡張性についての質問を受け、最終的には次の設計に落ち着きました。GameState.clear_save_data() は save_data_cleared シグナルを発行するだけの薄いAPIとし、保存パスの管理・実際のファイル削除・実行中の状態リセットは各ギミック自身の責務とする形です。
dial_lock.gd は自身の SAVE_PATH 定数を保持したまま save_data_cleared を購読し、通知を受けると自分の保存ファイルを削除した上で、_is_solved のリセット・ダイヤル値を0へ戻す・top_drawer の is_locked をtrueに戻す・開いていれば引き出しを閉じる、という一連の初期化を自己完結で行います。
# game_state.gd(抜粋)
signal save_data_cleared
func clear_save_data():
save_data_cleared.emit()
# dial_lock.gd(抜粋)
func _ready():
GameState.save_data_cleared.connect(_on_save_data_cleared)
func _on_save_data_cleared():
if FileAccess.file_exists(SAVE_PATH):
DirAccess.remove_absolute(SAVE_PATH)
_is_solved = false
for d in digits:
d.set_value(0)
top_drawer.is_locked = true
top_drawer.close_drawer()
これにより、今後ローカル保存を行う別のギミックを追加する場合も、GameState やRESETボタン側のコードは変更不要で、新しいギミック側が save_data_cleared を購読して自分の保存先を後始末するだけで対応できます。
RESETボタン側に「どのファイルを消すか」を集約させると、ギミックが増えるたびにRESET側の実装を追記する必要が出てきます。シグナルで通知するだけにとどめ、後始末を各ギミック側の責務にしておくことで、共通コードを増やさずに拡張できます。
ローカルストレージ関連 最終仕様
ダイヤル錠の選択状態・解錠状態は user://dial_lock_state.json に {"values": [Dial1, Dial2, Dial3], "solved": bool} の形式で保存されます。保存タイミングは「DETAILからGIMMICKへ戻った時(正解到達・手動離脱どちらも含む)」と「OKボタンで正解が成立した瞬間」の2箇所です。起動時(dial_lock.gd の _ready())に保存ファイルがあれば、ダイヤルの見た目・解錠状態を復元します。
画面左上に常時表示される「RESET」ボタンを押すと、GameState.save_data_cleared シグナルが発行され、購読中の各ギミックが自分の保存ファイルの削除と実行中の状態の初期化を行います。保存先の管理・削除・初期化の責務は各ギミック側に閉じているため、今後ギミックを追加してもRESET周りの共通コード(GameState・RESETボタン)は変更不要です。
成果物
「123」に揃えて戻っても、ゲームを再起動しても選択は維持されます

正解の「924」を揃えて引き出しを開けた状態もローカルストレージ(user://)に保存されているので維持されます

左上に設置した「RESET」ボタンをタップすると、状態がリセットされます

まとめ
今回は、ダイヤル選択状態の永続化から、開錠状態の保存、ローカルストレージを一括で空にするRESETボタンの追加、そして将来の拡張を見据えた責務分割のリファクタリングまでを、プロンプト単位で振り返りました。状態が合流する1箇所(detail_exited)にシグナルを置くことで、保存漏れのルートをなくせます。「合わせた値」と「解錠済みかどうか」は別フィールドとして保存しておくと復元処理がシンプルになり、RESET処理は「通知するだけ」の薄いAPIにとどめて後始末を各ギミック側の責務にすることで拡張性を確保できます。
連載リンク

