游戏引擎 / 系统课时

场景边界按对象职责进行拆分

场景边界按对象职责进行拆分

当玩家碰撞、角色外观和 HUD 都堆在一个 Level 场景中时,单独复用角色会连带依赖关卡节点。本课从混合节点树出发,提取可独立运行的 Player 和 HUD 场景,再让关卡负责装配,最终用单场景运行检查拆分是否真的有效。

学习目标

  • 按对象职责决定哪些子节点一起提取、哪些留在关卡中。
  • 把节点分支保存成独立场景,并通过 PackedScene 在关卡中实例化。
  • 用单场景运行和依赖检查验证可复用性。

找出应该一起移动的节点

假设原来的 Level 是 Node2D:其下有 Player(CharacterBody2D),玩家带着 Sprite2D、CollisionShape2D 和可选的 Camera2D;同级还有地形与 HUD(CanvasLayer,下含界面 Control 和生命值标签)。如果玩家脚本直接用 ../HUD 更新血条,玩家一离开当前关卡就会找不到该路径。

拆分边界应跟随对象能否独立承担职责。Player 的显示、碰撞和自身摄像机需要跟着玩家走;生命值界面不属于角色的内部节点,应保留为独立 HUD 场景;地形、玩家出生位置以及连接角色和界面的逻辑由 Level 负责。

混合节点树拆分为独立玩家、界面与关卡场景

把分支保存为可复用场景

先在原场景保存一份副本,避免修改过程覆盖唯一可运行版本。随后按如下顺序整理:

  1. 选中 Player 分支,在场景树中右键选择 Save Branch as Scene,保存为 Player.tscn。打开新场景,检查 Sprite2D 的纹理、CollisionShape2D 的形状及角色脚本是否仍在正确节点上。
  2. 同样将 HUD 分支保存为 HUD.tscn,让其保有自己的 Control 和生命值标签;可以先把标签文本设为 HP: 100,作为无需角色数据也能显示的默认内容。
  3. 回到 Level,保留地形和关卡逻辑,添加一个空 Node2D 子节点 Actors。本例将从脚本创建玩家,所以要移除关卡里原来留下的 Player 实例,防止运行时出现两个玩家。
  4. 保留 HUD.tscn 在关卡中的场景实例。检查旧脚本和信号连接,移除 Player 内部针对 ../HUD 的硬编码节点路径。

保存分支只解决资源归属,不会自动修复外部依赖。真正可复用的角色应只处理移动、碰撞和自己的状态,把状态变化通过信号或明确的接口交给外层场景接收;HUD 不应反向搜索某个固定名字的关卡。

由关卡负责创建玩家

把下面脚本附到 Level 根节点。前置条件是该根节点为 Node2D,存在空子节点 Actors,并且已将 Player.tscn 设为脚本导出的 player_scene 属性。示例中的 Player.tscn 根节点名称保持为 Player。

gdscript
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 初始为空,且已正确指定场景资源):

text
player=Player, actors=1

PackedScene 是可实例化的场景资源;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 文件,而看角色和界面能否独立检查,并由关卡明确提供需要的外部连接。

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

目录与阅读设置

阅读设置

17

记录一个想法

场景边界按对象职责进行拆分

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

登录哪都通