游戏引擎 / 系统课时

节点重挂父级时保留空间位置

节点重挂父级时保留空间位置

角色脱落的挂件和拾起后抛出的三维物体,通常需要从角色节点转移到世界节点。如果只更换父级却不处理坐标,它们可能突然跳到别处。本课在同一场景中验证二维与三维的局部、全局位置变化,并观察重挂引发的生命周期回调及初始化责任。

学习目标

  • 使用 reparent() 转移 Node2D 与 Node3D,正确选择是否保留全局变换。
  • 通过具体坐标验证新父级下局部位置的变化。
  • 区分重新入树回调、一次性初始化及显式重置,防止重复连接信号。

换父节点改变的是坐标参照

position 表示相对于当前父节点的局部位置,global_position 表示场景中的全局位置。例如角色位于 (100, 20),挂件在角色局部 (10, 5),其全局位置就是 (110, 25)。若世界容器自身位于 (200, 0),要在更换父级后保持画面位置,挂件新局部位置必须变为 (-90, 25)。

Godot 4.6 的 reparent(new_parent, keep_global_transform) 默认把第二个参数设为 true。Node2D 与 Node3D 可以保留全局变换;传 false 则保留原局部变换,因而通常改变世界位置。下图同时展示重挂前后的坐标关系,以及节点进出场景树的回调。

二维三维节点重挂父级的空间关系和生命周期时序

运行二维与三维重挂实验

新建一个根节点类型为 Node 的空场景,把以下完整脚本附在根节点并运行。脚本创建两组角色与世界容器,再分别转移 Node2D 挂件和 Node3D 物体。内部类记录挂件的 _enter_tree()、_exit_tree() 与 _ready() 调用次数,并用一次信号发射验证没有重复订阅。

gdscript
extends Node

class TrackedPendant2D:
    extends Node2D

    signal activated
    var ready_calls := 0
    var still_equipped := true

    func _enter_tree() -> void:
        print("2D enter_tree")

    func _ready() -> void:
        ready_calls += 1
        # 一次性连接;即使未来显式 request_ready 也避免重复订阅
        if not activated.is_connected(_on_activated):
            activated.connect(_on_activated)
        print("2D ready #", ready_calls)

    func _exit_tree() -> void:
        print("2D exit_tree")

    func reset_for_world() -> void:
        still_equipped = false
        print("2D reset equipped=", still_equipped)

    func _on_activated() -> void:
        print("2D activated once")

func _ready() -> void:
    var character_2d := Node2D.new()
    character_2d.position = Vector2(100, 20)
    add_child(character_2d)
    var world_2d := Node2D.new()
    world_2d.position = Vector2(200, 0)
    add_child(world_2d)

    var pendant := TrackedPendant2D.new()
    pendant.position = Vector2(10, 5)
    character_2d.add_child(pendant)
    var local_2d_before := pendant.position
    var global_2d_before := pendant.global_position
    # 转移到世界容器,但保留全局变换
    pendant.reparent(world_2d, true)
    pendant.reset_for_world()
    pendant.activated.emit()
    print("2D global preserved=", pendant.global_position.is_equal_approx(global_2d_before))
    print("2D local changed=", not pendant.position.is_equal_approx(local_2d_before))
    print("2D ready calls=", pendant.ready_calls)

    var character_3d := Node3D.new()
    character_3d.position = Vector3(1, 0, 2)
    add_child(character_3d)
    var world_3d := Node3D.new()
    world_3d.position = Vector3(4, 0, 0)
    add_child(world_3d)

    var prop := Node3D.new()
    prop.position = Vector3(0, 1, 0)
    character_3d.add_child(prop)
    var local_3d_before := prop.position
    var global_3d_before := prop.global_position
    # 三维节点同样可在换父级时保留全局位置
    prop.reparent(world_3d, true)
    print("3D global preserved=", prop.global_position.is_equal_approx(global_3d_before))
    print("3D local changed=", not prop.position.is_equal_approx(local_3d_before))

预期输出:

text
2D enter_tree
2D ready #1
2D exit_tree
2D enter_tree
2D reset equipped=false
2D activated once
2D global preserved=true
2D local changed=true
2D ready calls=1
3D global preserved=true
3D local changed=true

实际坐标对照如下;示例未旋转或缩放父节点,便于直接相加和相减:

对象 重挂前局部 重挂后局部 前后相同的全局位置
2D 挂件 (10, 5) (-90, 25) (110, 25)
3D 物体 (0, 1, 0) (-3, 1, 2) (1, 1, 2)

重新入树不等于再次初始化

reparent() 会使移动节点退出旧树位置、进入新树位置,因此 _exit_tree() 和 _enter_tree() 会再次运行;但 _ready() 默认只在节点生命周期中调用一次。这就是输出里两次 enter_tree、一次 exit_tree,却只有一次 ready #1 的原因。

需要在转移后清除“已装备”、目标跟踪或临时碰撞忽略等运行状态时,应显式调用类似 reset_for_world() 的业务方法,而不是指望 _ready() 再次执行。若确实需要 _ready() 在下次进树时重跑,可提前调用 request_ready();它不会立即触发,也不会自动替所有子节点申请重跑。

迁移前要检查的边界

  • 如果信号连接写在 _enter_tree(),迁出时应按所有权在 _exit_tree() 对应解绑,或在连接前用 is_connected() 防止重复连接;对自身长期有效的连接可在 _ready() 一次建立。
  • Control 也支持保留全局变换参数,但只保证位置;UI 锚点与容器布局需单独验证。普通 Node 没有二维或三维坐标可保留。
  • 在碰撞回调中重挂仍参与物理检测的节点,应改为 call_deferred() 进行;启用物理插值且出现视觉拖尾时,可在重挂后调用 reset_physics_interpolation()。

判断重挂是否正确,不只看“世界位置没跳”:还要检查父子归属、局部坐标、入树回调次数、业务状态重置和事件是否只触发一次。

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

目录与阅读设置

阅读设置

17

记录一个想法

节点重挂父级时保留空间位置

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

登录哪都通