游戏引擎 / 系统课时

用 Autoload 保存全局状态

用 Autoload 保存全局状态

本课解决更换场景后分数和关卡信息丢失的问题。你将创建并注册 GameState Autoload,在三维关卡中加分并通知界面,再切换到结算场景读取相同数据,最后验证重新开始时如何重置状态。

学习目标

  • 理解 Autoload 与普通场景节点在生命周期上的区别。
  • 注册共享状态节点,使用方法和信号更新分数。
  • 验证跨场景读取、重新开始以及重启程序后的数据表现。

Autoload 为什么不会随关卡消失

普通关卡的 Node3D、HUD、玩家脚本都属于当前场景。通过 SceneTree.change_scene_to_file() 切换场景时,这些节点会被释放,放在关卡脚本里的分数变量也会丢失。Autoload 不属于被替换的主场景,它在游戏启动时作为根视口的子节点创建,之后一直存在。

Autoload 与关卡切换的层级和数据流

这只能保证本次游戏运行期间的数据共享,并不等于写入磁盘。退出游戏后重新打开,成员变量会重新初始化;需要长期保留的存档仍应写入 user://。Autoload 也不是真正禁止重复实例化的单例,应把它视为由项目统一注册和使用的常驻节点。

注册并封装全局数据

先创建 res://scripts/game_state.gd。在 Godot 4 里打开“项目 → 项目设置 → Globals → Autoload”(部分版本直接显示“Autoload”标签),选择这个脚本,填写名称 GameState,点击添加并确认启用。名称必须与代码中使用的 GameState 完全一致。

gdscript
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 挂在根节点。

gdscript
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)

预期结果(进入关卡并连续点击两次加分):

text
首次进入:当前分数:0
第一次点击:当前分数:10
第二次点击:当前分数:20

关卡通过信号响应数据变化,而不必知道金币或敌人如何计分。关卡被销毁后,指向已销毁接收节点的信号连接会自动失效;再次进入关卡时,新实例会重新连接,并从 GameState.score 同步显示值。

让结算页读取并清空数据

创建 res://scenes/result.tscn,根节点为 Node3D,添加 CanvasLayer,其下建立 Label 类型的 SummaryLabel 与 Button 类型的 RestartButton。把 res://scripts/result.gd 挂在根节点,不需要从关卡手工传递分数参数。

gdscript
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 分):

text
点击“结束关卡”:第 1 关结算:20 分
点击“重新开始”:回到关卡,当前分数:0

这里把清空数据定义为“重新开始新的一局”,而不是“每次加载场景”。这样即使将来在游戏中途打开设置或其他主场景,也不会因为切换而误清分数。实际项目可以为新游戏、重新挑战、退出到主菜单分别制定不同的重置范围。

验证与使用边界

把 level.tscn 设为项目主场景,运行后完成“加分两次 → 进入结算 → 重新开始”。如果结果不对,先查看 Autoload 是否注册为 GameState,再核对两个场景的控件路径是否与脚本一致。完全退出游戏后重新运行,分数应回到 0,这正是内存状态的正常行为。

不要将 Player、Camera3D 等当前场景的节点引用长期保存在 GameState 中:关卡被释放后,旧引用可能失效。应保存必要的标识或数值,并让新场景重新获取自己的节点。也不要手动释放 Autoload 节点。只有需要跨场景存活的业务状态才放入全局,其余变量应留在对应关卡、敌人或 UI 对象中。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 Autoload 保存全局状态

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通