游戏引擎 / 系统课时
用 EditMode 测试战斗规则
用 EditMode 测试战斗规则
修改伤害、冷却或背包逻辑后,旧边界条件可能悄悄失效。本课使用 Unity 6 的 Unity Test Framework 编写 EditMode 测试,覆盖生命值、伤害异常值、冷却临界时刻与库存扣减,让回归问题在不启动关卡时就被发现。
学习目标
- 创建能引用游戏规则程序集的 EditMode 测试程序集。
- 使用
[Test]和[TestCase]检查正常值、边界值和非法输入。 - 从失败断言定位规则回归,验证扣减失败时状态不变。
创建 EditMode 测试环境
EditMode 适合不依赖场景加载、物理步进或动画帧的规则函数。本例将业务代码与测试代码分成两个程序集,适用于 Unity 6(6000.x)。
- 打开
Window > Package Manager,在In Project中确认已安装 Test Framework(包名com.unity.test-framework);若没有,在Unity Registry中安装。 - 在 Project 窗口建立
Assets/Scripts/Rules,选中该目录,执行Assets > Create > Scripting > Assembly Definition,将程序集命名为Game.Rules。 - 选中
Assets,执行Assets > Create > Testing > Test Assembly Folder,创建带.asmdef的测试目录。首次创建通常得到Assets/Tests;如果已有测试目录,以实际生成的目录为准。将新测试程序集命名为Game.EditModeTests。 - 选中测试
.asmdef,在 Inspector 将Platforms设为仅Editor,在Assembly Definition References添加Game.Rules,点击Apply。保留创建工具自动加入的 NUnit 和 Test Runner 引用。 - 在测试目录中创建
CombatRulesTests.cs;下面的生产代码另存为Assets/Scripts/Rules/CombatRules.cs。
创建入口与程序集引用的详细说明可对照 Unity 6 官方测试程序集文档。
抽出可独立计算的战斗规则
下面约定生命值被限制在 0 到 maxHp,负数伤害与负数治疗量视为调用错误;技能在 nowMs - lastUseMs >= cooldownMs 时可释放;背包数量不足必须整体拒绝,库存保持原值。冷却使用传入的非负毫秒时间戳,测试无需等待真实时间。
以下是完整的生产规则类,需要放入前面创建的 Unity 项目程序集,而不是作为独立控制台程序运行。
Assets/Scripts/Rules/CombatRules.cs:
using System;
namespace Game.Rules
{
public static class CombatRules
{
public static int Damage(int hp, int maxHp, int damage)
{
if (maxHp <= 0) throw new ArgumentOutOfRangeException(nameof(maxHp));
if (damage < 0) throw new ArgumentOutOfRangeException(nameof(damage));
// 先清理越界状态,再扣伤害,避免结果小于零。
int safeHp = Math.Max(0, Math.Min(hp, maxHp));
return (int)Math.Max(0L, (long)safeHp - damage);
}
public static int Heal(int hp, int maxHp, int amount)
{
if (maxHp <= 0) throw new ArgumentOutOfRangeException(nameof(maxHp));
if (amount < 0) throw new ArgumentOutOfRangeException(nameof(amount));
int safeHp = Math.Max(0, Math.Min(hp, maxHp));
// 用 long 做加法,避免极大治疗量导致 int 溢出。
return (int)Math.Min(maxHp, (long)safeHp + amount);
}
public static bool CanUseSkill(long nowMs, long lastUseMs, long cooldownMs)
{
if (nowMs < 0) throw new ArgumentOutOfRangeException(nameof(nowMs));
if (lastUseMs < 0) throw new ArgumentOutOfRangeException(nameof(lastUseMs));
if (cooldownMs < 0) throw new ArgumentOutOfRangeException(nameof(cooldownMs));
// 时间回退时不允许误判为冷却结束。
return nowMs >= lastUseMs && nowMs - lastUseMs >= cooldownMs;
}
public static bool TryConsume(ref int quantity, int count)
{
if (quantity < 0) throw new ArgumentOutOfRangeException(nameof(quantity));
if (count <= 0) throw new ArgumentOutOfRangeException(nameof(count));
// 不足时不修改库存,保证一次操作要么全成功要么全失败。
if (quantity < count) return false;
quantity -= count;
return true;
}
}
}预期行为:Damage(10, 100, 99) 返回 0,Heal(95, 100, 10) 返回 100,CanUseSkill(1500, 1000, 500) 返回 true;库存只有 2 件时尝试消耗 3 件返回 false,原数量仍为 2。
这些方法没有 MonoBehaviour、单例、Time.time 或场景依赖。实际项目中应由生命值组件、技能组件和背包组件调用同一组规则方法,EditMode 测试才具备回归价值。
编写正常与异常测试
NUnit 的 [TestCase] 会把每组参数展开为单独测试,Assert.That 检查返回值;Assert.Throws 检查非法输入是否真的被拒绝。库存失败用例同时断言返回 false 和数量未改变,避免只检测提示而漏掉数据损失。
将下面的完整测试类保存到测试程序集目录中的 CombatRulesTests.cs:
using System;
using Game.Rules;
using NUnit.Framework;
public class CombatRulesTests
{
[TestCase(70, 20, 50)]
[TestCase(10, 99, 0)]
[TestCase(100, 0, 100)]
[TestCase(150, 10, 90)]
public void Damage_ClampsHealth(int hp, int damage, int expected)
{
Assert.That(CombatRules.Damage(hp, 100, damage), Is.EqualTo(expected));
}
[TestCase(70, 20, 90)]
[TestCase(95, 10, 100)]
[TestCase(0, 0, 0)]
public void Heal_DoesNotExceedMaximum(int hp, int amount, int expected)
{
Assert.That(CombatRules.Heal(hp, 100, amount), Is.EqualTo(expected));
}
[Test]
public void Damage_RejectsNegativeAmount()
{
Assert.Throws<ArgumentOutOfRangeException>(
() => CombatRules.Damage(70, 100, -1));
}
[TestCase(1499L, 1000L, 500L, false)]
[TestCase(1500L, 1000L, 500L, true)]
[TestCase(2000L, 1000L, 500L, true)]
[TestCase(999L, 1000L, 500L, false)]
public void Cooldown_ChecksBoundary(
long nowMs, long lastUseMs, long cooldownMs, bool expected)
{
Assert.That(CombatRules.CanUseSkill(nowMs, lastUseMs, cooldownMs),
Is.EqualTo(expected));
}
[Test]
public void Inventory_ConsumesOnlyRequestedAmount()
{
int quantity = 3;
Assert.That(CombatRules.TryConsume(ref quantity, 2), Is.True);
Assert.That(quantity, Is.EqualTo(1));
}
[Test]
public void Inventory_InsufficientStockIsAtomic()
{
int quantity = 2;
Assert.That(CombatRules.TryConsume(ref quantity, 3), Is.False);
Assert.That(quantity, Is.EqualTo(2));
}
[Test]
public void Inventory_RejectsZeroConsumption()
{
int quantity = 2;
Assert.Throws<ArgumentOutOfRangeException>(
() => CombatRules.TryConsume(ref quantity, 0));
Assert.That(quantity, Is.EqualTo(2));
}
}预期结果:测试程序集编译后,Test Runner 能发现 15 个测试用例,分别为伤害 5 个、治疗 3 个、冷却 4 个、库存 3 个。所有测试应通过,其中 1499/1500 ms 专门检查冷却边界,库存不足用例检查扣减的原子性。
测试覆盖的关键输入可以整理成下表,便于后续修改规则时检查是否漏测:
| 规则 | 输入 | 期望结果 |
|---|---|---|
| 普通伤害 | HP 70,伤害 20 | HP 50 |
| 过量伤害 | HP 10,伤害 99 | HP 0 |
| 非法伤害 | 伤害 -1 | 抛出参数异常 |
| 治疗上限 | HP 95,治疗 10,上限 100 | HP 100 |
| 冷却未到 | 当前 1499 ms,上次 1000 ms,冷却 500 ms | 不可释放 |
| 冷却刚到 | 当前 1500 ms,上次 1000 ms,冷却 500 ms | 可以释放 |
| 库存不足 | 库存 2,消耗 3 | 拒绝操作,库存仍为 2 |
运行、验证与排查失败
- 等待脚本编译结束,打开
Window > General > Test Runner,选择EditMode。 - 展开
Game.EditModeTests,执行Run All。预期结果:15 个测试通过、0 个失败,无须进入 Play Mode。 - 做一次回归演练:暂时把
CanUseSkill最后的>= cooldownMs改成> cooldownMs,重新运行。预期结果:Cooldown_ChecksBoundary(1500,1000,500,true)失败,实际值为false、期望值为true;恢复>=后再次全部通过。 - 如果测试树里没有
CombatRulesTests,先查看 Console 是否有编译错误,再确认测试.asmdef仅勾选Editor、有 NUnit 引用且引用了Game.Rules。若提示找不到Game.Rules命名空间,应优先修正程序集引用,不要把测试类复制到运行时代码目录。
后续每次修改伤害公式、治疗上限、冷却计算或背包扣减,都先运行这组 EditMode 测试;角色动画、物理碰撞和 UI 交互则另用 PlayMode 测试覆盖。