Объявление и отправка

Объяви сигнал с помощью ключевого слова signal и укажи его имя в начале класса рядом с переменными. Имя сигнала описывает уже произошедшее событие и записывается в формате snake_case: died, door_opened, leveled_up. В классе можно объявить столько сигналов, сколько нужно:

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

Отправляй сигнал в момент наступления события и только тогда. add_xp(50) для нового игрока ничего не отправляет. add_xp(250) после этого доводит xp до 300: сигнал leveled_up отправляется дважды, по одному разу за каждый полученный уровень, а max_level_reached — один раз, при повышении уровня до 3.

Сеттер свойства — хорошее место для вызова сигнала, потому что тогда сигнал срабатывает при любом изменении значения:

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 не позволяет событию died сработать повторно, когда героя с 0 HP снова поражают.

К сигналу также можно обратиться по его имени в виде текста: emit_signal("died") отправляет его, hero.connect("died", _on_hero_died) подключается к нему, а hero.has_signal("died") возвращает true. Подключение к имени, которое объект не объявляет, приводит к ошибке при выполнении этой строки.