Pattern Singleton

Il pattern Singleton assicura che una classe abbia esattamente un oggetto e offre a ogni script un unico modo per raggiungerlo. Usalo per gli elementi di cui un gioco ha un solo esemplare: le impostazioni, il sistema di salvataggio, il gestore del punteggio.

In GDScript, una static var contiene l'unico oggetto e una static func lo crea la prima volta che qualcuno lo richiede:

# game_settings.gd
class_name GameSettings
extends RefCounted

static var _instance: GameSettings = null

var volume := 50

static func get_instance() -> GameSettings:
	if _instance == null:
		_instance = GameSettings.new()
		print("Creating settings")
	return _instance

_instance appartiene alla classe, non a un oggetto, quindi ogni script vede la stessa variabile. La prima chiamata la trova vuota e crea l’oggetto; ogni chiamata successiva restituisce lo stesso oggetto.

# main.gd
var a := GameSettings.get_instance()
var b := GameSettings.get_instance()
a.volume = 80
print(b.volume)
print(a == b)

Creating settings
80
true

a e b sono due variabili che contengono un unico oggetto, quindi la modifica apportata tramite a è visibile anche tramite b. Per gli oggetti, == è true solo quando entrambi i lati fanno riferimento allo stesso oggetto.

GDScript non può rendere privato _init(), quindi niente impedisce a uno script di chiamare GameSettings.new() e ottenere un secondo oggetto. Il trattino basso in _instance e il metodo get_instance() sono l’accordo: gli script chiedono l’oggetto, non lo creano mai.

In un progetto Godot, il modo più comune per ottenere un oggetto condiviso è un autoload: uno script che registri nelle Impostazioni del progetto, che Godot crea una sola volta all'avvio del gioco e rende disponibile per nome in ogni script. È un Singleton che Godot gestisce per te. Gli autoload si configurano nell'editor, quindi le sfide qui costruiscono questo schema nel codice con static var.