はじめに
Godot 4.x+Claude Code+MCPでスマホ横向き向けFPS視点の3D脱出ゲームを作る連載の第7回です。
前回までの記事はこちらです。
- 環境構築とプロジェクト作成
- 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脱出ゲームを作ってみる⑤〜ダイヤル錠ギミックの状態をローカルストレージに保存する〜
- 【Godot 4.x】3D脱出ゲームを作ってみる⑥〜アイテム取得・所持インベントリの実装〜(前回)
今回は、これまで実装してきたギミックに効果音(SE)とBGMを組み込みます。あらかじめ assets/sounds に配置しておいたmp3素材を、時計のループ音・ダイヤル操作音・引き出しの開閉音・アイテム取得音・メインシーンBGMという形で、既存のギミックスクリプトに1つずつ埋め込んでいきました。Claude Codeとのやり取りをプロンプト単位で振り返る形式でまとめます。
この記事でやること
AudioStreamPlayer3D によるループ環境音(壁掛け時計)を実装し、ダイヤル操作・引き出し開閉・アイテム取得の単発SEを組み込みます。AudioStreamPlayer によるメインシーンBGMも設置し、ループ再生を実行時に強制する共通パターンも実装します。
想定環境
| 項目 | 内容 |
|---|---|
| OS | macOS(Apple Silicon) |
| Godot | 4.7 stable |
| Claude Code | 最新版 |
| godot-mcp | セットアップ済み |
| 解像度 | 1870×840(横向き) |
1. 音声素材フォルダの記憶
BGMは魔王魂様から頂戴いたしました。
効果音は下記サイトから頂戴いたしました。
プロンプト:
assets/soundsフォルダを作成して、BGMや効果音を配置しましたので、覚えておいてください
assets/sounds にBGM(bgm_game.mp3)とSE5種(se_clock.mp3、se_dial.mp3、se_get_item.mp3、se_drawer.mp3, se_clock.mp3)が配置済みであることを、ファイル名と想定用途の対応込みで記録しました。以降のセッションで音を実装する際、まずこの一覧から既存ファイルを探すようにしています。
使用予定の音声ファイル一覧をあらかじめ共有しておくと、実装のたびに「この効果音のファイルはどれですか」と聞き返される手間がなくなり、やり取りがスムーズになります。
2. 壁掛け時計のループ再生(3Dサウンド)
せっかくの3Dですので、離れれば音が小さく、近寄れば音が大きくなるように、3D用のプレイヤーを使用するように指示しました。
プロンプト:
時計にse_clock.mp3を埋め込んでループで再生してください。3D用のサウンドで。
AudioStreamPlayer3D を継承する scripts/looping_sound_3d.gd を新規作成しました。_ready() でストリームの loop プロパティを true に設定してから play() する、という単純な仕組みです。
mp3のインポート設定(.importファイルのloopチェック)はデフォルトfalseで、再インポートしないと変更が反映されません。それに依存せず実行時に強制ループさせる方式にしておくと、素材を追加するたびにインポート設定を気にしなくて済みます。
壁掛け時計のプレハブ wall_clock.tscn に AudioStreamPlayer3D ノードを追加し、stream に se_clock.mp3、script にこのループ再生スクリプトを設定しました。
# scripts/looping_sound_3d.gd
extends AudioStreamPlayer3D
func _ready():
if stream:
stream.loop = true
play()
3. ダイヤル操作音
プロンプト:
ダイヤルを回した時、se_dial.mp3を鳴らしてください
ダイヤル錠の各桁は scripts/dial_digit.gd がプリミティブ形状から自前構築しているため、.tscn を直接編集するのではなく _build_sound_player() というメソッドを追加し、_ready() 内で AudioStreamPlayer3D を動的に生成する形にしました。数字が1コマ進む _step(direction) が呼ばれるたびに play() します。Dial1〜Dial3はそれぞれ独立したインスタンスなので、ダイヤルごとに個別の音源を持ちます。
④でダイヤルの見た目自体をコードで動的生成していたため、サウンド再生ノードも同じ流れで動的生成する方針に揃えています。シーンファイルを直接編集する箇所と、スクリプトで完結させる箇所が混在しないようにする意図です。
4. ダイヤル錠正解時の効果音(後に取り消し)
プロンプト:
ダイヤル錠を正解したら、se_success.mp3を鳴らしてください
scripts/dial_lock.gd に SUCCESS_SOUND 定数と AudioStreamPlayer3D を追加し、正解の組み合わせが揃って _is_solved = true になった直後(_on_ok_pressed() 内)に再生するようにしました。保存データから解錠済み状態を復元する _load_state() 側は経由しないため、ロード時には鳴らない設計にしています。
5. 正解音の取り消しと、引き出し開閉音への差し替え
プロンプト:
se_success.mp3の再生は取り消して、引き出しが開いた時、閉じた時、se_drawer.mp3を鳴らしてください
前項で dial_lock.gd に追加した SUCCESS_SOUND ・ AudioStreamPlayer3D ・再生呼び出しをすべて削除しました。代わりに引き出しの開閉ロジックを持つ scripts/top_drawer.gd に DRAWER_SOUND(se_drawer.mp3)と AudioStreamPlayer3D を追加し、open_drawer() と close_drawer() それぞれの冒頭で play() するようにしています。同じ音を「開く」「閉じる」の両方に使う仕様です。
一度実装した演出を途中で差し替えるのも実装ではよくあることです。正解音を鳴らす案から、引き出しの開閉に合わせた効果音に変更することで、「正解した」という一度きりの演出よりも「引き出しというモノを操作している」感触を優先した形になっています。
6. アイテム取得音
プロンプト:
アイテムを取得した時、se_get_item.mp3を鳴らしてください
scripts/item_pickup.gd に GET_ITEM_SOUND(se_get_item.mp3)と AudioStreamPlayer3D を追加しました。on_tapped() 内で GameState.add_item() を呼んだ直後、アイテムを非表示にする _set_collected(true) より前に play() します。
visible = false は描画にのみ影響し音声再生は止まらないため、アイテムが消えた後も取得音は最後まで鳴り続けます。保存データ復元時に呼ばれる非表示化はこの再生の経路を通らないため、ロード時には鳴りません。
7. メインシーンBGM
プロンプト:
メインシーンでbgm_game.mp3を音量0.5でループして再生してください
3Dの各SEとは別に、非空間音源用の scripts/looping_sound.gd(AudioStreamPlayer 版、ロジックは3D版と同じ)を新規作成しました。scenes/main.tscn に AudioStreamPlayer ノード「BGM」を追加し、stream に bgm_game.mp3、script にループ再生スクリプト、volume_linear = 0.5(線形音量0.5、約-6dB相当)を設定しています。
# scripts/looping_sound.gd
extends AudioStreamPlayer
func _ready():
if stream:
stream.loop = true
play()
効果音・BGM 最終仕様
壁掛け時計(wall_clock.tscn)は se_clock.mp3 を AudioStreamPlayer3D でループ再生し続ける環境音です。ダイヤル錠の各桁(dial_digit.gd)は1コマ回すたびに se_dial.mp3 を単発再生し、引き出し(top_drawer.gd)は開いた瞬間・閉じた瞬間の両方で se_drawer.mp3 を単発再生します。アイテム取得(item_pickup.gd)はタップして取得した瞬間に se_get_item.mp3 を単発再生し、メインシーン(main.tscn)では bgm_game.mp3 を音量0.5でループ再生し続けます。
ループ再生が必要な音(時計・BGM)は、mp3インポート設定のloopフラグに頼らず、_ready() でストリームの loop プロパティを実行時に true へ上書きしてから play() する共通パターン(looping_sound_3d.gd / looping_sound.gd)で統一しました。単発のSE(ダイヤル・引き出し・アイテム取得)は、対象オブジェクトの _ready() で AudioStreamPlayer3D を1つ用意しておき、該当アクションが起きた関数の中で play() を呼ぶだけの最小構成にしています。
成果物
前半:3D用のプレイヤーの使用で、時計の秒針の音が離れれば小さく、近寄れば大きくなります
後半:ダイヤルを回す、引き出しを開ける、アイテムを取得する、の各ステップで効果音が鳴ります
まとめ
今回は、音声素材フォルダの記憶から始まり、壁掛け時計の環境音、ダイヤル操作音、引き出しの開閉音、アイテム取得音、メインシーンBGMまで、効果音・BGM実装を一連のプロンプト単位で振り返りました。正解音のように一度実装してから取り消すケースもあり、プロンプトの指示に応じてその場で機能を足し引きする流れも記録に残しています。
ループ音はmp3のインポート設定に頼らず、実行時に loop = true を強制する共通スクリプトで統一するのがポイントでした。動的生成しているオブジェクト(ダイヤルなど)には、サウンド再生ノードも同じ流れで動的生成すると実装の一貫性が保てます。visible = false は音声を止めないため、演出として鳴らし切りたい音は非表示化のタイミングより前に再生する必要があり、一度実装した演出でも手触りを見ながら途中で差し替えるのは自然な進め方です。
連載リンク