Mit Signalen verbinden

connect() erwartet als Callable die auszuführende Funktion. Gib den Namen einer Methode ohne Klammern an oder schreibe eine Lambda-Funktion:

chest.opened.connect(_on_chest_opened)          # eine Methode dieses Skripts
chest.opened.connect(quest_log.add_entry)       # eine Methode eines anderen Objekts
chest.opened.connect(func(): print("Creak!"))   # ein Lambda-Ausdruck

Godot benennt eine empfangende Methode mit _on_, dann dem Auslöser und anschließend dem Signal: _on_chest_opened. Ein Signal kann mit mehreren Funktionen verbunden sein, die in der Reihenfolge ausgeführt werden, in der sie verbunden wurden.

Ein Objekt, das auf ein Signal wartet, verbindet sich normalerweise selbst in einer Methode, die den Sender entgegennimmt:

# quest_log.gd
class_name QuestLog
extends RefCounted

var chests_opened := 0

func track(chest: Chest) -> void:
	if not chest.opened.is_connected(_on_chest_opened):
		chest.opened.connect(_on_chest_opened)

func untrack(chest: Chest) -> void:
	if chest.opened.is_connected(_on_chest_opened):
		chest.opened.disconnect(_on_chest_opened)

func _on_chest_opened() -> void:
	chests_opened += 1

Dieselbe Funktion zweimal mit demselben Signal zu verbinden, ist ein Fehler, ebenso wie das Trennen einer Funktion, die nicht verbunden ist. is_connected() prüft dies zuerst. disconnect() beendet das Lauschen, und beim nächsten Auslösen wird diese Funktion nicht mehr ausgeführt.

Übergib CONNECT_ONE_SHOT als zweites Argument, und die Verbindung entfernt sich nach ihrem ersten Aufruf selbst: chest.opened.connect(_on_first_open, CONNECT_ONE_SHOT).

Eine Lambda-Funktion behält den Wert, den eine lokale Variable hatte, als die Lambda-Funktion erstellt wurde. count += 1 innerhalb einer verbundenen Lambda-Funktion ändert diese Kopie, und count in _ready() bleibt 0. Führe einen Zähler in einer Member-Variable eines Listener-Objekts, wie es QuestLog tut.