5
4

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【Godot 4.x】3D脱出ゲームを作ってみる④〜プリミティブな3連ダイヤル錠ギミックの実装〜

5
Last updated at Posted at 2026-07-15

はじめに

Godot 4.x+Claude Code+MCPでスマホ横向き向けFPS視点の3D脱出ゲームを作る連載の第4回です。

前回までの記事はこちらです。

今回は、家具の引き出しに「回して数字を合わせるダイヤル錠」パズルを実装します。godotのアセットがUnityのアセットストアと比べてまだ未成熟の感があり、他の素材使用ですとライセンスの様々な問題がありますので、3D専用アセットに頼らず、円柱とLabel3Dだけのプリミティブ形状でダイヤルを自前構築し、表示バグの修正から正解判定・引き出しの開閉まで実装しました。Claude Codeとのやり取りをプロンプト単位で振り返る形式でまとめます。

この記事でやること

プリミティブ形状(円柱+Label3D)による3連ダイヤルを新規作成し、ZOOM状態からさらに接近する「DETAIL」状態を追加します。あわせて、ダイヤルの数字表示がずれる不具合の調査・修正、「OK」ボタンによる正解判定と解錠後の引き出し自動オープンまで扱います。

スクリーンショット 2026-07-16 8.34.11.png

想定環境

項目 内容
OS macOS(Apple Silicon)
Godot 4.7 stable
Claude Code 最新版
godot-mcp セットアップ済み
解像度 1870×840(横向き)

1. 3連ダイヤル錠の新規作成

プロンプト:
bed_table_2のtop_drawerに、プリミティブな、縦に回す0から9のダイヤルが横に3つ並んだダイヤル錠を作成して設置してください

単一ダイヤルのロジックを持つ scripts/dial_digit.gd を新規作成しました。_ready() でプリミティブな円柱(ダイヤル胴体)と、その周囲に0〜9の Label3D を36°間隔で放射状に生成し、Digits ノードをX軸周りに回転させることで正面に見える数字を切り替える仕組みです。タップ位置がダイヤルの上半分/下半分かで数字を+1/-1します。これを3つ横並びにした dial_lock.tscn を新規作成し、bed_table_2.tscn の top_drawer に設置しました。player.gd のZOOM中タップ判定は、on_tapped() メソッドを持つオブジェクト(ダイヤル)にも反応するよう拡張しています。


2. ダイヤル操作用のGIMMICK状態を再導入

プロンプト:
top_drawerのGIMMICK時にさらにタップするとview_modeをDETAILにしてください。この時にダイヤルをいじれるように。ジョイスティックでの戻るはDETAIL -> GIMMICK

ViewMode に DETAIL を追加し、NORMAL → GIMMICK → DETAIL の3段階状態遷移を実装しました。DETAIL中はダイヤルタップのみ反応し、ジョイスティック操作では一段階ずつ(DETAIL→GIMMICK→NORMAL)状態を戻すようにしています。スワイプでの視点回転もNORMAL時のみ有効に限定しました。

③で作ったGameState.view_mode(NORMAL/GIMMICK)の2段階に、さらに一段階「接近して操作する」状態を追加した形です。状態が増えるほど、遷移条件と入力の有効/無効を一覧で整理しておくと管理しやすくなります。


3. DETAIL時のカメラ位置指定

プロンプト:
DETAILの時、カメラをさらに-1.094, -0.139, -4.94、回転0, 0, 0 にtween移動

GIMMICK→DETAIL移行時にカメラを指定座標へTweenで移動させる _gimmick_to_detail と、復元用の _restore_gimmick_view を追加しました。top_drawer.gd ・ dial_digit.gd に detail_camera_position / detail_camera_rotation_degrees のexport変数を追加しています。

スクリーンショット 2026-07-16 8.34.11.png


4. ダイヤル位置調整と数字ズレの指摘

初回の設置で、数字ラベルがだいぶズレたりしてましたので、下記のようにやり取りして直してもらいました。

スクリーンショット 2026-07-15 17.14.44.png

プロンプト:
ダイヤルの位置をY軸上に少し移動。あと、ダイヤルの各数字がずれてます(0, 5の時は正常)。スクリーンショットを参考に

プロンプト:
このようにダイヤルの数字がずれているので、修正

プロンプト:
まだずれてます

プロンプト:
1,5以外はずれます

プロンプト:
ダイヤル錠をY軸上に0.05m移動

放射状に配置したLabel3Dの一部(0, 5のみ正常、他はズレる/後に1, 5以外がズレると判明)が正面からずれて見える不具合でした。スクリーンショットを参照しながら複数回にわたってやり取りし、位置調整(Y軸方向に0.05m)と合わせて回転角度の計算を見直しています。

claude codeのプロンプトにはファイルも渡せますので、不具合のスクショを渡して修正・提案などしてもらいました


5. 正解判定と、解錠後の引き出しオープン仕様

プロンプト:
ダイヤル錠を「924」に合わせたら、GIMMICKに戻り、bed_table_2のtop_drawerのGIMMICK時にタップしたとき、DETAILに移行するのではなく、引き出しを開くようにしてください

3つのダイヤルの値を監視し「924」と一致したら解錠する dial_lock.gd を新規作成しました。GameState に detail_solved シグナルを追加し、正解時にDETAIL→GIMMICKへカメラが自動復帰するようにしています。top_drawer.gd に is_locked / unlock() / open_drawer() を追加し、解錠後はGIMMICK中のタップでDETAILへ移行せず引き出しを開くよう player.gd を変更しました。

# dial_lock.gd(抜粋)
extends Node3D

const TARGET_CODE = [9, 2, 4]

