Singleton-Muster

Das Singleton-Muster stellt sicher, dass eine Klasse genau ein Objekt hat, und bietet jedem Skript eine Möglichkeit, darauf zuzugreifen. Verwende es für Dinge, von denen es in einem Spiel nur eines gibt: die Einstellungen, das Speichersystem, die Punkteverwaltung.

In GDScript enthält eine static var das einzelne Objekt, und eine static func erstellt es, wenn zum ersten Mal danach gefragt wird:

# 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 gehört zur Klasse, nicht zu einem Objekt, daher sieht jedes Skript dieselbe Variable. Beim ersten Aufruf ist sie leer und das Objekt wird erstellt; jeder spätere Aufruf gibt dasselbe Objekt zurück.

# 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 und b sind zwei Variablen, die dasselbe Objekt enthalten, daher ist die über a vorgenommene Änderung auch über b sichtbar. Bei Objekten ist == nur dann true, wenn beide Seiten dasselbe Objekt sind.

GDScript kann _init() nicht privat machen, daher hindert nichts ein Skript daran, GameSettings.new() aufzurufen und ein zweites Objekt zu erhalten. Der Unterstrich in _instance und die Methode get_instance() bilden die Vereinbarung: Skripte fragen nach dem Objekt, sie erstellen es niemals selbst.

In einem Godot-Projekt erhält man ein gemeinsam genutztes Objekt üblicherweise über einen Autoload: ein Skript, das du in den Projekteinstellungen registrierst und das Godot beim Start des Spiels einmal erstellt und in jedem Skript unter seinem Namen verfügbar macht. Es ist ein Singleton, das Godot für dich verwaltet. Autoloads werden im Editor eingerichtet, daher bauen die Herausforderungen hier das Muster mit static var im Code nach.