Declarar y emitir

Declara una señal con la palabra clave signal y un nombre, en la parte superior de la clase junto a sus variables. El nombre de una señal describe un evento que ya ocurrió, en snake_case: died, door_opened, leveled_up. Una clase declara tantas señales como necesite:

# 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()

Emite una señal en el momento en que ocurre su evento, y solo entonces. add_xp(50) en un jugador nuevo no emite nada. add_xp(250) después de que lleva xp a 300: leveled_up se emite dos veces, una por cada nivel obtenido, y max_level_reached una vez, al subir de nivel y alcanzar el nivel 3.

Un setter de propiedad es un buen lugar para emitir la señal, porque así se activa cuando cualquier código cambia el valor:

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 evita que se vuelva a emitir died cuando un héroe con 0 HP recibe otro golpe.

También se puede acceder a una señal mediante su nombre como texto: emit_signal("died") la emite, hero.connect("died", _on_hero_died) se conecta a ella y hero.has_signal("died") devuelve true. Conectarse a un nombre que el objeto no declara es un error cuando se ejecuta esa línea.