概要
Godotで開発を進めていると、ノード同士が連携する必要が出てきます。「プレイヤーがコインに触れたら、コインは消え、UIのスコアが上がる」といった場面です。初心者がやりがちなのは、プレイヤーのスクリプトからコインやUIのノードを直接参照（get_node()や$を使う）してしまうことです。
# 悪い例：プレイヤーがUIやサウンドマネージャーを直接知っている
func _on_area_entered(area):
if area.is_in_group("enemy_attack"):
get_node("/root/Game/UI/HealthBar").update_health(health)
get_node("/root/Game/SoundManager").play_sfx("player_hurt")
このような密結合な設計は、シーン構造の変更に非常に弱く、ノードの再利用を妨げ、デバッグを困難にします。この問題を解決し、ノード同士を「疎結合」に保つためのGodotの根幹的な仕組みがシグナル (Signals) です。
シグナルとは？「イベントが発生したよ！」という放送
シグナルとは、あるノードが「特定のイベントが発生した」ことを、他のノードに放送するための仕組みです。シグナルを発信 する側（Emitter）は、誰がその放送を聞いているかを知る必要はありません。ただ「プレイヤーがダメージを受けたぞ！」と叫ぶだけです。
一方、その放送に関心のあるノード（Receiver）は、特定のシグナルを「購読（Connect）」しておきます。これにより、シグナルが発信されたときに、自身の特定のメソッド（Callback）が自動的に呼び出されます。
この放送局とリスナーのような関係により、EmitterとReceiverは直接お互いを知らなくても連携できます。これが「関心の分離」として知られる、優れたソフトウェア設計の基本原則です。
シグナルの使い方
シグナルを接続するには、主に「エディタ経由」と「コード経由」の2つの方法があります。
1. エディタでの接続（最も簡単）
視覚的で最も簡単な方法です。Buttonノードが押された時に処理を実行する例で見てみましょう。
- シグナルを発信するノードを選択: シーンツリーで
Buttonノードを選択します。 - 「ノード」タブを開く: インスペクタの隣にある「ノード」タブを開き、その中の「シグナル」タブを選択します。
Buttonが持つpressed()などの組み込みシグナルの一覧が表示されます。 - シグナルを接続:
pressed()シグナルをダブルクリック（または選択して「接続」ボタン を押す）します。 - 受信者とメソッドを選択: 「シグナルを接続」ダイアログが開きます。ここで、シグナルを受け取るノードを選択し、呼び出されるメソッド名を決定します。「接続」ボタンを押せば完了です。
これにより、受信側ノードのスクリプトに、指定した名前のメソッドが自動的に生成されます。
# Receiver側のスクリプトに自動生成される
func _on_button_pressed():
print("ボタンが押されました！")
# ここに実行したい処理を書く
2. コード（GDScript）での接続
動的にノードを生成した場合など、コードで接続する必要がある場面も多くあります。connect()メソッドを使用します。
# Player.gd
func _ready():
var hud = get_node("/root/Game/UI/HUD")
health_changed.connect(hud._on_player_health_changed)
Godot 4では、Callable を使うことで、メソッドが存在しない場合にエディタがエラーを検出してくれるため、より安全になりました。
実践：カスタムシグナルでコンポーネントを連携させる
組み込みシグナルだけでなく、自分で独自のシグナルを定義することが、シグナルの真価を発揮する鍵です。プレイヤーがダメージを受けるシナリオを、実践的にリファクタリングしてみましょう。
Player.gd（Emitter側）
signalキーワードでカスタムシグナルを 宣言し、体力が変化したタイミングでemit()を使って発信します。
extends CharacterBody2D
# 体力が変化したことを通知するシグナル
signal health_changed(current_health, max_health)
# 死亡したことを通知するシグナル
signal died
@export var max_health: int = 100
var current_health: int
func _ready():
current_health = max_health
func take_damage(amount: int):
current_health = max(0, current_health - amount)
health_changed.emit(current_health, max_health)
if current_health <= 0:
died.emit()
queue_free()
HUD.gd（Receiver側）
プレイヤーのhealth_changedシグナルを購読し、UI表示を更新します。
extends CanvasLayer
@onready var health_bar: TextureProgressBar = $HealthBar
func _on_player_health_changed(current_health, max_health):
health_bar.max_value = max_health
health_bar.value = current_health
GameManager.gd（もう一つのReceiver）
プレイヤーのdiedシグナルを購読し、ゲームオーバー処理を行います。
extends Node
func _on_player_died():
print("プレイヤーが死亡しました。ゲームオーバー画面に遷移します。")
get_tree().change_scene_to_file("res://game_over_screen.tscn")
このように、Playerは自身の状態変化を放送するだけで、UIやゲームマネージャーはそれを聞いて自身の役割を果たすだけです。
よくある間違いとベストプラクテ ィス
| よくある間違い | ベストプラクティス |
|---|---|
| 何でもシグナルで繋ぐ | 関心の分離を意識する。 親が子を直接制御するような、密接な関係の場合は直接メソッドを呼ぶ方が自然な場合も多い。 |
| シグナルを接続解除し忘れる | シグナル発信側（Emitter）がqueue_free()で削除される場合は自動切断される。しかし、受信側（Receiver）が先に削除される場合や、動的に接続を解除したい場合は手動でdisconnect()が必要（下記コード例参照）。 |
| 引数にノード参照を渡す | 引数にはID、数値、文字列などのデータのみを渡し、受信側がノード参照を必要とする場合は、IDから検索させるなどして疎結合を維持する。 |
| シグナル名のタイポ | Godot 4のCallable や await構文を使うと、コンパイル時にエラーを検出でき、タイプミスを防げる。 |
| グローバルなイベントに使う | ゲーム全体に関わるイベント（例：ゲームポーズ）は、シングルトン（Autoload）にシグナルを持たせる「イベントバス」パターンの方が管理しやすい。 |
シグナルの接続解除（disconnect）の例
# 動的にシグナルを接続・解除する例
var callback: Callable
func _ready():
callback = _on_player_health_changed
player.health_changed.connect(callback)
func _exit_tree():
# ノードがシーンツリーから削除さ れる前に接続を解除
if player and player.health_changed.is_connected(callback):
player.health_changed.disconnect(callback)
func _on_player_health_changed(current_health, max_health):
# 処理...
pass
パフォーマンスと代替パターン
-
パフォーマンス: シグナルの呼び出しは、直接の関数呼び出しに比べてわずかなオーバーヘッドがあります。しかし、これは内部で
Callableのリストをループ処理するためであり、ほとんどのゲームにおいて、この差がボトルネックになることはまずありません。設計の明快さと保守性の向上というメリットは、このわずかなコストをはるかに上回ります。 -
代替パターン（イベントバス）: シングルトン（Autoloadで実装）にシグナルを集中させ、グローバルな「イベントバス」として機能させる方法も強力です。これにより、シーンツリーのどこからでもイベントを送受信でき、完全に独立したシステム間の通信が可能になります。
まとめ
シグナルは、Godotにおけるノード間連携の最もクリーンで推奨される方法です。
- 発信する側: 「イベントが起きた」と叫ぶだけ。誰が聞いているかは気にしない
- 受信する側: 聞きたい合図を登録しておき、呼ばれたら自分の仕事をするだけ
この疎結合な関係を意識してコンポーネントを設計することで、シーンの再利用性が高まり、バグが少 なく、変更に強いプロジェクトを構築できます。get_node()で親や兄弟を直接参照するコードを書いてしまったら、「これはシグナルで実現できないか？」と一度立ち止まって考えてみる癖をつけることが、Godotマスターへの第一歩です。