游戏引擎 / 系统课时

节点所有权决定场景打包范围

节点所有权决定场景打包范围

运行时把节点加入场景树,并不意味着它会进入保存后的场景文件。本课用两个动态子节点做对照:只为其中一个设置 owner,然后打包、落盘并重新加载,确认父子关系与序列化归属究竟有什么不同。

学习目标

  • 区分 add_child() 建立的父子层级与 owner 指定的保存归属。
  • 用 PackedScene.pack() 和 ResourceSaver.save() 验证动态节点是否被保存。
  • 检查 owner 的祖先约束,并识别嵌套节点与场景实例的边界。

父子关系和所有权解决不同问题

parent 决定节点在运行时的层级位置:变换继承、子节点遍历以及进入或退出场景树,都依赖这条父子链。调用 add_child() 只是把节点挂到某个父节点下面,不等于声明它属于哪个可保存的场景。

owner 是另一条归属关系。将节点树作为 PackedScene 打包时,根节点会被保存,而准备随它一起保存的动态后代,通常需要将 owner 指向这个场景根节点。没有合适 owner 的运行时子节点,可以正常工作,却不会因为存在于父子树里就自动写入场景文件。

运行时父子层级与场景打包所有权的对照

动态创建、打包并重新加载

在 Godot 4.6 中创建一个根节点类型为 Node 的空场景,将下列脚本保存为 res://owner_demo.gd 并挂到该根节点,运行当前场景。脚本另建一棵小节点树:两个子节点都已加入 Generated,但只有 SavedChild 设置了所有者。文件写在 user://,不会覆盖项目里的原始 .tscn。

gdscript
extends Node

func _ready() -> void:
    var scene_root := Node.new()
    scene_root.name = "Generated"

    var saved_child := Node.new()
    saved_child.name = "SavedChild"
    scene_root.add_child(saved_child)
    saved_child.owner = scene_root  # 必须先建立祖先关系

    var temporary := Node.new()
    temporary.name = "TransientChild"
    scene_root.add_child(temporary)  # 不设置 owner,保留运行时性质

    var packed := PackedScene.new()
    if packed.pack(scene_root) != OK:
        push_error("打包失败")
        scene_root.free()
        return

    var path := "user://owner_demo.tscn"
    if ResourceSaver.save(packed, path) != OK:
        push_error("保存失败")
        scene_root.free()
        return

    var restored := ResourceLoader.load(path, "", ResourceLoader.CACHE_MODE_IGNORE) as PackedScene
    if restored == null:
        push_error("加载失败")
        scene_root.free()
        return

    var loaded_root := restored.instantiate()
    print("原树子节点=", scene_root.get_child_count())
    print("重载子节点=", loaded_root.get_child_count())
    print("SavedChild=", loaded_root.has_node("SavedChild"))
    print("TransientChild=", loaded_root.has_node("TransientChild"))
    loaded_root.free()
    scene_root.free()

预期输出(省略 Godot 启动信息):

text
原树子节点=2
重载子节点=1
SavedChild=true
TransientChild=false

这里用 CACHE_MODE_IGNORE 避开资源缓存,检查的是重新从磁盘加载并实例化的结果,而不是打包前的内存树。若仅查看原树,两个子节点都会存在,无法证明序列化范围正确。user:// 对应的实际磁盘目录随操作系统与项目设置变化。

祖先限制与多层节点的处理

owner 必须是当前节点的祖先,可以是直接父节点,也可以是更上层的场景根;不能设为兄弟节点或无关对象。先调用 add_child(),再设置 owner,否则祖先关系尚未建立,赋值会失败。

如果结构变成 Generated → Group → Item,且希望两个后代都进入同一份场景资源,应先把 Group 加到根下并设置 Group.owner = Generated,再将 Item 加到 Group 下并设置 Item.owner = Generated。不要只给中间节点设置所有者,就假设其动态后代一定会一起保存。

已有独立 .tscn 的实例通常应保留自己的内部所有权边界。修改外层场景时,应保存实例及外层合法的覆盖,而不是随意把子场景内部节点改成外层根的所有物。

什么时候应当保存动态节点

在编辑器工具脚本、关卡生成器或需要产出新场景资源的流程中,明确设置 owner 是必要的。普通运行时特效、临时碰撞体和会在切关时销毁的敌人,并不因为要显示在场景树里,就必须成为可打包节点。

判断动态节点是否真正属于场景文件,最终依据始终是保存成功后重新加载、实例化并检查节点,而非运行时 get_child_count() 是否正确。

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

目录与阅读设置

阅读设置

17

记录一个想法

节点所有权决定场景打包范围

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

登录哪都通