游戏引擎 / 系统课时

封装生命值和伤害处理组件

封装生命值和伤害处理组件

这一课把玩家和敌人的生命值收口到一个 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。

csharp
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 依次出现以下消息:

text
首次:Applied,HP=70
重复:Duplicate,HP=70
致死:Applied,HP=0
死后:Dead,HP=0
死亡通知次数:1
复活:HP=100

在场景中挂载并验证

  1. 在 Unity 6 编辑器中选择玩家根对象,进入 Inspector → Add Component,搜索 Health 并添加;将 Max Health 设为 100。敌人预制体也可以独立挂载同一组件。
  2. 打开 Window → General → Console,进入 Play 模式。展开 Health 组件标题右侧的菜单,选择 运行伤害自测。
  3. 对照上面的六行输出。重复命中保持 70、超额伤害归零、死亡通知恰好一次、复活回到 100,四项均满足才算通过。
  4. 再把 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 条是有限去重窗口,不承诺拦截窗口外的极迟到回调。如果项目存在长时间延迟重传,应改用带生命周期标识的命中记录。生命值组件保证数值与事件一致,跨生命周期的攻击失效仍需战斗系统共同处理。

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

目录与阅读设置

阅读设置

17

记录一个想法

封装生命值和伤害处理组件

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

登录哪都通