Deklarieren und Auslösen

Definiere ein Signal mit dem Schlüsselwort signal und einem Namen oben in der Klasse neben ihren Variablen. Ein Signalname beschreibt ein Ereignis, das bereits stattgefunden hat, in snake_case: died, door_opened, leveled_up. Eine Klasse definiert so viele Signale, wie sie benötigt:

# player.gd
class_name Player
extends RefCounted

signal leveled_up
signal max_level_reached

const MAX_LEVEL := 3
var level := 1
var xp := 0

func add_xp(amount: int) -> void:
	xp += amount
	while xp >= 100 and level < MAX_LEVEL:
		xp -= 100
		level += 1
		leveled_up.emit()
		if level == MAX_LEVEL:
			max_level_reached.emit()

Ein Signal wird genau in dem Moment ausgelöst, in dem sein Ereignis eintritt, und nur dann. add_xp(50) löst bei einem neuen Spieler nichts aus. add_xp(250) bringt xp auf 300: leveled_up wird zweimal ausgelöst, einmal pro erreichtem Level, und max_level_reached einmal, beim Levelaufstieg auf Level 3.

Ein Property-Setter eignet sich gut zum Auslösen, da das Signal dann ausgelöst wird, wenn der Wert durch Code geändert wird:

signal died

var hp: int = 10:
	set(value):
		var was_alive := hp > 0
		hp = maxi(value, 0)
		if was_alive and hp == 0:
			died.emit()

was_alive verhindert, dass died erneut ausgegeben wird, wenn ein Held mit 0 HP noch einmal getroffen wird.

Ein Signal kann auch über seinen Namen als Text angesprochen werden: emit_signal("died") löst es aus, hero.connect("died", _on_hero_died) verbindet sich damit, und hero.has_signal("died") gibt true zurück. Eine Verbindung zu einem Namen, den das Objekt nicht deklariert, ist ein Fehler, wenn diese Zeile ausgeführt wird.