游戏客户端架构 / 系统课时
一个战斗流程该拆成哪些事件
一个战斗流程该拆成哪些事件
一次战斗攻击会影响伤害计算、角色生命值、死亡判定、奖励发放和界面表现。如果所有模块都在攻击函数中互相调用,规则修改便会牵动大量代码。本课从一个完整战斗过程出发,拆分具有明确业务含义的事件,并区分领域事实、用户意图和表现层更新。
学习目标
- 识别战斗过程中值得发布的领域事件,避免把每个函数调用都变成事件。
- 设计攻击、受伤、死亡、奖励和 UI 之间的事件依赖关系。
- 通过可运行的最小战斗示例验证事件顺序、状态变化和重复处理边界。
先区分操作意图和已经发生的事实
玩家点击攻击按钮,表示希望角色发动攻击,但此时攻击还没有成功。游戏可能因为目标无效、冷却未结束或角色状态不允许而拒绝这次操作。
因此,AttackRequested 更适合作为命令或操作意图,而不是表示攻击已经发生的领域事件。
当战斗系统完成合法性检查与命中结算后,才可以发布 AttackResolved,通知其他模块攻击结果已经确定。
区分两者的核心标准是:命令表达希望系统做什么,领域事件表达系统已经确认发生了什么。
一个最小战斗过程可以采用以下事件契约:
| 名称 | 类型 | 触发时机 | 主要数据 |
|---|---|---|---|
AttackRequested |
命令 | 玩家发起攻击意图 | attackerId、targetId |
AttackResolved |
领域事实 | 命中与伤害计算完成 | attackId、targetId、isHit、damage |
HealthChanged |
领域事实 | 生命值状态已经更新 | targetId、previousHp、currentHp |
EnemyDied |
领域事实 | 生命值首次从正数降到零 | deathId、targetId |
RewardGranted |
领域事实 | 奖励状态已经成功更新 | deathId、amount |
这些载荷只包含订阅者理解事实所必需的数据。诸如 HUD 控件引用、粒子对象和动画播放器等表现层对象,不应放入领域事件。
沿着状态变化拆出事件链
事件拆分不应直接照搬现有函数的调用顺序,而应寻找具有独立业务含义的状态变化。
对一次命中的攻击而言,核心流程是:攻击系统确认命中结果,生命值系统写入新的 HP,死亡系统确认角色是否从存活变成死亡,奖励系统在符合条件时发放奖励。
这些节点可能触发不同后续动作,因此适合由事件连接。

