游戏引擎 / 系统课时
节点分组按能力寻找交互对象
节点分组按能力寻找交互对象
当一次攻击需要影响场景中多个可受伤对象时,逐个保存敌人的节点路径会使新增、移除目标变得麻烦。本课使用 Godot 分组标记受伤能力,通过场景树查询成员,逐个校验存活状态与可调用方法,并验证空组和目标离开场景后的行为。
学习目标
- 使用分组标记一类可交互能力,而非固定节点路径。
- 查询并遍历组成员,处理空结果、已退出场景和待销毁对象。
- 识别分组与类型契约、唯一目标引用之间的区别。
分组适合查找一批对象
add_to_group("damageable") 为节点添加能力标签;get_tree().get_nodes_in_group("damageable") 返回当前场景树内这一组的节点数组。组名只是字符串标签,可以让敌人、木箱等不同场景共同参与一次范围伤害,但不会检查它们是否真的实现了受伤方法。
分组查询覆盖当前 SceneTree 内的匹配节点,而不只限于调用者的子节点。需要精准操作某一个已知对象时,优先使用注入的引用;需要向一批动态对象广播操作时才使用分组。get_first_node_in_group() 取到的“第一个”由树层级决定,不等于游戏语义上的唯一目标。

创建可受伤对象
在 Godot 4 新建 Enemy.tscn,根节点为 Node2D,挂载完整脚本 Enemy.gd。脚本在 _ready() 中主动加入 damageable,并提供约定的 receive_damage(amount) 方法。这样不必每次实例化后手动配置分组;删除节点后它也不会继续作为活动成员被查询到。
# Enemy.gd
extends Node2D
var health: int = 30
func _ready() -> void:
# 场景实例就绪时登记能力组。
add_to_group("damageable")
func receive_damage(amount: int) -> void:
if amount <= 0:
return
health = maxi(health - amount, 0)
print("%s HP=%d" % [name, health])
if health == 0:
queue_free()这个约定使攻击方不必知道目标位于哪个父节点下。注意 queue_free() 在帧末释放节点;在真正释放前,节点可能已被标记为待销毁,因此遍历时仍要检查 is_queued_for_deletion()。
查询、过滤并发送伤害
创建 Arena.tscn,根节点为 Node2D,在其下放置两个 Enemy.tscn 实例,分别命名 EnemyA 和 EnemyB,并给根节点挂载 Arena.gd。子节点先于父节点执行 _ready(),所以父节点开始查询时,两个敌人已经加入组。
# Arena.gd
extends Node2D
func _ready() -> void:
damage_all(10)
func damage_all(amount: int) -> void:
var targets: Array[Node] = get_tree().get_nodes_in_group("damageable")
if targets.is_empty():
print("没有可受伤对象")
return
for target in targets:
# 查询后的引用可能因场景切换或其他逻辑失效。
if not is_instance_valid(target):
continue
if not target.is_inside_tree() or target.is_queued_for_deletion():
continue
if target.has_method("receive_damage"):
target.call("receive_damage", amount)预期输出(Godot 的 Output 面板,由两个敌人脚本打印):
EnemyA HP=20
EnemyB HP=20get_nodes_in_group() 返回的是查询时的节点数组,而不是后续自动更新的目标集合。若循环过程中有对象退出场景,先前取到的引用仍可能留在数组里;因此在真正调用之前验证状态。has_method() 只检查方法名是否存在,不能保证参数个数、含义或类型全部一致。
检查空组和对象离场
- 暂时删除
Arena.tscn中两个敌人实例后运行。预期只打印没有可受伤对象,不会因访问空数组而报错。 - 恢复两个敌人,将
Arena.gd中damage_all(10)改为damage_all(30)。预期分别打印EnemyA HP=0、EnemyB HP=0,并在帧末释放两个敌人。之后再次查询该组时,它们不再出现。 - 故意给没有
receive_damage方法的节点添加damageable分组。示例会跳过该节点;实际项目宜记录错误或使用共享基类、明确的能力契约,避免静默漏处理。
当对象数量随生成与销毁动态变化、且操作目标是整个能力集合时,分组能降低场景路径耦合;当交互需要确定的所有者、强类型方法签名或稳定的单个目标时,显式引用更清楚。