Testing

Goanna is tested at three levels: native C++ tests that need no Godot, headless Godot scripts that need no GPU, and rendered runs against a real server. Rendered runs go through tools/goanna-headless or the render service, never as a window on someone's desktop; the rules are in agent interfaces.

For what a change costs in frame time, see benchmarking graphics settings and the rendering baseline. For whether a release is ready, see the launch target.

Native and headless checks

Native tests are built in build/. They are not part of the default build, so cmake --build build never rebuilds them and a ./build/<test> run can execute a binary days older than its sources. Build and run all of them with:

cmake --build build --target check

To run one, build it by name in the same command, for example cmake --build build --target goanna_lod_test && ./build/goanna_lod_test. A new test source must be added to GOANNA_NATIVE_TESTS in CMakeLists.txt; configuring fails until it is.

goanna_animation_test feeds the animation messages a Luanti 5.17 server sends, and the shorter ones an older server sends, through the transplanted active object and checks the joints the tracks pose: by priority, by name and by number, blended, and back at rest once stopped.

goanna_item_icon_test builds node definitions with no server, runs them through upstream's node visuals and item mesh, and checks the inventory icons Goanna draws from them: a mesh node on a texture atlas keeps its outline with no holes, where the old folded cube had 476 in the same test, and a cube, a slab and an alpha blended cube come out with vanilla's orientation, lighting and draw order.

Godot integration checks can be run headlessly with the project's Godot binary, for example:

Godot --headless --path project \
  --script res://tests/local_server_terrain_diffusion.gd

Local server discovery (including system game paths outside the desktop session's PATH) can be checked with:

godot --headless --path project --script res://tests/local_server_discovery.gd

The Luanti server the Linux release carries is built in a container from the pinned luanti/ submodule, into dist/luanti-server/, which tools/release/package-release.sh linux requires:

tools/release/build-luanti-server.sh

Get ready to play from nothing (no Luanti, no Flatpak) to a server listening on a new Mineclonia world is checked in clean Ubuntu, Debian, Fedora and Arch containers, with network access for the game download:

GODOT_BIN=/path/to/godot tools/test/test-fresh-install.sh

On a machine whose default podman storage is broken, set PODMAN to the command with --root and --runroot (both scripts say how).

The Appearance grade's twilight and night bypass, its curve endpoints and monotonicity, and its texture cache are checked with:

godot --headless --path project --script res://tests/look_grade.gd

An asset bundle's archive hash, payload hashes and composed profile are checked by installing one into a scratch root. It names the bundle and the hash it must match, so it also demonstrates that a superseded hash is refused:

GOANNA_TEST_ASSET_BUNDLE=dist/assets/org.goanna.minetest-game.terrain-1.1.0.zip \
GOANNA_TEST_ASSET_SHA256=$(python3 -c "import json;print([b for b in \
  json.load(open('asset_bundles/catalogue.json'))['bundles'] \
  if b['id']=='org.goanna.minetest-game.terrain'][0]['sha256'])") \
godot --headless --path project --script res://tests/asset_store_install.gd

That needs a published bundle to hand. With nothing to hand, a small bundle built by tools/pbr/pbr_bundle.py from textures the test writes, with stems that are prefixes of one another, is installed into an empty store the way a downloaded one is, and the composed textures directory is checked file by file. It needs python3 with Pillow:

godot --headless --path project --script res://tests/asset_bundle_install.gd

The catalogue wiring, that catalogue_url is absolute and that every bundle URL is absolute so nothing has to resolve against the catalogue's own location, is checked with:

godot --headless --path project --script res://tests/asset_catalogue.gd

Which bundles a media announcement queues, including that a name two games both use (Mineclonia and Minetest Game share about thirty default_* stems) queues neither of them, is checked with a stub client, so it needs no server:

godot --headless --path project --script res://tests/asset_updater.gd

Controller input, from synthetic joypad events through to the keys handed to the client and the cursor's pushed mouse events, is checked with:

godot --headless --path project --script res://tests/gamepad.gd

The terrain world catalogue that the world picker is built from, including that every world has a usable hash, size, tile window and bundled preview, is checked with:

godot --headless --path project --script res://tests/terrain_catalogue.gd

Point it at a downloaded world as well to check the published archive unpacks to the tile window its catalogue entry claims, which is the step between a verified download and a world that loads:

GOANNA_TEST_TERRAIN_ARCHIVE=/path/to/tdl-default-1m-v4.zip \
GOANNA_TEST_TERRAIN_ID=tdl-default-1m-v4 \
godot --headless --path project --script res://tests/terrain_catalogue.gd

The shader pack folder and setting (project/game/shader_packs.gd): which entries count as packs, unpacking a zip once and again when it changes, the options a pack offers and saving each pack's overrides, is checked in a scratch folder of its own with:

godot --headless --path project --script res://tests/shader_packs.gd

Use git diff --check and the style checker before submitting. Deterministic visual fixtures and capture conventions are described in building and running and shader pack testing.