func _check_code():
    for i in digits.size():
        if digits[i].value != TARGET_CODE[i]:
            return
    GameState.detail_solved.emit()
    top_drawer.unlock()

6. 正解判定が反応しない不具合の修正

プロンプト:
924に合わせても何も起こらないです

4で見た目のズレを修正した際、内部の value 変数と実際に正面表示される数字の対応関係が反転したまま残っており、dial_lock.gd の正解判定が実際の表示と一致していなかったことが原因と判明しました。回転量の蓄積方向の符号を修正し、value が表示中の数字と一致するようにしています。

表示の見た目を先に修正すると、内部状態(今回はvalue)と表示の対応関係がズレたまま残ってしまうことがあります。見た目の修正後は、実際に判定ロジックと突き合わせて動作確認するところまでセットで行うと安全です。


7. GIMMICK→NORMAL復帰時に引き出しを閉じる

プロンプト:
top_drawerのGIMMICKからNORMALに戻る時は引き出しを閉めてください

top_drawer.gd に、開いた位置を記録して元の位置へ戻す close_drawer() を追加しました。player.gd にGIMMICK対象を保持する _gimmick_target を追加し、NORMALへ復帰する際に対象が close_drawer() を持っていれば呼び出すようにしています。


8. 解錠後もダイヤルタップでDETAILに遷移してしまう不具合の修正

プロンプト:
ダイヤル錠で開けると、ダイヤル錠以外の箇所をタップすると引き出しが開きますが、ダイヤル錠をタップすると、またダイヤル錠のDETAILに遷移してしまいますので遷移しないように。

タップされた個々のコライダー(ダイヤル本体)ではなく、GIMMICK開始時に記録しておいた _gimmick_target(top_drawer本体)の is_locked を見て判定するよう変更しました。ダイヤル本体をタップした場合でも、解錠済みであればDETAILへ寄らず引き出しが開くようになっています。


9. 「OK」ボタンの追加と正解判定タイミングの変更

プロンプト:
ダイヤル錠の隣に「OK」というプリミティブなラベルボタンを追加。このボタンを押すとダイヤルの正解判定を行うように修正してください

プリミティブ形状+「OK」の Label3D で構成する scripts/dial_ok_button.gd を新規作成し、dial_lock.tscn に追加しました。dial_lock.gd を、ダイヤルの値が変わるたびに自動判定する方式から、OKボタン押下時にのみ判定する方式に変更しています。

ダイヤルを回すたびに自動判定すると、目的の数字を通過しただけで意図せず正解してしまうことがあります。「OK」ボタンを挟むことで、脱出ゲームの謎解きとして自然な操作感になります。

スクリーンショット 2026-07-16 8.40.15.png


10. 解錠時の引き出し自動オープン

プロンプト:
正解してGIMMICKに戻った時に引き出しを自動で開けてください

dial_lock.gd の正解判定処理内で、unlock() と同時に open_drawer() も呼び出すように変更しました。OKボタンで正解した瞬間に「解錠」「引き出しオープン」「カメラのGIMMICKへの復帰」がほぼ同時に発生するようになっています。


ダイヤル錠 最終仕様

top_drawer の中には、0〜9を表示する3つのプリミティブなダイヤル(Dial1〜Dial3)と「OK」ラベルボタンを設置しています。各ダイヤルはタップした位置(上半分/下半分)に応じて数字が+1/-1し、正面(±18°以内)の数字のみを表示することで、鏡文字・斜め歪みを避けています。正解の組み合わせは 9-2-4(Dial1-Dial2-Dial3)です。

状態遷移は NORMAL → GIMMICK → DETAIL の3段階です。top_drawer をタップするとGIMMICK(カメラが引き出しへズーム)になり、GIMMICK中に再タップするとDETAIL(カメラがダイヤルへさらに接近し、ダイヤル・OKボタンをタップ操作できる)になります。DETAIL中に「OK」ボタンをタップすると正解判定が実行され、正解(924)の場合は top_drawer のロック解除(is_locked = false)・引き出しの自動オープン・カメラのGIMMICKへの自動復帰が同時に発生します。

解錠後は、GIMMICK中に top_drawer(引き出し本体・ダイヤルのどちらをタップしても)をタップすると、DETAILへ移行せず引き出しが開きます。GIMMICKからNORMALへ戻ると、開いていた引き出しは自動的に閉まります。


成果物

引き出しに怪しいダイヤルが・・・
スクリーンショット 2026-07-16 8.42.10.png

ちょっと近づいてみましょう・・・
スクリーンショット 2026-07-16 8.42.52.png

なるほど・・・ダイヤルを正しく合わせるのですね・・・
(各ダイヤルをタップして数字を動かせます)
スクリーンショット 2026-07-16 8.43.42.png

「924」これに間違いないはず・・・「OK」を押しましょう
スクリーンショット 2026-07-16 8.44.46.png

開きました!
スクリーンショット 2026-07-16 8.46.08.png


まとめ

今回は、プリミティブな3連ダイヤル錠の新規作成から、表示バグ(数字のズレ・内部値との食い違い)の修正、正解判定と引き出しの開閉まで、ダイヤル錠ギミックの実装を一連のプロンプト単位で振り返りました。円柱+Label3Dの放射状配置だけで、3Dモデルなしのダイヤル演出が作れること、NORMAL → GIMMICK → DETAIL のように状態を段階的に増やすことでズーム→操作の流れを自然に表現できることが、今回のポイントでした。見た目の修正と内部状態(判定ロジック)の対応関係は都度突き合わせて確認する必要があり、自動判定ではなく「OK」ボタンを挟むことで意図しない誤解錠も防げます。


連載リンク

5
4
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
5
4

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?