RefCounted ou Node

Chaque objet occupe de la mémoire jusqu’à sa libération. RefCounted et Node sont libérés de différentes manières.

Un objet RefCounted compte les variables, les tableaux et les objets qui y font référence. Lorsque ce nombre tombe à zéro, Godot le libère de lui-même. NOTIFICATION_PREDELETE, dans le chapitre Méthodes spéciales, indique le moment :

# note.gd
class_name Note
extends RefCounted

func _notification(what: int) -> void:
	if what == NOTIFICATION_PREDELETE:
		print("Note freed")

# main.gd
func write() -> void:
	var note := Note.new()
	print("Note written")

func _ready():
	write()          # Note écrit, puis Note libéré
	print("Back in _ready")

note était la seule référence, donc la note est libérée dès que write() se termine.

Un Node n'est pas comptabilisé. Un nœud de l'arbre de scène est libéré avec son parent, et l'arbre entier est libéré lorsque le jeu se termine. Un nœud que tu retires de l'arbre, ou que tu n'y ajoutes jamais, doit être libéré par tes soins :

crate.free()         # libéré immédiatement, ainsi que tous ses enfants
crate.queue_free()   # libéré à la fin de la frame actuelle

Après free(), le nœud n’existe plus : is_instance_valid(crate) renvoie false, et appeler une méthode sur celui-ci provoque une erreur. queue_free() est le choix sûr lorsque d’autres portions de code peuvent encore utiliser le nœud pendant cette frame, mais jusqu’à la fin de celle-ci, le nœud reste dans l’arbre et est toujours comptabilisé par get_child_count().

Un nœud qui n’est jamais libéré constitue une fuite de mémoire : Godot signale « ObjectDB instances were leaked at exit » à la fin du programme. Les objets RefCounted fuient également lorsque deux d’entre eux se référencent mutuellement, car aucun des deux compteurs ne peut atteindre zéro. Stockez le lien dans un seul sens, ou stockez un nom plutôt que l’objet.

Utilisez RefCounted pour les données : objets, scores, enregistrements. Utilisez Node pour les éléments qui vivent dans l’arbre de scène.