Mẫu Singleton

Mẫu Singleton đảm bảo một lớp chỉ có đúng một đối tượng và cung cấp cho mọi tập lệnh một cách để truy cập đối tượng đó. Hãy dùng mẫu này cho những thứ mà trò chơi chỉ có một, chẳng hạn như phần cài đặt, hệ thống lưu và bộ quản lý điểm.

Trong GDScript, một static var giữ đối tượng duy nhất, còn static func tạo đối tượng đó vào lần đầu tiên có người yêu cầu:

# 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 thuộc về lớp, không phải đối tượng, nên mọi script đều thấy cùng một biến. Lần gọi đầu tiên thấy biến này đang trống và tạo đối tượng; mọi lần gọi sau đều trả về chính đối tượng đó.

# 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 và b là hai biến cùng tham chiếu đến một đối tượng, vì vậy thay đổi thực hiện thông qua a cũng thể hiện qua b. Với các đối tượng, == chỉ là true khi cả hai vế đều là cùng một đối tượng.

GDScript không thể đặt _init() ở chế độ riêng tư, nên không có gì ngăn một script gọi GameSettings.new() và tạo ra đối tượng thứ hai. Dấu gạch dưới trong _instance và phương thức get_instance() thể hiện quy ước: các script yêu cầu lấy đối tượng, chứ không tự tạo đối tượng.

Trong một dự án Godot, cách thông thường để dùng chung một đối tượng là tạo autoload: một tập lệnh mà bạn đăng ký trong Project Settings. Godot tạo đối tượng này một lần khi trò chơi bắt đầu và cho phép mọi tập lệnh truy cập đối tượng đó bằng tên. Đây là Singleton do Godot quản lý thay bạn. Bạn thiết lập autoload trong trình chỉnh sửa, vì vậy các thử thách ở đây sẽ xây dựng mẫu này bằng code với static var.