Guides¶

Task-oriented documentation for authors writing and maintaining GameTests. Each page is a self-contained recipe; read them in any order.

Writing tests

Holders, ids, batches, cleanup, the required flag, rotations.
Structure templates

Exporting with the wand, the JSON format, placement, rotation safety.
GTNH multiblock API

Multiblock, role-based hatches, time-warp, EU supply, scoped recipes.
Negative assertions

onEachTick, succeedAtTimeout, asserting an invariant over a window.
Sequences & timing

GameTestSequence for ordered steps, delays, and bounded waits.
CI & JUnit reports

XML output, event traces in CI, Gradle and GitHub Actions wiring.
Debugging failed tests

Triage from the XML and event trace, reproduce in-game, iterate.

Lookup-style material (annotations, commands, JVM flags, event catalog) lives under Reference.