游戏引擎 / 系统课时
场景树暂停时保持菜单可操作
场景树暂停时保持菜单可操作
为关卡加入可恢复的暂停面板:按 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)设为根节点,并按下列步骤添加子节点。
- 添加
World(Node2D),内部放WorldTimer(Timer)和一个可见的ColorRect;将方块尺寸设为 48×48,方便观察移动。 - 将
WorldTimer的Wait Time设为1.0、开启Autostart,保持子节点默认的Inherit处理模式。 - 添加
PauseMenu(Control),其下添加文字为“继续”的ResumeButton(Button);为菜单设置可见尺寸与按钮位置。 - 给
Main挂载main.gd,给World挂载world.gd,并将Main.tscn设为项目主场景。使用内置输入动作ui_cancel,通常对应 Esc。
场景根节点负责切换全局暂停;World 只拥有世界运动与定时器;菜单只负责界面交互。不要把暂停菜单放到 World 的可暂停分支下,否则菜单也可能跟着失去输入。
编写暂停与计时实验
main.gd 是完整的主场景脚本。主节点设为 ALWAYS,才能在暂停期间再次响应 Esc;恢复时先解除暂停,再隐藏菜单。
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 在暂停期间仍可能送达。
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,保持暂停直至场景树定时器到期,再点击“继续”,关键日志依次为:
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,否则新的场景可能继承暂停状态。