本文へスキップ
Godot基礎

GodotのSignalとは?初心者向けにやさしく解説

Godot の Signal を初心者向けに解説。ボタンやイベント処理でよく使う考え方を、最初の理解に絞って整理します。

公開日: 2026-05-28#Godot#Signal#初心者
ガイドキャラクター
Godot 4のButtonのpressedシグナルを受け取り、Labelを書き換えます。入力イベントを直接読む例とは区別します。
学習者キャラクター
準備するものと、動作確認で見る結果を先に確認してから進めます。
GodotのSignalとは?初心者向けにやさしく解説の手順と判断条件を示す説明図
仕組みを説明する模式図です。エディタのスクリーンショットではありません。小さい画面では横にスクロールできます。設定値と手順は本文で確認してください。

導入

Godot 4のButtonのpressedシグナルを受け取り、Labelを書き換えます。入力イベントを直接読む例とは区別します。

準備

Controlをルートにし、子にButtonノードとLabelノードを置きます。Labelの名前をStatusLabelにします。ButtonのTextを「クリック」、Positionを(40, 40)、Sizeを(160, 48)にし、StatusLabelのPositionを(40, 110)にして重ならないようにします。ルートへ次のスクリプトを付けます。この例はコードで接続するので、同じシグナルをエディタでも二重接続しないでください。

完成版

extends Control
@onready var button: Button = $Button
@onready var status_label: Label = $StatusLabel
var count := 0

func _ready() -> void:
    button.pressed.connect(_on_button_pressed)

func _on_button_pressed() -> void:
    count += 1
    status_label.text = "押した回数: %d" % count

動作確認

Buttonを1回押すと回数が1増えます。シグナルは出来事の通知、接続先の関数はそれを受けて行う処理です。

まとめ

pressedをconnectで受け取り、受け手の関数でUIを更新します。

学習者キャラクター
今回の内容で覚えておくポイントを確認したいです。
ガイドキャラクター
pressedをconnectで受け取り、受け手の関数でUIを更新します。
この記事のまとめを案内するガイドキャラクター

この記事のまとめ

Godot の Signal を初心者向けに解説。ボタンやイベント処理でよく使う考え方を、最初の理解に絞って整理します。