游戏引擎 / 系统课时
用 Autoload 保存全局状态
用 Autoload 保存全局状态
本课解决更换场景后分数和关卡信息丢失的问题。你将创建并注册 GameState Autoload,在三维关卡中加分并通知界面,再切换到结算场景读取相同数据,最后验证重新开始时如何重置状态。
学习目标
- 理解 Autoload 与普通场景节点在生命周期上的区别。
- 注册共享状态节点,使用方法和信号更新分数。
- 验证跨场景读取、重新开始以及重启程序后的数据表现。
Autoload 为什么不会随关卡消失
普通关卡的 Node3D、HUD、玩家脚本都属于当前场景。通过 SceneTree.change_scene_to_file() 切换场景时,这些节点会被释放,放在关卡脚本里的分数变量也会丢失。Autoload 不属于被替换的主场景,它在游戏启动时作为根视口的子节点创建,之后一直存在。

这只能保证本次游戏运行期间的数据共享,并不等于写入磁盘。退出游戏后重新打开,成员变量会重新初始化;需要长期保留的存档仍应写入 user://。Autoload 也不是真正禁止重复实例化的单例,应把它视为由项目统一注册和使用的常驻节点。
注册并封装全局数据
先创建 res://scripts/game_state.gd。在 Godot 4 里打开“项目 → 项目设置 → Globals → Autoload”(部分版本直接显示“Autoload”标签),选择这个脚本,填写名称 GameState,点击添加并确认启用。名称必须与代码中使用的 GameState 完全一致。
extends Node
signal score_changed(new_score: int)
var score: int = 0
var level_number: int = 1
func add_score(points: int) -> void:
# 所有加分统一走这里,先阻止非正数。
if points <= 0:
return
score += points
score_changed.emit(score)
func reset_run() -> void:
# 新一局清空业务数据,不删除常驻节点。
score = 0
level_number = 1
score_changed.emit(score)这是一段完整的状态节点脚本,自身没有控制台输出。注册后运行项目,可以在运行中的远程场景树看到 GameState。调用 add_score(10) 将分数加 10,并发出 score_changed;调用 reset_run() 则恢复新一局的初始值。由方法统一修改数据,比分散在不同按钮脚本中直接赋值更便于校验。
让关卡使用共享分数
创建 res://scenes/level.tscn,根节点为 Node3D,其下添加 CanvasLayer,再添加 Label 类型的 ScoreLabel 和两个 Button:AddButton、FinishButton。把按钮文字设为“加 10 分”和“结束关卡”,调整位置以确保可点击。将以下 res://scripts/level.gd 挂在根节点。
extends Node3D
@onready var score_label: Label = $CanvasLayer/ScoreLabel
@onready var add_button: Button = $CanvasLayer/AddButton
@onready var finish_button: Button = $CanvasLayer/FinishButton
func _ready() -> void:
# 先订阅变化,再主动同步当前分数。
GameState.score_changed.connect(_on_score_changed)
add_button.pressed.connect(_on_add_pressed)
finish_button.pressed.connect(_on_finish_pressed)
_on_score_changed(GameState.score)
func _on_score_changed(value: int) -> void:
score_label.text = "当前分数:%d" % value
func _on_add_pressed() -> void:
GameState.add_score(10)
func _on_finish_pressed() -> void:
var error := get_tree().change_scene_to_file("res://scenes/result.tscn")
if error != OK:
push_error("进入结算场景失败,错误码:%d" % error)预期结果(进入关卡并连续点击两次加分):
首次进入:当前分数:0
第一次点击:当前分数:10
第二次点击:当前分数:20关卡通过信号响应数据变化,而不必知道金币或敌人如何计分。关卡被销毁后,指向已销毁接收节点的信号连接会自动失效;再次进入关卡时,新实例会重新连接,并从 GameState.score 同步显示值。
让结算页读取并清空数据
创建 res://scenes/result.tscn,根节点为 Node3D,添加 CanvasLayer,其下建立 Label 类型的 SummaryLabel 与 Button 类型的 RestartButton。把 res://scripts/result.gd 挂在根节点,不需要从关卡手工传递分数参数。
extends Node3D
@onready var summary_label: Label = $CanvasLayer/SummaryLabel
@onready var restart_button: Button = $CanvasLayer/RestartButton
func _ready() -> void:
summary_label.text = "第 %d 关结算:%d 分" % [GameState.level_number, GameState.score]
restart_button.text = "重新开始"
restart_button.pressed.connect(_on_restart_pressed)
func _on_restart_pressed() -> void:
var error := get_tree().change_scene_to_file("res://scenes/level.tscn")
if error == OK:
# 场景切换请求成功后才重置,避免加载失败时丢分。
GameState.reset_run()
else:
push_error("重新进入关卡失败,错误码:%d" % error)预期结果(承接上一个示例中的 20 分):
点击“结束关卡”:第 1 关结算:20 分
点击“重新开始”:回到关卡,当前分数:0这里把清空数据定义为“重新开始新的一局”,而不是“每次加载场景”。这样即使将来在游戏中途打开设置或其他主场景,也不会因为切换而误清分数。实际项目可以为新游戏、重新挑战、退出到主菜单分别制定不同的重置范围。
验证与使用边界
把 level.tscn 设为项目主场景,运行后完成“加分两次 → 进入结算 → 重新开始”。如果结果不对,先查看 Autoload 是否注册为 GameState,再核对两个场景的控件路径是否与脚本一致。完全退出游戏后重新运行,分数应回到 0,这正是内存状态的正常行为。
不要将 Player、Camera3D 等当前场景的节点引用长期保存在 GameState 中:关卡被释放后,旧引用可能失效。应保存必要的标识或数值,并让新场景重新获取自己的节点。也不要手动释放 Autoload 节点。只有需要跨场景存活的业务状态才放入全局,其余变量应留在对应关卡、敌人或 UI 对象中。