74 lines
4.0 KiB
Markdown
74 lines
4.0 KiB
Markdown
# 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.
|