Padrão Singleton

O padrão Singleton garante que uma classe tenha exatamente um objeto e oferece a cada script uma maneira de acessá-lo. Use-o para coisas das quais um jogo tem apenas uma: as configurações, o sistema de salvamento, o gerenciador de pontuação.

No GDScript, uma static var mantém o objeto único, e uma static func o cria na primeira vez que alguém o solicita:

# 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 pertence à classe, não a um objeto, então todos os scripts veem a mesma variável. A primeira chamada a encontra vazia e cria o objeto; todas as chamadas posteriores retornam esse mesmo objeto.

# 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 são duas variáveis que contêm um objeto, então a alteração feita por meio de a também aparece em b. Para objetos, == é true somente quando os dois lados são o mesmo objeto.

GDScript não pode tornar _init() privado, então nada impede que um script chame GameSettings.new() e obtenha um segundo objeto. O sublinhado em _instance e o método get_instance() são o acordo: os scripts solicitam o objeto, nunca o criam.

Em um projeto Godot, a maneira usual de obter um objeto compartilhado é por meio de um autoload: um script que você registra nas Configurações do Projeto, que o Godot cria uma vez quando o jogo inicia e disponibiliza pelo nome em todos os scripts. Ele é um Singleton gerenciado pelo Godot para você. Os autoloads são configurados no editor, então os desafios aqui criam o padrão em código com static var.