游戏引擎 / 系统课时

场景树暂停时保持菜单可操作

场景树暂停时保持菜单可操作

为关卡加入可恢复的暂停面板:按 Esc 停住角色移动与世界计时器,同时保留“继续”按钮的输入。再观察一次性定时器和信号在暂停期间的表现,避免把“停止逐帧更新”误认为“所有业务回调都会停止”。

学习目标

  • 用 SceneTree.paused 和节点 process_mode 划分暂停边界。
  • 实现 Esc 暂停、菜单继续以及暂停期间的输入响应。
  • 验证定时器与信号的例外行为,阻止暂停时意外修改游戏状态。

暂停只冻结指定处理

get_tree().paused = true 会暂停默认的 2D/3D 物理模拟,并让可暂停节点停止常规处理与输入回调。节点是否继续处理,由自身或最近一个非 Inherit 祖先的 process_mode 决定。

模式 处理时机 本例用途
PAUSABLE 只在未暂停时 角色、世界逻辑、世界计时器
WHEN_PAUSED 只在暂停时 暂停菜单与恢复按钮
ALWAYS 暂停前后都处理 接收 Esc 的主控制节点
INHERIT 沿父链继承 世界和菜单内部的普通子节点

运行与暂停两种状态下的节点处理范围

按场景边界装配节点

在 Godot 4.x 创建 Main.tscn,将 Main(Node)设为根节点,并按下列步骤添加子节点。

  1. 添加 World(Node2D),内部放 WorldTimer(Timer)和一个可见的 ColorRect;将方块尺寸设为 48×48,方便观察移动。
  2. 将 WorldTimer 的 Wait Time 设为 1.0、开启 Autostart,保持子节点默认的 Inherit 处理模式。
  3. 添加 PauseMenu(Control),其下添加文字为“继续”的 ResumeButton(Button);为菜单设置可见尺寸与按钮位置。
  4. 给 Main 挂载 main.gd,给 World 挂载 world.gd,并将 Main.tscn 设为项目主场景。使用内置输入动作 ui_cancel,通常对应 Esc。

场景根节点负责切换全局暂停;World 只拥有世界运动与定时器;菜单只负责界面交互。不要把暂停菜单放到 World 的可暂停分支下,否则菜单也可能跟着失去输入。

编写暂停与计时实验

main.gd 是完整的主场景脚本。主节点设为 ALWAYS,才能在暂停期间再次响应 Esc;恢复时先解除暂停,再隐藏菜单。

gdscript
extends Node

@onready var world: Node2D = $World
@onready var menu: Control = $PauseMenu
@onready var resume_button: Button = $PauseMenu/ResumeButton

func _ready() -> void:
    get_tree().paused = false
    process_mode = Node.PROCESS_MODE_ALWAYS
    world.process_mode = Node.PROCESS_MODE_PAUSABLE
    menu.process_mode = Node.PROCESS_MODE_WHEN_PAUSED
    menu.hide()
    resume_button.pressed.connect(_resume_game)

func _unhandled_input(event: InputEvent) -> void:
    if event.is_action_pressed("ui_cancel"):
        if get_tree().paused:
            _resume_game()
        else:
            _pause_game()
        get_viewport().set_input_as_handled()

func _pause_game() -> void:
    get_tree().paused = true
    menu.show()
    print("paused=true")

func _resume_game() -> void:
    get_tree().paused = false
    menu.hide()
    print("paused=false")

world.gd 同时检验两类计时:子节点 WorldTimer 继承 PAUSABLE,暂停时停止计数;SceneTree.create_timer(2.0) 默认 process_always=true,其 timeout 在暂停期间仍可能送达。

gdscript
extends Node2D

var ticks: int = 0

func _ready() -> void:
    $WorldTimer.timeout.connect(_on_world_tick)
    # 一次性场景树定时器默认不受暂停影响。
    get_tree().create_timer(2.0).timeout.connect(_on_tree_timer_timeout)

func _process(delta: float) -> void:
    position.x += 40.0 * delta

func _on_world_tick() -> void:
    ticks += 1
    print("world_tick=", ticks)

func _on_tree_timer_timeout() -> void:
    # 信号可送达已暂停的节点,修改业务状态前必须检查。
    if get_tree().paused:
        print("tree timer: ignored while paused")
        return
    print("tree timer: delivered while running")

预期输出:启动后在两秒内按 Esc,保持暂停直至场景树定时器到期,再点击“继续”,关键日志依次为:

text
paused=true
tree timer: ignored while paused
paused=false

如果按 Esc 前或恢复后经过一个完整的世界计时周期,还会出现 world_tick=1 等日志;暂停期间计数和方块位置均不再增长。若不暂停,两秒后会看到 tree timer: delivered while running。

检查恢复链路与异常入口

先暂停并确认方块停止,再点击“继续”,确认方块继续移动、WorldTimer 继续计时。重复使用 Esc 暂停与恢复,按钮不应失效,也不应出现重连信号导致的一次点击多次处理。

还要分清两种计时器:Timer 节点通常遵循其节点处理模式;create_timer(2.0, false) 才会创建随场景树暂停的一次性计时器。默认值 true 更适合希望暂停时继续计时的 UI 延迟,但不是安全的游戏状态修改许可。

如果菜单无法点击,检查 PauseMenu 是否设为 WHEN_PAUSED、按钮是否真正可见并能接收鼠标事件;如果 Esc 无法恢复,检查 Main 是否保持 ALWAYS。离开关卡或返回标题前也应先将 get_tree().paused 设回 false,否则新的场景可能继承暂停状态。

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

目录与阅读设置

阅读设置

17

记录一个想法

场景树暂停时保持菜单可操作

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

登录哪都通