Declarando e emitindo

Declare um sinal com a palavra-chave signal e um nome, no início da classe, junto às variáveis. O nome de um sinal descreve um evento que já aconteceu, em snake_case: died, door_opened, leveled_up. Uma classe declara quantos sinais forem necessários:

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

Emita um sinal no momento em que o evento acontece, e somente então. add_xp(50) em um jogador novo não emite nada. add_xp(250) depois faz xp chegar a 300: leveled_up é emitido duas vezes, uma vez por nível ganho, e max_level_reached uma vez, ao subir de nível e chegar ao nível 3.

Um setter de propriedade é um bom lugar para emitir, porque o sinal então é disparado por qualquer código que altere o 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 impede que died seja emitido novamente quando um herói com 0 HP é atingido mais uma vez.

Um sinal também pode ser acessado pelo nome como texto: emit_signal("died") o emite, hero.connect("died", _on_hero_died) conecta-se a ele, e hero.has_signal("died") retorna true. Conectar-se a um nome que o objeto não declara é um erro quando essa linha é executada.