游戏引擎 / 系统课时

节点分组按能力寻找交互对象

节点分组按能力寻找交互对象

当一次攻击需要影响场景中多个可受伤对象时,逐个保存敌人的节点路径会使新增、移除目标变得麻烦。本课使用 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) 方法。这样不必每次实例化后手动配置分组;删除节点后它也不会继续作为活动成员被查询到。

gdscript
# 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(),所以父节点开始查询时,两个敌人已经加入组。

gdscript
# 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 面板,由两个敌人脚本打印):

text
EnemyA HP=20
EnemyB HP=20

get_nodes_in_group() 返回的是查询时的节点数组,而不是后续自动更新的目标集合。若循环过程中有对象退出场景,先前取到的引用仍可能留在数组里;因此在真正调用之前验证状态。has_method() 只检查方法名是否存在,不能保证参数个数、含义或类型全部一致。

检查空组和对象离场

  1. 暂时删除 Arena.tscn 中两个敌人实例后运行。预期只打印 没有可受伤对象,不会因访问空数组而报错。
  2. 恢复两个敌人,将 Arena.gd 中 damage_all(10) 改为 damage_all(30)。预期分别打印 EnemyA HP=0、EnemyB HP=0,并在帧末释放两个敌人。之后再次查询该组时,它们不再出现。
  3. 故意给没有 receive_damage 方法的节点添加 damageable 分组。示例会跳过该节点;实际项目宜记录错误或使用共享基类、明确的能力契约,避免静默漏处理。

当对象数量随生成与销毁动态变化、且操作目标是整个能力集合时,分组能降低场景路径耦合;当交互需要确定的所有者、强类型方法签名或稳定的单个目标时,显式引用更清楚。

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

目录与阅读设置

阅读设置

17

记录一个想法

节点分组按能力寻找交互对象

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

登录哪都通