游戏引擎 / 系统课时
封装生命值和伤害处理组件
封装生命值和伤害处理组件
这一课把玩家和敌人的生命值收口到一个 Health 组件,攻击方只提交携带伤害来源与命中编号的 DamageInfo。完成后,同一次命中不会重复扣血,生命值不会越界,死亡、受击反馈和血条刷新都通过事件与战斗计算解耦。
学习目标
- 定义包含伤害值、来源和唯一命中编号的伤害契约。
- 实现扣血、治疗、复活、重复命中过滤与一次性死亡通知。
- 在 Unity 6 中运行验收用例,并正确连接 UI 与死亡处理逻辑。
明确数据契约与事件边界
Health 只负责生命值状态,不直接查找血条、播放动画或销毁角色。推荐将 Health.cs 挂在玩家或敌人的根对象上,初始 maxHealth 设为 100。伤害由武器、陷阱等调用方提交,组件统一裁决是否生效。
| 字段 | 类型 | 约束和用途 |
|---|---|---|
HitId |
long |
同一次命中重试沿用相同编号;不同有效命中使用新编号 |
Source |
GameObject |
伤害发起者;环境伤害允许为 null |
Amount |
int |
正整数;0 或负数不造成伤害 |
命中编号必须在当前战斗会话内唯一,不能让两把武器各自从 1 重新编号;一次挥刀反复触发碰撞回调时,则应复用该次命中的编号。持续伤害的每个有效跳伤需要新的编号。

