游戏引擎 / 系统课时
场景树怎样组织运行中的游戏
场景树怎样组织运行中的游戏
一个游戏可能同时包含角色、关卡、敌人和 HUD,但这些对象并不是各自独立运行的。本课用一个微型 2D 游戏建立节点关系,区分场景文件、场景实例和运行时场景树,并通过节点路径查询确认对象在游戏中的实际位置。
学习目标
- 理解节点、场景、场景实例和运行时场景树之间的关系。
- 能将角色、关卡和界面组织成清晰的父子节点结构。
- 能通过 GDScript 查询节点路径,判断对象是否位于预期位置。
从微型游戏认识节点组织方式
假设我们要制作一个最简单的 2D 游戏:玩家出现在关卡中,屏幕上方显示生命值信息。即使暂时不制作移动、碰撞和战斗,也需要决定这些对象由谁管理、放在什么位置。
Godot 使用 Node(节点)作为游戏对象的基本构成单位。不同节点类型提供不同能力,例如 Node2D 负责组织二维空间对象,CharacterBody2D 适合实现受代码控制的物理角色,CanvasLayer 可以将界面绘制在独立画布层上。
可以把微型游戏拆成以下节点:
Main:类型为Node2D,作为游戏入口和整体容器。Level:类型为Node2D,负责组织当前关卡内容。Player:类型为CharacterBody2D,代表玩家角色。UI:类型为CanvasLayer,组织屏幕界面。HUD:类型为Label,显示界面文字。
它们的父子关系是:Main 直接包含 Level 和 UI;Level 包含 Player;UI 包含 HUD。

这棵结构体现了两个重要事实:一个节点可以拥有多个子节点,但在场景树中只能有一个直接父节点;一个场景必须有自己的根节点,却可以在内部包含其他场景的实例。
这里的 Main 是整体场景的根,Player 既可以是普通节点,也可以来自独立保存的角色场景。选择后者时,同一套角色结构能够被其他关卡复用。
场景文件、场景实例和运行时树的区别
这三个概念都与场景有关,但描述的是不同层面的对象。
| 概念 | 代表什么 | 典型例子 |
|---|---|---|
| 场景文件 | 磁盘上的可加载场景资源 | res://scenes/player.tscn |
| 场景实例 | 由场景资源创建的实际节点集合 | 当前关卡里的 Player |
| 运行时场景树 | 游戏运行时正在参与生命周期管理的节点层级 | /root/Main/Level/Player |
在 Godot 4 中,保存为 .tscn 的场景可以通过 PackedScene 资源加载和实例化。比如将角色保存为 player.tscn,再在两个不同关卡中分别实例化它,就能得到两个独立的角色节点集合。
修改角色场景文件中的默认结构,通常会影响引用该场景且未覆盖相关属性的实例;修改某个实例的运行时位置或生命值,则不会自动修改源场景文件。
运行时,SceneTree 负责管理活跃节点、进入与退出场景树的通知、节点访问以及场景切换等。其根节点可通过 get_tree().root 获取,通常在节点路径中表现为 /root。
项目运行时会将入口场景放进这棵树。动态创建的敌人、临时特效或后来切换进入的新关卡,同样需要加入相应的节点层级才能参与正常的场景树生命周期。
动手建立可查询的场景结构
使用 Godot 4.6 和 GDScript,建立一个不依赖美术资源的最小场景。这里选择三个场景文件,是为了看清场景之间的装配关系,而不是因为每个节点都必须保存成独立场景。
- 新建一个 2D 场景,以
CharacterBody2D为根节点,将其命名为Player,保存为res://scenes/player.tscn。 - 新建另一个 2D 场景,将根节点命名为
Level,通过实例化子场景功能添加player.tscn,保存为res://scenes/level.tscn。 - 新建以
Node2D为根的场景,命名为Main,将level.tscn实例化为直接子节点Level。 - 在
Main下新增CanvasLayer,命名为UI,再在UI下新增Label,命名为HUD。 - 将完整入口场景保存为
res://scenes/main.tscn,并为Main挂载 GDScript。
如果 scenes 目录不存在,应先在文件系统面板中创建。节点名称需要严格匹配,特别是 Player、UI 和 HUD 的大小写。
将以下代码写入挂载在 Main 上的脚本:
extends Node2D
func _ready() -> void:
# 相对路径从当前脚本所在的 Main 节点开始解析。
var player := get_node("Level/Player")
var hud := get_node("UI/HUD")
print("角色路径:", player.get_path())
print("界面路径:", hud.get_path())保存并运行当前场景。预期输出:
角色路径:/root/Main/Level/Player
界面路径:/root/Main/UI/HUDget_node() 根据给定的相对路径查找节点,get_path() 返回该节点在当前场景树中的绝对路径。因为脚本挂在 Main 上,所以不需要在相对路径前重复写 Main。
如果查询失败,Godot 会报告找不到对应节点。应先检查节点是否存在、名称是否一致、父子层级是否正确,而不是直接修改脚本去绕过错误。
这里的路径还揭示了一个容易忽略的事实:Player 虽然来自 player.tscn,但运行时仍然出现在 Main/Level/Player 这条路径上,并不会因为拥有独立的场景文件就自动成为另一棵互不相关的运行时场景树。
父子关系决定哪些行为
节点层级不只是编辑器中的整理方式,它会影响运行时行为。
首先是生命周期。节点被添加到场景树时会经历进入场景树和就绪等阶段;父节点先进入场景树,子节点随后进入,而子节点的 _ready() 通常先于父节点的 _ready() 执行。
其次是空间变换。例如 Player 位于 Level 下面时,它的二维局部位置会受到父级 CanvasItem 变换的影响。移动 Level,可能同时改变关卡中所有相关二维对象的最终位置。
但并非所有父子关系都表示空间继承。CanvasLayer 具有独立的画布层行为,所以适合把 HUD 与世界空间的角色、地形分开组织,避免世界对象移动时让界面跟着漂移。
最后是路径依赖。脚本使用 get_node("Level/Player") 时,意味着它依赖这条具体结构。如果以后把 Player 移到别的父节点下,路径可能失效。对稳定的局部结构使用节点路径很方便,但不应让大量跨系统代码依赖复杂的绝对路径。
怎样确定一个对象是否应该独立成场景
不必把每个节点都保存为 .tscn。判断场景边界时,更实用的问题是:这组节点能否作为一个独立整体创建、复用、配置和维护?
角色通常适合独立成场景,因为它可能拥有碰撞、动画、检测区域和脚本,并且需要重复生成。关卡也适合独立成场景,因为它需要单独加载、编辑和替换。HUD 如果会在多个关卡中复用,也可以保存成独立场景。
相反,只属于某个角色的一个简单辅助节点,通常没有必要专门保存为场景。过度拆分会增加文件数量和装配工作,并不必然提高复用性。
可以做一次结构验证:在 Level 中再实例化一个 player.tscn,将两个角色节点分别命名为 Player 和 Player2。重新运行后,两个实例都位于 Level 下面,但具有各自的节点身份和运行时状态。
当你能明确指出一个对象的源场景文件、它在入口场景中的实例位置,以及运行时的节点路径时,就已经建立了分析 Godot 场景架构最重要的基础。