Files
tidewall/docs/DEVLOG.md
T
2026-11-10 14:47:41 -05:00

6.8 KiB
Raw Blame History

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 Logger API (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.sh forces --headless and keeps engine data in .godot-home/. F7 can set TIDEWALL_GODOT_DISPLAY=1 inside its container only.
  • Untyped declarations are errors, set in project.godot.
  • .gitattributes can't filter by size, so tools/check_binaries.sh fails make check on any tracked binary over 1 MB that isn't in LFS.
  • Player movement in Simulation is a flat placeholder until v0.2 replaces it.
  • Scanning for unseeded randomness uses a regex that tells randf() from a seeded stream.randf(). Only sim_rng.gd may 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, and make smoke, which is now part of make check.
  • F7 (#7): tools/capture.sh, which renders in a throwaway tidewall-capture-* container (debian:13, Xvfb, Mesa) with no network, plus make capture-test.
  • v0.1 Foundations milestone closed and tagged v0.1.0, on its due date.
  • W1 (#8): SimGround, Movement, CameraRig, InputSettings and PlayerCamera.
  • 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, so capture.sh fails 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.sh refreshes the class cache headless on the host before rendering, and captures/ 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.
  • WanderBot is 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.

2026-11-10 (afternoon): W2, W3 and W4

Done:

  • W2 (#9): Island.generate(seed), a 513 × 513 heightfield at 2 m over the 1,024 m world, with a warped coast, a shelf and interior dome, 2 to 4 summits on ridges, marsh, and elevation bands. Simulation generates it; the server logs world_hash. tools/island_map.gd draws top-down maps.
  • W3 (#10): TerrainView and TerrainChunkBuilder, 64 m chunks at four detail levels, built on worker threads, with skirts at the seams and a procedural splat shader. make terrain-capture proves no cracks against a skirtless control.
  • W4 (#11): PoiSet and Poi, six original POI kinds from modular parts, 10 to 16 per island, with loot markers and walk routes. PoiView draws them as MultiMeshes. SimGround now indexes solids in 8 m cells.
  • Opened #71 (H8) to watch a one-off 238 ms streaming frame seen under host load.

Tests: make check passes: 120 tests, self-check and smoke (p95 tick 0.47 ms with 24 bots and about 300 POI solids). make check now takes about 2.5 minutes, mostly the 100-seed island sweep. make terrain-capture passes (control 437 crack pixels, real 0). Captures checked by eye: island maps of seeds 1 to 4, terrain, terrain_lod, terrain_cracks, and poi_* for all six kinds.

Decisions:

  • The island is about 1 km across, not the 2 km in W2's text, because the world and the snapshot position range are 1,024 m. Reasoning is on #9.
  • Worldgen and POI placement each use their own SimRng(seed) copy, so generating them on a client never shifts the match's gameplay streams.
  • Simulation.new(seed) generates the island; tests that don't care pass SimGround.flat() as the second argument to skip worldgen.
  • Terrain seams use skirts, not edge stitching, so chunks never need to know their neighbours' levels. Skirt depth is computed per chunk from the actual edge error.
  • The streaming budget is measured as main-thread wall time in TerrainView._process, headless. It can't see GPU upload cost.
  • Movement change: step-up tests the body at the height it will step up to. The W4 traversal test showed the lighthouse stair was impassable without it. Treads must be at least the player radius (0.4 m) deep; the POI stairs use 0.5 m.
  • POI solids are axis-aligned boxes, rotated only in quarter turns.
  • Summit stone was darkened after the shrine capture read as snow.

Known gaps: no water yet, so piers and coasts show bare sea floor (W6). POIs and lowland are blockout visuals until W5 vegetation and the v0.6 art pass. Frame times and feel still need a real GPU.

Pace: v0.2 is due at the end of today and W5, W6 and W7 remain, so it will finish about a day late. Next by the work order is W5 (#12, no priority label), then W6 (#13, water, core) and W7 (#14, the drop). If the next run finds v0.2 more than a day behind, defer W5 per the pacing rule and do W6 and W7 first.