编写可复用的 Health 组件
在 Assets/Scripts/Combat/Health.cs 创建以下完整脚本。它使用 HashSet<long> 配合 Queue<long> 保存最近 128 个有效命中编号:重复回调不会多扣血,缓存又不会随着关卡时长无限增长。首次归零才发送 Died,之后的伤害返回 Dead。
using System;
using System.Collections.Generic;
using UnityEngine;
public readonly struct DamageInfo
{
public readonly long HitId;
public readonly GameObject Source;
public readonly int Amount;
public DamageInfo(long hitId, GameObject source, int amount)
{
HitId = hitId;
Source = source;
Amount = amount;
}
}
public enum DamageResult { Applied, Duplicate, Invalid, Dead }
public sealed class Health : MonoBehaviour
{
[SerializeField, Min(1)] private int maxHealth = 100;
private const int DedupCapacity = 128;
private readonly HashSet<long> recentIds = new HashSet<long>();
private readonly Queue<long> hitOrder = new Queue<long>();
public int CurrentHealth { get; private set; }
public int MaxHealth => maxHealth;
public bool IsDead => CurrentHealth == 0;
public event Action<int, int> HealthChanged;
public event Action<DamageInfo> Damaged;
public event Action<DamageInfo> Died;
private void Awake()
{
maxHealth = Mathf.Max(1, maxHealth);
CurrentHealth = maxHealth;
}
public DamageResult ApplyDamage(DamageInfo damage)
{
if (damage.HitId <= 0 || damage.Amount <= 0)
return DamageResult.Invalid;
if (IsDead)
return DamageResult.Dead;
if (!recentIds.Add(damage.HitId))
return DamageResult.Duplicate;
// 只保留最近128个已处理命中,限制去重缓存容量。
hitOrder.Enqueue(damage.HitId);
if (hitOrder.Count > DedupCapacity)
recentIds.Remove(hitOrder.Dequeue());
CurrentHealth = Mathf.Max(0, CurrentHealth - damage.Amount);
HealthChanged?.Invoke(CurrentHealth, MaxHealth);
Damaged?.Invoke(damage);
// 归零后再受击会被前面的死亡检查拦截。
if (IsDead)
Died?.Invoke(damage);
return DamageResult.Applied;
}
public void Heal(int amount)
{
if (amount <= 0 || IsDead || CurrentHealth >= MaxHealth)
return;
// 先计算剩余血量缺口,避免相加时溢出。
CurrentHealth += Mathf.Min(amount, MaxHealth - CurrentHealth);
HealthChanged?.Invoke(CurrentHealth, MaxHealth);
}
public void Revive(int health)
{
// 新生命周期开启时重置命中历史。
recentIds.Clear();
hitOrder.Clear();
CurrentHealth = Mathf.Clamp(health, 1, MaxHealth);
HealthChanged?.Invoke(CurrentHealth, MaxHealth);
}
[ContextMenu("运行伤害自测")]
private void RunDamageTest()
{
if (!Application.isPlaying)
{
Debug.LogWarning("请先进入 Play 模式");
return;
}
Revive(MaxHealth);
int deathCount = 0;
Action<DamageInfo> countDeath = _ => deathCount++;
Died += countDeath;
try
{
Debug.Log($"首次:{ApplyDamage(new DamageInfo(101, gameObject, 30))},HP={CurrentHealth}");
Debug.Log($"重复:{ApplyDamage(new DamageInfo(101, gameObject, 30))},HP={CurrentHealth}");
Debug.Log($"致死:{ApplyDamage(new DamageInfo(102, gameObject, 200))},HP={CurrentHealth}");
Debug.Log($"死后:{ApplyDamage(new DamageInfo(103, gameObject, 10))},HP={CurrentHealth}");
Debug.Log($"死亡通知次数:{deathCount}");
Revive(MaxHealth);
Debug.Log($"复活:HP={CurrentHealth}");
}
finally
{
Died -= countDeath;
}
}
}预期结果:组件挂载成功并在 Play 模式执行“运行伤害自测”,当 Max Health = 100 时,Console 依次出现以下消息:
首次:Applied,HP=70
重复:Duplicate,HP=70
致死:Applied,HP=0
死后:Dead,HP=0
死亡通知次数:1
复活:HP=100在场景中挂载并验证
- 在 Unity 6 编辑器中选择玩家根对象,进入 Inspector → Add Component,搜索
Health并添加;将Max Health设为100。敌人预制体也可以独立挂载同一组件。 - 打开 Window → General → Console,进入 Play 模式。展开
Health组件标题右侧的菜单,选择运行伤害自测。 - 对照上面的六行输出。重复命中保持
70、超额伤害归零、死亡通知恰好一次、复活回到100,四项均满足才算通过。 - 再把
Max Health改为150并重新进入 Play 模式;首次受击应为120,说明上限来自组件配置,而不是写死在攻击代码中。
让战斗、血条和死亡流程各管一件事
武器在确认有效命中后,调用目标 Health.ApplyDamage(new DamageInfo(hitId, attacker, 25))。hitId 应由战斗会话统一分配;同一次命中的碰撞回调重试必须传入同一值。返回 Applied 才代表生命值确实改变;Duplicate 和 Dead 不应再次产生命中计数或奖励。
HUD 在 OnEnable 订阅 HealthChanged,在 OnDisable 取消订阅,并在所有组件完成初始化后读取一次 CurrentHealth 和 MaxHealth 设置初始血条。例如收到 (70, 100) 时,填充比例为 0.7。受击音效或受击动画监听 Damaged,可以从 DamageInfo.Source 获取攻击者位置,而不反向修改生命值。
死亡控制器监听 Died,按顺序停用角色输入、启动已配置的死亡动画、等待重生点就绪,再调用 Revive(100) 或 Revive(MaxHealth)。重生时还要清除旧攻击碰撞与延迟伤害任务,避免复活后收到上一条生命周期的迟到命中;Health 不负责自动销毁角色或切换场景。
排查容易漏掉的边界
| 检查情景 | 应有行为 |
|---|---|
Amount = 0 或 HitId = 0 |
返回 Invalid,生命值不变 |
同一 HitId 在窗口内触发两次 |
第二次返回 Duplicate |
剩余 20 点承受 200 点伤害 |
生命值变成 0,Died 只发一次 |
| 死亡后继续承受正数伤害 | 返回 Dead,不再广播受击与死亡 |
生命值 90/100,调用 Heal(50) |
恢复至 100,不会溢出上限 |
调用 Revive(0) |
恢复至 1,并清空去重缓存 |
最近 128 条是有限去重窗口,不承诺拦截窗口外的极迟到回调。如果项目存在长时间延迟重传,应改用带生命周期标识的命中记录。生命值组件保证数值与事件一致,跨生命周期的攻击失效仍需战斗系统共同处理。