游戏引擎 / 系统课时
节点组合拆出可替换的生命组件
节点组合拆出可替换的生命组件
当玩家和敌人都要受伤、死亡时,把扣血、移动和界面刷新写在同一个角色脚本里,会让角色难以替换。本课把生命规则拆成独立节点,用公开方法接收伤害、用信号报告变化,并在两个不同场景中验证复用效果。
学习目标
- 提取只负责生命状态和伤害规则的节点组件。
- 使用公开方法与信号连接组件和宿主,不依赖固定父节点。
- 在玩家和敌人场景中验证独立状态,并判断何时不必使用节点。
划清组件与宿主的责任
HealthComponent 只知道最大生命值、当前生命值、受伤和死亡。它不应该查找 Player、Enemy、动画或 HUD,也不应该直接调用宿主的死亡动画。宿主负责把受击事件转成 take_damage() 调用,再订阅生命变化和死亡信号,决定播放什么表现。
玩家和敌人可以使用同一份组件脚本,但各自拥有独立的 HealthComponent 节点实例,运行时生命值不会相互影响。这是共享行为实现,而非共享可变状态。

实现独立的生命节点
在 Godot 4 项目中新建 res://health_component.gd,并附加到一个普通 Node 上。@export_range 允许宿主场景分别设置生命上限;_ready() 为每个节点实例初始化自己的当前生命值。
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() 执行时,子节点已完成初始化,适合连接信号并调用公开方法。
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)预期输出:使用“运行当前场景”分别运行两份场景。玩家运行打印前三行;停止后运行敌人场景,打印后三行。
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),应无新增输出。这样既确认了边界条件,也确认生命组件无需知道宿主的移动与表现结构。