游戏引擎 / 系统课时
节点重挂父级时保留空间位置
节点重挂父级时保留空间位置
角色脱落的挂件和拾起后抛出的三维物体,通常需要从角色节点转移到世界节点。如果只更换父级却不处理坐标,它们可能突然跳到别处。本课在同一场景中验证二维与三维的局部、全局位置变化,并观察重挂引发的生命周期回调及初始化责任。
学习目标
- 使用
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() 调用次数,并用一次信号发射验证没有重复订阅。
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))预期输出:
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()。
判断重挂是否正确,不只看“世界位置没跳”:还要检查父子归属、局部坐标、入树回调次数、业务状态重置和事件是否只触发一次。