游戏引擎 / 系统课时

节点组合拆出可替换的生命组件

节点组合拆出可替换的生命组件

当玩家和敌人都要受伤、死亡时,把扣血、移动和界面刷新写在同一个角色脚本里,会让角色难以替换。本课把生命规则拆成独立节点,用公开方法接收伤害、用信号报告变化,并在两个不同场景中验证复用效果。

学习目标

  • 提取只负责生命状态和伤害规则的节点组件。
  • 使用公开方法与信号连接组件和宿主,不依赖固定父节点。
  • 在玩家和敌人场景中验证独立状态,并判断何时不必使用节点。

划清组件与宿主的责任

HealthComponent 只知道最大生命值、当前生命值、受伤和死亡。它不应该查找 Player、Enemy、动画或 HUD,也不应该直接调用宿主的死亡动画。宿主负责把受击事件转成 take_damage() 调用,再订阅生命变化和死亡信号,决定播放什么表现。

玩家和敌人可以使用同一份组件脚本,但各自拥有独立的 HealthComponent 节点实例,运行时生命值不会相互影响。这是共享行为实现,而非共享可变状态。

玩家与敌人独立装配生命组件的调用及信号关系

实现独立的生命节点

在 Godot 4 项目中新建 res://health_component.gd,并附加到一个普通 Node 上。@export_range 允许宿主场景分别设置生命上限;_ready() 为每个节点实例初始化自己的当前生命值。

gdscript
extends Node
class_name HealthComponent

signal health_changed(current: int, maximum: int)
signal died

@export_range(1, 9999, 1) var max_health: int = 100
var current_health: int = 0

func _ready() -> void:
    # 每个节点实例独立初始化,不共享当前生命值
    current_health = max_health

func take_damage(amount: int) -> void:
    if amount <= 0 or current_health == 0:
        return
    current_health = maxi(current_health - amount, 0)
    health_changed.emit(current_health, max_health)
    # 生命值首次降为零时通知宿主
    if current_health == 0:
        died.emit()

预期结果:这份完整组件脚本附加到节点后不自行打印;节点入树时 current_health 等于 max_health。宿主调用 take_damage() 时才发出信号,非正数伤害被忽略,生命值不会降到零以下,死亡后也不会重复发出 died。若要显示初始血量,宿主可直接读取这两个公开属性。

装配两个角色并检查输出

分别创建 Player.tscn 和 Enemy.tscn,根节点都使用 Node2D,各添加一个命名为 HealthComponent 的 Node 子节点,给两个子节点附加同一个 health_component.gd。在检查器中设置玩家最大生命值为 100、敌人为 60。

给两个场景的根节点都附加下列 res://actor.gd。玩家的 actor_label 保持 Player,敌人的值改为 Enemy。父节点的 _ready() 执行时,子节点已完成初始化,适合连接信号并调用公开方法。

gdscript
extends Node2D

@export var actor_label: String = "Player"
@onready var health: HealthComponent = $HealthComponent

func _ready() -> void:
    # 宿主决定如何消费信号,组件不感知角色类型
    health.health_changed.connect(_on_health_changed)
    health.died.connect(_on_died)
    health.take_damage(35)
    health.take_damage(100)

func _on_health_changed(current: int, maximum: int) -> void:
    print("%s HP: %d/%d" % [actor_label, current, maximum])

func _on_died() -> void:
    print("%s died" % actor_label)

预期输出:使用“运行当前场景”分别运行两份场景。玩家运行打印前三行;停止后运行敌人场景,打印后三行。

text
Player HP: 65/100
Player HP: 0/100
Player died
Enemy HP: 25/60
Enemy HP: 0/60
Enemy died

两个宿主只依赖组件公开接口和信号;将 Enemy 换成其他角色,只需保留约定的子节点与脚本,不必修改生命规则。

判断节点生命周期是否必要

生命组件需要随角色入树、作为子节点配置并向外发信号,使用 Node 合适。若只是计算一次伤害系数、既不保存场景状态也不参与节点生命周期,普通脚本类(如 RefCounted)通常更轻。

验收时再调用一次 take_damage(0) 和死亡后的 take_damage(10),应无新增输出。这样既确认了边界条件,也确认生命组件无需知道宿主的移动与表现结构。

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

目录与阅读设置

阅读设置

17

记录一个想法

节点组合拆出可替换的生命组件

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

登录哪都通