OneAbove.Arena.GameContract.Testing 3.0.1

OneAbove.Arena.GameContract.Testing

Die Prüfung, die jedes Regelmodul der One-Above Arena bestehen muss.

Sie ist keine Empfehlung: die Plattform übernimmt keine Modulversion, deren Suite nicht grün gelaufen ist. Sie tritt an die Stelle des Code-Reviews, das es zwischen den Repos nicht gibt.

Benutzung

Erben, zwei Glieder ausfüllen, fertig:

using OneAbove.Arena.GameContract.Testing;

public sealed class MeinSpielVertragstest
    : GameEngineContract<MeinState, MeinZug, MeineSicht>
{
    protected override IGameEngine<MeinState, MeinZug, MeineSicht> Engine { get; }
        = new MeinSpiel();

    protected override MatchSetup Setup { get; } = new()
    {
        SeatCount = 2,
        RngSeed = 4711,
    };
}

Das prüft Reinheit, Determinismus, die Serialisierungsrunde, Totalität, Undichtigkeit und das Partie-Ende — und spielt dabei selbsttätig einige Züge, damit nicht nur der Startzustand geprüft wird.

⚠️ Der eine Haken, den du ausfüllen musst

Hat dein Spiel verdeckte Information — Handkarten, verdeckte Gebote, geheime Ziele — dann musst du sagen, was geheim ist. Sonst ist der Undichtigkeitstest grün und hat nichts geprüft:

protected override IEnumerable<string> GeheimnisseVon(MeinState state, Seat seat) =>
    state.Haende[seat.Index].Select(karte => karte.Id);

Die Suite prüft dann, dass keine dieser Zeichenketten in der Sicht eines anderen Sitzes oder in der Zuschauersicht vorkommt.

Bei einem Spiel mit vollständig offener Information (Schach, Vier gewinnt) bleibt die Vorgabe richtig — dort greift der Kanarienvogel: der Seed der Partie darf in keiner Sicht stehen.

Goldene Partien

Aufgezeichnete Partien, bit-identisch nachgespielt. Die einzige Verteidigung gegen eine Änderung, die niemand für eine Regeländerung gehalten hat.

GoldenGameRunner.Verify(GoldenGameFile.Load("2026-09-06-erste-partie.json"), engine);

Wenn ein goldener Test rot wird, ist die erste Frage nicht „was ist an der Aufzeichnung falsch", sondern: haben wir gerade die Regeln geändert?

• Absichtlich ⇒ GameVersion erhöhen und eine neue Aufzeichnung anlegen. Die alte bleibt liegen und muss unter ihrer alten Version weiter grün sein — sie ist der Beweis, dass laufende Partien nachspielbar bleiben.
• Unabsichtlich ⇒ du hast gerade einen Fehler gefunden.

Was diese Suite nicht prüft

Deine Spielregeln. Dass ein Turm nicht diagonal zieht, merkt hier niemand. Dafür sind deine eigenen Tests da.