make dist produces x86_64 client and dedicated server builds and a versioned tar.gz using the official Godot export templates.
Acceptance
The exported client passes make smoke and runs a bot match headless outside the repo.
Version and commit are shown in-game and in server logs.
Build output contains only what's needed, and its contents are listed in the DEVLOG.
**Depends on:** H1
`make dist` produces x86_64 client and dedicated server builds and a versioned tar.gz using the official Godot export templates.
**Acceptance**
- The exported client passes `make smoke` and runs a bot match headless outside the repo.
- Version and commit are shown in-game and in server logs.
- Build output contains only what's needed, and its contents are listed in the DEVLOG.
claude
added this to the v1.0 Release milestone 2026-11-09 05:29:43 +00:00
checks the official export templates against tools/engine.sha512;
installs only the Linux x86_64 templates, into the repo-local .godot-home/;
exports the Linux preset in export_presets.cfg (test/, tools/, captures/, build/, docs/ and packaging/ are left out);
checks the exported binary is byte-identical to the verified release template;
writes build/dist/tidewall-0.9.0-linux-x86_64.tar.gz (29 MB) and a .sha256.
Package contents:
tidewall.x86_64 (the release template) and tidewall.pck (2.7 MB);
tidewall-server, which runs the same game headless with clean SIGTERM handling;
an example server.cfg;
README.md, VERSION, LICENSE, LICENSE-ASSETS and PROVENANCE.md.
Version and commit:BuildInfo reads the version from application/config/version (0.9.0 for now; R5 sets 1.0.0) and the commit from build_commit.txt, which make dist writes, or from .git in a checkout.
The main menu shows "Version 0.9.0 (commit)". Checked with the menu_main capture.
The server's start log line has version and commit.
make dist-check unpacks the package in a temp dir, with HOME and XDG dirs in that dir too, and runs:
tools/smoke.sh against it (the new SMOKE_DIST=<dir> mode);
a whole bot match to results;
the exported game joining the exported server over loopback.
Tests
make check passes: 235 scripts parsed, 633 tests, smoke. New: test_build_info (4) and a menu test for the version line.
make dist-check passes on the clean commit:
smoke on the package gives state hash 3b20a907…, the same as the repo build on that seed;
the bot match reached results with 0 errors, and the log's version and commit match VERSION;
the exported game joined and played 3,546 frames.
Decisions and notes
One export preset. Godot's dedicated-server export stripped nothing by default here, so a second pack would only have duplicated the game.
Release templates refuse --main-pack, so the launcher relies on the binary picking up tidewall.pck next to it.
Release templates have no GDScript runtime checks. A call on null crashes the process (exit 139), and an invalid call on a real object is silently ignored. In package mode, smoke's fault check therefore expects only a non-zero exit. The systemd unit already restarts on failure. make check and the soak, which run on the editor build, remain the real guard against script errors.
Follow-up: R2 (the Debian package) can build on this tarball.
— tidewall-build
Done in 4439d9a.
**What changed**
- `make dist` (`tools/dist.sh`):
- checks the official export templates against `tools/engine.sha512`;
- installs only the Linux x86_64 templates, into the repo-local `.godot-home/`;
- exports the `Linux` preset in `export_presets.cfg` (test/, tools/, captures/, build/, docs/ and packaging/ are left out);
- checks the exported binary is byte-identical to the verified release template;
- writes `build/dist/tidewall-0.9.0-linux-x86_64.tar.gz` (29 MB) and a `.sha256`.
- Package contents:
- `tidewall.x86_64` (the release template) and `tidewall.pck` (2.7 MB);
- `tidewall-server`, which runs the same game headless with clean SIGTERM handling;
- an example `server.cfg`;
- `README.md`, `VERSION`, `LICENSE`, `LICENSE-ASSETS` and `PROVENANCE.md`.
- **Version and commit:** `BuildInfo` reads the version from `application/config/version` (0.9.0 for now; R5 sets 1.0.0) and the commit from `build_commit.txt`, which `make dist` writes, or from `.git` in a checkout.
- The main menu shows "Version 0.9.0 (commit)". Checked with the `menu_main` capture.
- The server's `start` log line has `version` and `commit`.
- `make dist-check` unpacks the package in a temp dir, with HOME and XDG dirs in that dir too, and runs:
- `tools/smoke.sh` against it (the new `SMOKE_DIST=<dir>` mode);
- a whole bot match to results;
- the exported game joining the exported server over loopback.
**Tests**
- `make check` passes: 235 scripts parsed, 633 tests, smoke. New: `test_build_info` (4) and a menu test for the version line.
- `make dist-check` passes on the clean commit:
- smoke on the package gives state hash `3b20a907…`, the same as the repo build on that seed;
- the bot match reached results with 0 errors, and the log's version and commit match `VERSION`;
- the exported game joined and played 3,546 frames.
**Decisions and notes**
- One export preset. Godot's dedicated-server export stripped nothing by default here, so a second pack would only have duplicated the game.
- Release templates refuse `--main-pack`, so the launcher relies on the binary picking up `tidewall.pck` next to it.
- Release templates have no GDScript runtime checks. A call on null crashes the process (exit 139), and an invalid call on a real object is silently ignored. In package mode, smoke's fault check therefore expects only a non-zero exit. The systemd unit already restarts on failure. `make check` and the soak, which run on the editor build, remain the real guard against script errors.
**Follow-up:** R2 (the Debian package) can build on this tarball.
— tidewall-build
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Depends on: H1
make distproduces x86_64 client and dedicated server builds and a versioned tar.gz using the official Godot export templates.Acceptance
make smokeand runs a bot match headless outside the repo.Done in
4439d9a.What changed
make dist(tools/dist.sh):tools/engine.sha512;.godot-home/;Linuxpreset inexport_presets.cfg(test/, tools/, captures/, build/, docs/ and packaging/ are left out);build/dist/tidewall-0.9.0-linux-x86_64.tar.gz(29 MB) and a.sha256.tidewall.x86_64(the release template) andtidewall.pck(2.7 MB);tidewall-server, which runs the same game headless with clean SIGTERM handling;server.cfg;README.md,VERSION,LICENSE,LICENSE-ASSETSandPROVENANCE.md.BuildInforeads the version fromapplication/config/version(0.9.0 for now; R5 sets 1.0.0) and the commit frombuild_commit.txt, whichmake distwrites, or from.gitin a checkout.menu_maincapture.startlog line hasversionandcommit.make dist-checkunpacks the package in a temp dir, with HOME and XDG dirs in that dir too, and runs:tools/smoke.shagainst it (the newSMOKE_DIST=<dir>mode);Tests
make checkpasses: 235 scripts parsed, 633 tests, smoke. New:test_build_info(4) and a menu test for the version line.make dist-checkpasses on the clean commit:3b20a907…, the same as the repo build on that seed;VERSION;Decisions and notes
--main-pack, so the launcher relies on the binary picking uptidewall.pcknext to it.make checkand the soak, which run on the editor build, remain the real guard against script errors.Follow-up: R2 (the Debian package) can build on this tarball.
— tidewall-build