游戏引擎 / 系统课时
场景树为双关卡划分常驻节点
场景树为双关卡划分常驻节点
用两个可切换的拾取关卡验证场景边界:角色、HUD 与累计拾取数保留,关卡地形和道具随切换销毁并重建。最终得到一个常驻 Game 主场景和两个可独立编辑、实例化的关卡资源,不必在每次换关时重建整套界面。
学习目标
- 按对象的生存范围区分常驻节点与临时关卡节点。
- 使用
PackedScene.instantiate()装载和释放两个关卡分支。 - 用道具信号更新会话数据,并验证角色与 HUD 跨关卡保留。
用生存范围决定节点归属
先明确谁创建对象、谁销毁对象。常驻不代表全局单例;对于这个只有一次游戏会话的原型,将常驻节点直接放在 Game.tscn 内就够了。
| 对象 | 生存范围 | 创建与清理责任 |
|---|---|---|
Game / Session |
整个游戏会话 | 启动时创建,退出主场景时释放 |
Player / HUD |
两个关卡之间 | 由 Game 持有,不随换关删除 |
LevelSlot |
整个游戏会话 | 由 Game 持有,只替换它的关卡子节点 |
LevelA / LevelB |
当前关卡 | Game 实例化,切换时移除并释放 |
Pickup |
当前关卡内的一次拾取 | 关卡实例持有,被拾取或关卡销毁时释放 |

关键是只替换 LevelSlot 内的关卡实例,而不调用 change_scene_to_file() 切走整个 Game。后者会替换当前主场景,导致其下的角色、HUD 和会话节点一并失去。
搭建最小可运行的场景资源
在 Godot 4.x 中新建以下资源,文件路径须与后续脚本的 preload 保持一致。
res://game.tscn:根节点Game(Node2D),添加Session(Node)、LevelSlot(Node2D)、Player(实例化player.tscn)和HUD(CanvasLayer)。HUD下添加PickupCount(Label)与NextLevel(Button),按钮文本设为“下一关”。res://player.tscn:根节点Player(CharacterBody2D),添加CollisionShape2D(CircleShape2D,半径 12)和用于显示角色的Polygon2D,绘制一个约 24×24 的方块。res://pickup.tscn:根节点Pickup(Area2D),添加CollisionShape2D(CircleShape2D,半径 10)和可见的Polygon2D。保持默认碰撞层、掩码和Monitoring,让其检测玩家的物理身体。res://levels/level_a.tscn与res://levels/level_b.tscn:根节点分别为LevelA、LevelB(Node2D);各包含SpawnPoint(Marker2D)与Pickups(Node2D)。在Pickups下各放一个pickup.tscn实例,调整到不会与出生点重叠的位置。
将关卡 A 的出生点、道具位置分别设为 (80, 120)、(200, 120),关卡 B 设为 (80, 260)、(200, 260)。LevelSlot 置于原点;两个关卡中的 SpawnPoint 和拾取物均使用各自关卡的局部坐标。主场景设为 res://game.tscn。
让角色和道具只管理自身行为
下面的脚本构成同一个完整项目示例,依赖刚创建的场景节点,不能脱离场景单独执行。session.gd 挂在 Session,会话累计数不会因删除关卡而清零。
extends Node
class_name SessionData
var total_pickups: int = 0player.gd 挂在 Player 场景根节点,使用 Godot 内置的 ui_left、ui_right、ui_up、ui_down 动作移动。玩家加入 player 组供拾取物识别。
extends CharacterBody2D
@export var speed: float = 180.0
func _ready() -> void:
add_to_group("player")
func _physics_process(_delta: float) -> void:
velocity = Input.get_vector(
"ui_left", "ui_right", "ui_up", "ui_down"
) * speed
move_and_slide()pickup.gd 挂在道具根节点。道具只报告被拾取,不直接读取 HUD 或会话路径;发出信号后安全释放自身。
extends Area2D
class_name Pickup
signal picked_up
func _ready() -> void:
body_entered.connect(_on_body_entered)
func _on_body_entered(body: Node2D) -> void:
if not body.is_in_group("player"):
return
picked_up.emit()
queue_free()由主场景装配关卡并处理计数
game.gd 挂在 Game 上。先从资源创建新关卡,移除旧关卡,再把新实例加入固定插槽;角色重新放到新关卡的出生点。Game 负责连接当前关卡内的道具信号,不要求 Pickup 知道会话节点在哪里。
extends Node2D
const LEVEL_A = preload("res://levels/level_a.tscn")
const LEVEL_B = preload("res://levels/level_b.tscn")
@onready var session: SessionData = $Session
@onready var level_slot: Node2D = $LevelSlot
@onready var player: CharacterBody2D = $Player
@onready var counter: Label = $HUD/PickupCount
var level_index: int = 0
var active_level: Node2D
func _ready() -> void:
var next_button: Button = $HUD/NextLevel
# 防止按钮焦点占用方向键的角色输入。
next_button.focus_mode = Control.FOCUS_NONE
next_button.pressed.connect(_next_level)
_load_level(0)
func _next_level() -> void:
_load_level(1 - level_index)
func _load_level(index: int) -> void:
var packed: PackedScene = LEVEL_A if index == 0 else LEVEL_B
var level := packed.instantiate() as Node2D
if level == null:
push_error("关卡根节点必须是 Node2D")
return
# 先脱离场景树,避免新旧关卡同时参与运行。
if is_instance_valid(active_level):
level_slot.remove_child(active_level)
active_level.queue_free()
level_slot.add_child(level)
active_level = level
level_index = index
var spawn := level.get_node("SpawnPoint") as Marker2D
player.global_position = spawn.global_position
for child in level.get_node("Pickups").get_children():
var pickup := child as Pickup
if pickup != null:
pickup.picked_up.connect(_on_picked_up)
_update_hud()
func _on_picked_up() -> void:
session.total_pickups += 1
_update_hud()
func _update_hud() -> void:
counter.text = "拾取总数:%d 当前关卡:%d" % [
session.total_pickups, level_index + 1
]预期结果:运行 game.tscn,使用方向键移动碰到关卡 A 道具,点击“下一关”再拾取关卡 B 道具;HUD 依次显示:
启动:拾取总数:0 当前关卡:1
拾取 A:拾取总数:1 当前关卡:1
切换 B:拾取总数:1 当前关卡:2
拾取 B:拾取总数:2 当前关卡:2这些前缀是操作步骤说明,不是引擎自动打印的日志;可见结果为冒号之后的 HUD 文本。
验证清理责任与状态边界
运行时打开远程场景树:点击“下一关”后,Game、Session、Player、HUD 和 LevelSlot 应保持原对象;旧 LevelA 从插槽中消失,新的 LevelB 连同道具进入插槽。queue_free() 在帧末释放旧实例,切换后不应留下旧碰撞区域。
再切回关卡 A:因重新实例化 LevelA,道具会再次出现,而 Session.total_pickups 仍累计。这区分了“跨关卡保留的会话积分”和“进入关卡时重建的临时道具”。若要求某枚道具只能拾取一次,应给道具稳定 ID,并让 Session 保存已拾取 ID,加载关卡时据此隐藏或删除对应实例。
不要让关卡直接获取 ../../HUD 或向共享配置资源写入运行时积分。常驻节点负责会话数据和装配,临时节点只通过信号报告事件;这样新增第三关时,不必重写角色、HUD 和拾取物之间的依赖关系。