这条事件链包含几个重要分支。
攻击未命中时,可以发布包含未命中结果的 AttackResolved,但不应该产生虚假的 HealthChanged。攻击命中但目标仍然存活时,只产生生命值变化,不产生死亡事件。只有生命值首次降到零,才发布 EnemyDied。
奖励事件也不能在死亡事件发布的瞬间无条件产生。奖励系统必须先检查奖励规则,成功更新奖励状态之后,再发布 RewardGranted。
对于 UI,通常不必额外发布通用的 UIChanged 领域事件。HUD 可以订阅 HealthChanged 更新血条,奖励面板可以订阅 RewardGranted 显示奖励,音效与特效系统也可以独立订阅相关事实。
这样,增加一种受击音效不需要修改生命值系统,替换 HUD 也不会影响死亡与奖励规则。
用最小事件总线跑通战斗流程
下面使用 .NET 8 控制台程序构建一个简化战斗场景:敌人初始生命值为 25,玩家先造成 10 点伤害,再造成 20 点伤害,最后尝试继续攻击已经死亡的敌人。
事件总线按照事件类型管理订阅者。战斗系统负责改变生命值,HUD 只处理显示,奖励订阅者则在死亡事件到达后执行奖励逻辑。
在 .NET 8 控制台项目中,将以下代码保存为 Program.cs,执行 dotnet run。
using System;
using System.Collections.Generic;
var bus = new EventBus();
var hp = 25;
var gold = 0;
var processedDeaths = new HashSet<string>();
bus.Subscribe<AttackResolved>(e =>
Console.WriteLine($"Combat: attack={e.AttackId} damage={e.Damage}"));
bus.Subscribe<HealthChanged>(e =>
Console.WriteLine($"HUD: HP {e.PreviousHp}->{e.CurrentHp}"));
bus.Subscribe<EnemyDied>(e =>
{
Console.WriteLine($"Combat: died={e.TargetId}");
// 奖励处理使用死亡事件标识去重,而不是依赖回调执行次数。
if (!processedDeaths.Add(e.DeathId)) return;
gold += 50;
bus.Publish(new RewardGranted(e.DeathId, 50));
});
bus.Subscribe<RewardGranted>(e =>
Console.WriteLine($"HUD: gold +{e.Amount}, total={gold}"));
void Attack(string attackId, int damage)
{
if (hp == 0) return;
bus.Publish(new AttackResolved(attackId, "enemy-1", damage));
var previousHp = hp;
hp = Math.Max(0, hp - damage);
// 先提交生命值变化,再发布事实事件供UI使用。
bus.Publish(new HealthChanged("enemy-1", previousHp, hp));
if (previousHp > 0 && hp == 0)
bus.Publish(new EnemyDied($"death-{attackId}", "enemy-1"));
}
Attack("atk-1", 10);
Attack("atk-2", 20);
Attack("atk-3", 20);
record AttackResolved(string AttackId, string TargetId, int Damage);
record HealthChanged(string TargetId, int PreviousHp, int CurrentHp);
record EnemyDied(string DeathId, string TargetId);
record RewardGranted(string DeathId, int Amount);
sealed class EventBus
{
private readonly Dictionary<Type, List<Delegate>> handlers = new();
public void Subscribe<T>(Action<T> callback)
{
if (!handlers.TryGetValue(typeof(T), out var list))
handlers[typeof(T)] = list = new List<Delegate>();
list.Add(callback);
}
public void Publish<T>(T message)
{
if (!handlers.TryGetValue(typeof(T), out var list)) return;
// 使用快照,避免派发期间订阅集合变化影响本轮遍历。
foreach (var callback in list.ToArray())
((Action<T>)callback)(message);
}
}预期输出:
Combat: attack=atk-1 damage=10
HUD: HP 25->15
Combat: attack=atk-2 damage=20
HUD: HP 15->0
Combat: died=enemy-1
HUD: gold +50, total=50第一次攻击只改变生命值,因此不会产生死亡和奖励事件。第二次攻击让生命值降到零,触发死亡事件,奖励订阅者增加金币后发布 RewardGranted。
第三次攻击没有输出,因为目标已经死亡,战斗逻辑直接返回。这体现了领域状态判断应当由战斗系统负责,而不是交给 HUD 判断。
这个事件总线使用同步立即派发,适合演示事件边界与执行顺序。它没有实现异常隔离、取消订阅、跨线程安全或可靠持久化,也不包含命中失败分支。正式游戏客户端需要根据引擎生命周期与派发策略补齐这些能力。
防止死亡和奖励被重复处理
死亡与奖励是事件设计中最容易产生重复副作用的环节。
假设某个敌人在同一帧内受到两次伤害。如果代码只判断当前生命值是否等于零,两个伤害回调都可能发布死亡事件,导致重复经验值、金币或者掉落物。
正确做法是把死亡定义为一次明确的状态迁移:只有状态从存活变为死亡,才产生死亡事件。
示例使用 previousHp > 0 && hp == 0 识别这个边界,并通过不再处理死亡目标的攻击,阻止重复死亡。
不过,重复事件不只来自战斗逻辑,也可能来自消息重试、存档恢复或网络重放。奖励处理还应以稳定的 deathId 或业务奖励 ID 作为幂等键。
示例中的 HashSet 只能在当前进程存活期间去重。实际存在持久化奖励或联机同步时,需要在权威状态存储中建立唯一约束,并在同一事务或等效的一致性机制中完成去重与奖励更新。
另一个需要避免的错误是让 HUD 在收到 EnemyDied 后直接调用奖励系统发金币。界面可能被关闭、替换或重复创建,不能成为决定奖励是否发放的业务入口。
什么情况下应该增加或合并事件
事件粒度应由业务事实决定,而不是由现有方法数量决定。
值得独立发布事件的情况包括:
- 状态已经发生明确变化,并且可能被多个模块消费。
- 某个结果需要独立记录、测试、回放或追踪。
- 订阅者有不同生命周期,不应该互相持有对象引用。
- 需要为重要副作用建立幂等处理边界。
不值得单独发布全局事件的情况包括:纯粹的内部计算步骤、只有单个函数需要的临时变量变化,以及某个 UI 控件内部的局部布局刷新。
例如,伤害计算中的暴击倍率、护甲减免和最终伤害可以是同一次 AttackResolved 的结果字段,不必默认拆成三个全局事件。如果日后有独立的护盾消耗系统和多个订阅者需要响应护盾状态变化,再考虑增加专门的 ShieldChanged。
判断一个事件是否合理,可以问三个问题:它描述的是已经确定的事实吗?它有明确的状态所有者吗?订阅者是否能够在不直接操作其他模块内部状态的前提下响应它?
按这些标准拆分战斗流程,战斗系统负责确定事实,奖励系统负责可靠执行奖励,表现层负责呈现结果。事件总线只承担通信职责,不替代业务规则与状态所有权。