游戏引擎 / 系统课时
场景边界按对象职责进行拆分
场景边界按对象职责进行拆分
当玩家碰撞、角色外观和 HUD 都堆在一个 Level 场景中时,单独复用角色会连带依赖关卡节点。本课从混合节点树出发,提取可独立运行的 Player 和 HUD 场景,再让关卡负责装配,最终用单场景运行检查拆分是否真的有效。
学习目标
- 按对象职责决定哪些子节点一起提取、哪些留在关卡中。
- 把节点分支保存成独立场景,并通过
PackedScene在关卡中实例化。 - 用单场景运行和依赖检查验证可复用性。
找出应该一起移动的节点
假设原来的 Level 是 Node2D:其下有 Player(CharacterBody2D),玩家带着 Sprite2D、CollisionShape2D 和可选的 Camera2D;同级还有地形与 HUD(CanvasLayer,下含界面 Control 和生命值标签)。如果玩家脚本直接用 ../HUD 更新血条,玩家一离开当前关卡就会找不到该路径。
拆分边界应跟随对象能否独立承担职责。Player 的显示、碰撞和自身摄像机需要跟着玩家走;生命值界面不属于角色的内部节点,应保留为独立 HUD 场景;地形、玩家出生位置以及连接角色和界面的逻辑由 Level 负责。

把分支保存为可复用场景
先在原场景保存一份副本,避免修改过程覆盖唯一可运行版本。随后按如下顺序整理:
- 选中
Player分支,在场景树中右键选择Save Branch as Scene,保存为Player.tscn。打开新场景,检查Sprite2D的纹理、CollisionShape2D的形状及角色脚本是否仍在正确节点上。 - 同样将
HUD分支保存为HUD.tscn,让其保有自己的Control和生命值标签;可以先把标签文本设为HP: 100,作为无需角色数据也能显示的默认内容。 - 回到
Level,保留地形和关卡逻辑,添加一个空Node2D子节点Actors。本例将从脚本创建玩家,所以要移除关卡里原来留下的Player实例,防止运行时出现两个玩家。 - 保留
HUD.tscn在关卡中的场景实例。检查旧脚本和信号连接,移除Player内部针对../HUD的硬编码节点路径。
保存分支只解决资源归属,不会自动修复外部依赖。真正可复用的角色应只处理移动、碰撞和自己的状态,把状态变化通过信号或明确的接口交给外层场景接收;HUD 不应反向搜索某个固定名字的关卡。
由关卡负责创建玩家
把下面脚本附到 Level 根节点。前置条件是该根节点为 Node2D,存在空子节点 Actors,并且已将 Player.tscn 设为脚本导出的 player_scene 属性。示例中的 Player.tscn 根节点名称保持为 Player。
extends Node2D
@export var player_scene: PackedScene
@onready var actors: Node2D = $Actors
func _ready() -> void:
# 由关卡装配玩家,避免玩家自己寻找关卡或 HUD。
if player_scene == null:
push_error("未指定 Player 场景")
return
var player := player_scene.instantiate()
actors.add_child(player)
# 检查数量可以发现关卡是否意外保留重复实例。
print("player=%s, actors=%d" % [player.name, actors.get_child_count()])预期输出(Actors 初始为空,且已正确指定场景资源):
player=Player, actors=1PackedScene 是可实例化的场景资源;instantiate() 创建节点,add_child() 才把它纳入运行中的场景树。本例只演示边界和装配,实际血量更新可以由 Level 连接玩家的状态信号,再转交给 HUD 的公开方法,不必让二者互相依赖内部路径。
用单场景运行验证拆分
分别打开 Player.tscn、HUD.tscn 和 Level.tscn,每次按 F6 运行当前场景,不要只按 F5 运行整个项目,否则可能一直在测试主场景。
Player.tscn:无需Level和HUD也能启动;纹理已指定时能看见外观,碰撞形状已指定时不应报告缺失形状警告。若角色输入动作依赖项目的 Input Map,应提前配置这些动作。HUD.tscn:无需Player也能看到默认生命值文本;真实生命值尚未绑定是预期中的独立状态。Level.tscn:玩家只生成一次,输出面板显示actors=1,界面正常显示;可进一步在另一关卡重复实例化同一个Player.tscn。
若只有关卡能运行、单独运行 Player 就报找不到 HUD,说明仍有跨场景路径依赖;若出现两名玩家,检查是否同时保留编辑器里的玩家实例和脚本实例。拆分是否成功,不看产生了多少 .tscn 文件,而看角色和界面能否独立检查,并由关卡明确提供需要的外部连接。