Conectando-se a sinais

connect() recebe a função a ser executada como um Callable. Nomeie um método sem parênteses ou escreva uma lambda:

chest.opened.connect(_on_chest_opened)          # um método deste script
chest.opened.connect(quest_log.add_entry)       # um método de outro objeto
chest.opened.connect(func(): print("Creak!"))   # uma lambda

Godot nomeia um método ouvinte com _on_, depois o emissor e, em seguida, o sinal: _on_chest_opened. Um sinal pode ter muitas funções conectadas, e elas são executadas na ordem em que foram conectadas.

Um objeto que escuta geralmente se conecta, em um método que recebe o emissor:

# 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

Conectar a mesma função ao mesmo sinal duas vezes é um erro, assim como desconectar uma função que não está conectada. is_connected() verifica primeiro. disconnect() para de escutar, e a próxima emissão não executa mais essa função.

Passe CONNECT_ONE_SHOT como segundo argumento, e a conexão se remove após sua primeira chamada: chest.opened.connect(_on_first_open, CONNECT_ONE_SHOT).

Uma lambda mantém o valor que uma variável local tinha quando a lambda foi criada. count += 1 dentro de uma lambda conectada altera essa cópia, e count em _ready() continua sendo 0. Mantenha um contador em uma variável membro de um objeto ouvinte, como faz QuestLog.