動くものの挙動をテストする（時間を引数で進める設計）

弾が飛び、敵が降りてきて、当たれば消える。こういう毎フレーム動くものは「遊んでみないと分からない」と思われがちです。

4本目のゲームでは、遊ばずに確かめられる形にしました。方法は1つだけです。

時間を、外から渡す。

Tick(float dt) にする

ゲームの中身（自機・弾・敵・当たり判定・点）は、MonoBehaviour ではない普通のクラスに置いています。時間は外から渡します。

public void Tick(float dt, in InputState input)
{
    if (State != BattleState.Playing) return;

    Time += dt;
    MovePlayer(dt, input);
    UpdateTimers(dt);
    Fire(dt);
    MoveShots(dt);
    MoveEnemies(dt);
    HitEnemies();
    HitPlayer();
}

Unity 側（Update）がすることは、これだけになります。

void Update()
{
    _director.Tick(Time.deltaTime, Battle);
    Battle.Tick(Time.deltaTime, ReadInput());
    _view.Render(Battle);
}

テストからは、1/60 秒を好きな回数だけ渡します。

const float Frame = 1f / 60f;

static void Run(Battle battle, float seconds, InputState input)
{
    int frames = (int)(seconds / Frame);
    for (int i = 0; i < frames; i++) battle.Tick(Frame, input);
}

エンジンを参照しないことを、コンパイラに守らせる

「Unity に依存しないように書く」は、気をつけているだけでは守れません。asmdef の設定で参照そのものを切りました。

{
  "name": "Mureuchi.Core",
  "noEngineReferences": true,
  "references": []
}

こうすると Vector2 も Mathf も使えません。座標は自前の小さな構造体にしています。

public readonly struct Vec2
{
    public readonly float X;
    public readonly float Y;

    /// <summary>長さの2乗。距離の比較はこれで足りる（平方根を取らない）</summary>
    public float SqrMagnitude => X * X + Y * Y;
}

種を決めれば、同じ波が出る

敵の出方は乱数です。そのままだとテストで固定できないので、種を渡せる乱数を自前で持っています（xorshift・十数行）。

public uint NextUInt()
{
    uint x = _state;
    x ^= x << 13;
    x ^= x >> 17;
    x ^= x << 5;
    _state = x;
    return x;
}

これで「同じ種なら同じ波」が保証でき、こういうテストが書けます。

[Test]
public void 同じ種なら同じ波が出る()
{
    Assert.That(Play(2026, 20f), Is.EqualTo(Play(2026, 20f)));
}

Play は20秒ぶん回して、出てきた敵の種類と位置を文字にして返すだけです。同じ文字になれば同じ波。

実際に書いたテスト

最後の2つは、遊びでは気づけない種類のバグを捕まえます。

run_tests	true	32/32 件成功 (EditMode, 0.82s)

dt を固定しないと再現しない

1つ注意があります。同じ種でも、渡す時間（dt）が違えば結果は変わります。 実機の Time.deltaTime は毎フレーム揺れるので、テストと本番でまったく同じにはなりません。

まとめ

• 動くものは Tick(float dt) にする。時間を外から渡せば、テストから何万フレームでも回せる
• Core は noEngineReferences。エンジンの型が混ざらないことをコンパイラに守らせる
• 乱数は種つき。同じ種なら同じ波＝あとから同じ場面を作れる
• 「長く回す」「確保が増えない」は、遊びでは気づけないバグを捕まえる
• dt が違えば結果は変わる。テストが守るのは決まりごとであって、実機の画そのものではない