4.0 KiB
Tidewall development log
Newest entries at the bottom. Each entry records what was done, test results, decisions, and what's next.
2026-11-09: first build run
Done: F1 skeleton and pinned engine, F2 GDD and originality rules, F3 architecture, F4 test harness, F5 simulation core. Commits were made in the order F1, F4, F2, F3, F5, because F2 and F3 add tests that need F4's runner.
Tests: make check passes: engine verified, 18 scripts parsed, 38 tests pass, and
all 8 self-check fixtures behave as expected. The determinism test replays a log of 24
players over 10,000 ticks.
Decisions:
- The test runner uses Godot's
LoggerAPI (OS.add_logger), so engine and script errors during a test fail that test, without having to scrape output. - The tuning table is
src/sim/tuning.gd, as constants, because a misspelled name is a parse error. The GDD refers to numbers by constant name, so it can't go stale. tools/godot.shforces--headlessand keeps engine data in.godot-home/. F7 can setTIDEWALL_GODOT_DISPLAY=1inside its container only.- Untyped declarations are errors, set in
project.godot. .gitattributescan't filter by size, sotools/check_binaries.shfailsmake checkon any tracked binary over 1 MB that isn't in LFS.- Player movement in
Simulationis a flat placeholder until v0.2 replaces it. - Scanning for unseeded randomness uses a regex that tells
randf()from a seededstream.randf(). Onlysim_rng.gdmay create a generator.
Known gaps: the LFS push path hasn't been exercised, as nothing is in LFS yet.
Next: F6 headless server and make smoke, then F7 capture harness.
2026-11-09 (evening): F6, F7, W1 and v0.1.0
Done:
- F6 (#6): headless dedicated server (
tools/godot.sh -- --server ...), JSON-line logs that all carry the seed, exit codes 0, 1 and 2, andmake smoke, which is now part ofmake check. - F7 (#7):
tools/capture.sh, which renders in a throwawaytidewall-capture-*container (debian:13, Xvfb, Mesa) with no network, plusmake capture-test. - v0.1 Foundations milestone closed and tagged
v0.1.0, on its due date. - W1 (#8):
SimGround,Movement,CameraRig,InputSettingsandPlayerCamera. - Opened #70 (H7), graceful shutdown on SIGTERM, as a low-priority hardening follow-up.
Tests: make check passes: 39 scripts parsed, 97 tests, 8 self-check fixtures,
and the smoke run. Smoke with 24 wander bots: p95 tick about 0.4 ms against the 12 ms
budget. make capture-test passes. Captures checked by eye: smoke, camera, camera_wall,
camera_aim.
Decisions:
- Captures default to Forward+ through Lavapipe, the game's renderer. Debian 13's ICD is
lvp_icd.json. Godot silently falls back to OpenGL when Vulkan fails, socapture.shfails when the renderer it got isn't the one it asked for. Compatibility renders brighter than Forward+, so compare captures only within one renderer. capture.shrefreshes the class cache headless on the host before rendering, andcaptures/has a.gdignore.- Look convention fixed: right is forward x up,
(-cos yaw, 0, sin yaw), and turning right decreases yaw. F5 had it mirrored. See ARCHITECTURE.md. - Fall damage comes from landing speed, not drop height, so a capped slide down a steep bank is harmless but a cliff fall isn't.
- The camera casts pivot to shoulder, then backward, then straight from the pivot, and finishes with a clearance pull-in. The 24,480-view sweep found both a steep-slope near-plane clip and over-the-wall occlusion before they shipped.
- The hash-sensitivity test now flips a high stick bit, because a 1/127 nudge to an airborne player is below the hash's millimetre rounding.
WanderBotis a placeholder until the bots in v0.4.
Known gaps: SIGTERM kills the server without a stop line (#70). Mouse feel and frame rates can't be verified without a GPU playtest.
Next: W2, the procedural island generator (#9), then W3 chunked terrain (#10). v0.2 is due at the end of 2026-11-10, with 6 issues left.