Dichiarare ed emettere

Dichiara un segnale con la parola chiave signal e un nome, all’inizio della classe accanto alle sue variabili. Il nome di un segnale descrive un evento già accaduto, in snake_case: died, door_opened, leveled_up. Una classe dichiara tutti i segnali di cui ha bisogno:

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

Emetti un segnale nel momento in cui si verifica il relativo evento, e solo allora. add_xp(50) su un nuovo giocatore non emette nulla. add_xp(250) dopo aver portato xp a 300: leveled_up viene emesso due volte, una per ogni livello guadagnato, e max_level_reached una volta, quando si sale al livello 3.

Un setter di proprietà è un buon posto in cui emettere il segnale, perché il segnale viene attivato da qualsiasi codice modifichi il valore:

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 impedisce che died venga emesso di nuovo quando un eroe con 0 HP viene colpito ancora una volta.

È possibile accedere a un segnale anche tramite il suo nome come testo: emit_signal("died") lo emette, hero.connect("died", _on_hero_died) vi si collega e hero.has_signal("died") restituisce true. Collegarsi a un nome che l'oggetto non dichiara genera un errore quando viene eseguita quella riga.