はじめに
Godot 4.x+Claude Code+MCPでスマホ横向き向けFPS視点の3D脱出ゲームを作る連載の第6回です。
前回までの記事はこちらです。
- 環境構築とプロジェクト作成
- Claude Code + godot-mcp セットアップ
- 【Godot 4.x】3D脱出ゲームを作ってみる①〜3Dプロジェクト作成とシーン構成〜
- 【Godot 4.x】3D脱出ゲームを作ってみる②〜FPSプレイヤーの実装〜
- 【Godot 4.x】3D脱出ゲームを作ってみる③〜タップインタラクトとズームカメラの実装〜
- 【Godot 4.x】3D脱出ゲームを作ってみる④〜プリミティブな3連ダイヤル錠ギミックの実装〜
- 【Godot 4.x】3D脱出ゲームを作ってみる⑤〜ダイヤル錠ギミックの状態をローカルストレージに保存する〜(前回)
今回は、3Dモデルのアイテムを部屋に配置してタップで取得し、画面右側の所持アイテムバーに表示する機能を実装します。実装中に発生した「アイテムが拾えない」「引き出しが開かなくなる」といったバグの原因調査・修正の過程も含めて、Claude Codeとのやり取りをプロンプト単位で振り返る形式でまとめます。
この記事でやること
3Dアイテムモデルの配置とタップ取得を実装し、画面右側の所持アイテムバー(インベントリUI)を作ります。アイテムが取得できない不具合の原因調査、インベントリのアイコン表示とローカルストレージへの永続化、RESET時にワールド上のアイテムも復元する仕組みまで扱います。
想定環境
| 項目 | 内容 |
|---|---|
| OS | macOS(Apple Silicon) |
| Godot | 4.7 stable |
| Claude Code | 最新版 |
| godot-mcp | セットアップ済み |
| 解像度 | 1870×840(横向き) |
1. アイテム3Dモデル
meshyで金の鍵の3Dモデルを作成しました。
meshyはテキストプロンプトから画像=>3Dモデルまで作れるサービスです。
ただし、確か無料枠ですと1、2個モデル作成が限界だっと思います。
サイズは12.00cmですと巨大でしたので、最終的に 1.20cm、起源(アンカー?)はセンターにしました。
フォーマットは glb がgodotでは最適とのことです。
item_01.glb と付随するテクスチャ(base_color / normal / metallic_roughness / emissive、いずれも2048×2048)を配置しました。
容量を気にするのであれば、もっとシェイプアップなど必要になるかもしれませんが、ここでは割愛いたします。
2. top_drawer内へのアイテム配置
プロンプト:
item_01.glbをtop_drawerの中に設置
ダイヤル錠付き引き出し(bed_table_2.tscn の top_drawer)の内部構造を調査し、引き出し本体がGIMMICK解除時に top_drawer.gd の open_drawer() / close_drawer() でトゥイーンされる仕組みを確認しました。item_01.glb を top_drawer ノードの子として配置し、引き出しの開閉と連動して一緒に動くようにしています。
3. 所持アイテム表示バーとタップ取得の実装
プロンプト:
画面右側に、右側視点回転領域よりZ軸の上に、所持アイテム表示バーを高さ100%で設置してください。item_01をタップしたら、アイテムは削除して所持アイテムに加えてください
player.gd の視点回転は、Controlノードのタッチ消費機構を使わず「タッチ座標が画面右半分か」を直接判定する自前実装だったため、UIバーと同じ判定方式に合わせて対応しました。autoload/game_state.gd に inventory 配列と inventory_changed シグナル、add_item() を追加し、scripts/item_pickup.gd を新規作成して on_tapped() で GameState.add_item() を呼び、アイテムをワールドから取り除くようにしています。scripts/player.gd にはインベントリバー幅分(INVENTORY_BAR_WIDTH)を画面右端から除外する処理を追加し、タッチ開始位置がバー上なら視点回転・インタラクトRayどちらも発火しないようにしました。GIMMICK中に引き出しが開いた後のタップは、on_tapped を持つコライダー(アイテムなど)へ個別ディスパッチするよう player.gd のGIMMICK分岐を修正しています。scenes/ui/inventory_bar.tscn / inventory_bar.gd も新規作成し、右端・高さ100%のバーとして CanvasLayer に追加、GameState.inventory_changed 購読で所持アイテムのアイコンを縦に並べて表示するようにしました。
既存の「右半分=視点回転」という判定に新しいUI(インベントリバー)を割り込ませる場合、UI側の当たり判定だけでなく、既存の自前タッチ判定側にも除外領域を追加する必要がある点に注意です。
4. アイテムが取得できない不具合の調査(1回目)
プロンプト指示不足もありそうですが、不具合発生しましたので、その対応の流れもついでに掲載しておきます。
プロンプト:
item_01をタップしてもアイテム取得できません
解錠後にカメラがダイヤルを見るズーム位置に戻ることから、「引き出しの中を覗き込むDETAILズームへの導線がないのでは」と仮説を立て、player.gd のGIMMICK分岐に「開いた後、対象コライダーが on_tapped を持たなければ detail_camera_position でDETAILへフォールスルーする」処理を追加しました。
プロンプト:
持っていなければ、detail_camera_positionを使ってDETAIL(覗き込みズーム)へ移動できるようフォールスルーするようにしました、は不要です
この対応は不要と判断されたため、GIMMICK分岐を追加前の状態に戻しています。
5. 本当の原因究明とコライダー無効化による修正
Claudeがログを求めてきましたので、そのまま伝えます。
プロンプト:
[Interact] Hit: StaticBody3D at (-1.066513, -0.030893, -5.020671)
[Interact] Collider: StaticBody3D:
タップ時のコンソールログを提供してもらい、ヒット座標からワールド変換を逆算しました。当たっていたのはitem_01ではなく、top_drawer自身の外殻コライダー(0.4×0.28×0.35の箱)で、これがitem_01の小さなコライダーを内側に完全に包含していたためRayが常に外殻表面で止まっていたことが判明しました。
小物アイテムを親コライダーの内側に配置する場合、親側のコライダーがRayを先に受け止めてしまい、内部のオブジェクトまでRayが届かないことがあります。今回のように「開いたら親コライダーを一時的に無効化する」対応が必要になるケースがあります。
player.gd には「is_enabled == false のStaticBody3Dはスキップして奥のコライダーを再判定する」パススルー機構が③の時点で既にあったため、これを活用しました。top_drawer.gd の open_drawer() で自身の is_enabled を false にし、close_drawer() で true に戻すことで、開いた後はRayが外殻を素通りしてitem_01まで届くようにしています。
6. 専用アイコン画像への切り替え
最初はglbに付随しているテクスチャを表示していましたので、新たに作成したサムネイル画像を表示したい旨を伝えました。
プロンプト:
そのitem_01.pngを画面右側所持アイテムに表示したいです
assets/models/items/item_01.png(256×256、透過背景の鍵アイコン画像)を確認し、inventory_bar.gd の参照先を %s_base_color.jpg から %s.png に変更しました。以後は同じ命名規則(item_id.png)でアイテムを追加すれば自動的にアイコンが反映されます。
7. 所持アイテムのローカルストレージ保存
プロンプト:
アイテムの所持ステータスもローカルストレージに保存してください。アイテムは10-20個ある想定です
⑤で実装したダイヤル錠と同じ user:// 保存パターンを踏襲しました。autoload/game_state.gd に user://inventory_state.json への保存・読み込みを実装し、add_item() 時に自動保存、_ready() 時に自動読み込みするようにしています。あわせて item_pickup.gd の _ready() で、読み込んだ時点で既に所持済みのアイテムはワールド側に再配置しないようチェックを追加しました。clear_save_data()(RESETボタン)でも所持アイテムをクリア・保存ファイル削除するようにしています。
8. RESET時にワールド上のアイテムも復元
プロンプト:
RESET時、item_01.glbも元に戻してください
これまでは取得時に queue_free() でノードごと削除していたため、RESETで所持データを消してもワールド側のアイテムは復活できませんでした。item_pickup.gd を「削除」ではなく「非表示化」する方式に変更しています。
取得時は visible = false ・ is_enabled = false にして非表示かつタップ不可にし、ノード自体は保持します。GameState.save_data_cleared を購読しておき、発火時には visible = true ・ is_enabled = true に戻して再度取得可能な状態に復元します。読み込み時に既に所持済みだった場合も、同じ非表示化処理に統一しています。
「削除」ではなく「非表示化+タップ無効化」にしておくと、RESETのような「元に戻す」操作に対応しやすくなります。一度queue_free()したノードは復元できないため、後から状態リセットの要件が出てくる可能性があるものは非表示化で扱うのが安全です。
アイテム関連以外のバグ修正
今回の実装の過程で仕込まれたのか、前回からの不具合なのかは不明でしたが、発生現象詳細と、できればスクショを添えてclaudeに伝えれば、修正をトライしてくれます。
引き出しクローズロジックの確認
プロンプト:
引き出しを開けてからNORMALに戻る時は引き出しを閉めるロジックに戻してください
調査の結果、player.gd の _restore_normal_view() では元々 _gimmick_target.close_drawer() が呼ばれており、GIMMICK→NORMAL復帰時に引き出しを閉じるロジックは変更されていないことを確認しました。コード変更は不要でした。
ダイヤル錠解錠済み状態で引き出しが開かない不具合
プロンプト:
ギミックを解いている状態で引き出しが開かずにダイヤル錠のDETAILモードになります。一度戻って2回目以降は引き出しが開きます
コンソールログ([Interact] Hit: ...)を複数回にわたり提供してもらい、一時的なデバッグ出力も追加して調査した結果、以下の根本原因を特定しました。
dial_digit.gd(ダイヤルの数字)はNORMAL時に直接タップされた場合に備えて camera_target_position をtop_drawerと同じ値でエクスポートしていました。何らかの理由でNORMALモードに戻った直後にダイヤルの数字へ直接タップが当たると、player.gd の _gimmick_target が「top_drawer本体(is_locked/open_drawerを持つ)」ではなく「タップされたダイヤル本体」に上書きされてしまいます。ダイヤル自体は is_locked を持たないため、以降のタップで解錠済み判定ができず、常にDETAILへのズームにフォールバックしていました。
「同じ場所を複数のコライダーがタップされうる」構成では、どのコライダーがヒットしても同じ論理的な対象(今回で言えばtop_drawer)を指し示すよう、参照の解決方法を統一しておく必要があります。
修正として、dial_digit.gd に自身が属する引き出し本体への参照 gimmick_owner(デフォルトパス ../../StaticBody3D で既存シーンの変更なしに自動解決)を追加しました。player.gd のNORMAL→GIMMICK遷移時、タップされたコライダーが gimmick_owner を持っていればそちらを _gimmick_target として記録するように変更し、ダイヤルへの直接タップ経由でも常に正しい引き出し本体が追跡されるようにしています。
# dial_digit.gd(抜粋)
@export_node_path("Node") var gimmick_owner_path: NodePath = ^"../../StaticBody3D"
func get_gimmick_owner() -> Node:
return get_node_or_null(gimmick_owner_path)
成果物
金の鍵をタップすると、所持状態になり、右側のインベントリゾーンに表示されました!

まとめ
今回は、アイテムの3Dモデル配置から、タップ取得、所持アイテムバーの表示、アイコンの調整、ローカルストレージへの永続化、RESET時の復元までを、プロンプト単位で振り返りました。あわせて、調査の過程で見つかった _gimmick_target の取り違えバグの修正についても記録しています。自前のタッチ判定にUIを追加する際は、UI側だけでなく既存の判定ロジック側にも除外領域を組み込む必要があります。親コライダーが内部の小物のRayを受け止めてしまう場合は、開閉などの状態変化に合わせてコライダーを一時的に無効化するとよく、「削除」ではなく「非表示化」にしておくとRESETのような復元操作にも対応しやすくなります。同じ対象を複数のコライダーからタップされうる構成では、参照の解決方法を一箇所に統一しておくことも重要です。
連載リンク




