游戏引擎 / 系统课时

用 EditMode 测试战斗规则

用 EditMode 测试战斗规则

修改伤害、冷却或背包逻辑后,旧边界条件可能悄悄失效。本课使用 Unity 6 的 Unity Test Framework 编写 EditMode 测试,覆盖生命值、伤害异常值、冷却临界时刻与库存扣减,让回归问题在不启动关卡时就被发现。

学习目标

  • 创建能引用游戏规则程序集的 EditMode 测试程序集。
  • 使用 [Test] 和 [TestCase] 检查正常值、边界值和非法输入。
  • 从失败断言定位规则回归,验证扣减失败时状态不变。

创建 EditMode 测试环境

EditMode 适合不依赖场景加载、物理步进或动画帧的规则函数。本例将业务代码与测试代码分成两个程序集,适用于 Unity 6(6000.x)。

  1. 打开 Window > Package Manager,在 In Project 中确认已安装 Test Framework(包名 com.unity.test-framework);若没有,在 Unity Registry 中安装。
  2. 在 Project 窗口建立 Assets/Scripts/Rules,选中该目录,执行 Assets > Create > Scripting > Assembly Definition,将程序集命名为 Game.Rules。
  3. 选中 Assets,执行 Assets > Create > Testing > Test Assembly Folder,创建带 .asmdef 的测试目录。首次创建通常得到 Assets/Tests;如果已有测试目录,以实际生成的目录为准。将新测试程序集命名为 Game.EditModeTests。
  4. 选中测试 .asmdef,在 Inspector 将 Platforms 设为仅 Editor,在 Assembly Definition References 添加 Game.Rules,点击 Apply。保留创建工具自动加入的 NUnit 和 Test Runner 引用。
  5. 在测试目录中创建 CombatRulesTests.cs;下面的生产代码另存为 Assets/Scripts/Rules/CombatRules.cs。

创建入口与程序集引用的详细说明可对照 Unity 6 官方测试程序集文档。

抽出可独立计算的战斗规则

下面约定生命值被限制在 0 到 maxHp,负数伤害与负数治疗量视为调用错误;技能在 nowMs - lastUseMs >= cooldownMs 时可释放;背包数量不足必须整体拒绝,库存保持原值。冷却使用传入的非负毫秒时间戳,测试无需等待真实时间。

以下是完整的生产规则类,需要放入前面创建的 Unity 项目程序集,而不是作为独立控制台程序运行。

Assets/Scripts/Rules/CombatRules.cs:

csharp
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:

csharp
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

运行、验证与排查失败

  1. 等待脚本编译结束,打开 Window > General > Test Runner,选择 EditMode。
  2. 展开 Game.EditModeTests,执行 Run All。预期结果:15 个测试通过、0 个失败,无须进入 Play Mode。
  3. 做一次回归演练:暂时把 CanUseSkill 最后的 >= cooldownMs 改成 > cooldownMs,重新运行。预期结果: Cooldown_ChecksBoundary(1500,1000,500,true) 失败,实际值为 false、期望值为 true;恢复 >= 后再次全部通过。
  4. 如果测试树里没有 CombatRulesTests,先查看 Console 是否有编译错误,再确认测试 .asmdef 仅勾选 Editor、有 NUnit 引用且引用了 Game.Rules。若提示找不到 Game.Rules 命名空间,应优先修正程序集引用,不要把测试类复制到运行时代码目录。

后续每次修改伤害公式、治疗上限、冷却计算或背包扣减,都先运行这组 EditMode 测试;角色动画、物理碰撞和 UI 交互则另用 PlayMode 测试覆盖。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 EditMode 测试战斗规则

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

登录哪都通