Signale mit Argumenten

Ein Signal kann Werte übertragen. Liste sie in der Deklaration auf, wie die Parameter einer Funktion:

signal damaged(amount: int, hp_left: int)
signal died

Übergib die Werte in derselben Reihenfolge an emit():

func take_damage(amount: int) -> void:
	hp = maxi(hp - amount, 0)
	damaged.emit(amount, hp)
	if hp == 0:
		died.emit()

Eine verbundene Funktion erhält die Werte als Parameter und benötigt daher einen Parameter pro Wert:

hero.damaged.connect(_on_hero_damaged)

func _on_hero_damaged(amount: int, hp_left: int) -> void:
	print("-%d HP, %d left" % [amount, hp_left])

Die Typen in der Deklaration dokumentieren die Werte: GDScript prüft sie beim Auslösen nicht. Eine Typabweichung zeigt sich in der empfangenden Funktion. Eine Funktion mit der falschen Anzahl von Parametern oder einem typisierten Parameter, der den Wert nicht aufnehmen kann, verursacht einen Fehler an der Zeile mit emit(), und die Funktion wird nicht ausgeführt.

bind() fügt nach den ausgegebenen Werten eigene Werte hinzu. Eine Methode kann dann mehreren Helden zuhören und trotzdem wissen, welcher getroffen wurde:

ada.damaged.connect(_on_damaged.bind("Ada"))
bo.damaged.connect(_on_damaged.bind("Bo"))

func _on_damaged(amount: int, hp_left: int, who: String) -> void:
	print(who, " lost ", amount, " HP")

Argumente liefern einem Listener die benötigten Daten, sodass er sie nicht vom Emitter auslesen muss. Verbinde niemals eine Lambda-Funktion, die das auslösende Objekt selbst verwendet, zum Beispiel hero.died.connect(func(): print(hero.hp)): Die Lambda-Funktion hält hero am Leben, hero hält die Lambda-Funktion, keines von beiden wird jemals freigegeben, und Godot meldet beim Beenden des Programms Speicherlecks.