beezm/islaApocalypse
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: stepped river water, WBTB type 2, and the C0b finale in the generator README (terrain-water task 23)

Browse source 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Stewart Howe 2026-08-11 19:55:04 -04:00
parent 8f5767308a
commit 645955d49c
3 changed files with 20 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

19
Tools/Scripts/README.md
View file

@ -109,7 +109,24 @@ Generates the entire 2D blueprint. Roughly in order:
sea + `RiverSeaMargin` everywhere (the erosion flood-guard discipline: below-sea cells
read-only, zero new below-sea cells, coastline provably fixed; asserted per generation).
Slots AFTER towns (town placement reads the render map and must not shift) and BEFORE roads.
Crater core excluded. **NO WATER yet** — part 2b waters the gated routing style.
Crater core excluded.
**River water (task 23, C0b finale)** — the payoff. Each carved main river becomes a chain of
**stepped flat water-body REACHES**: a new reach starts every `RiverStepDropM` (2 m) of bed
descent and sits `RiverWaterDepthM` (1.2 m) above its bed, each reach strictly lower than the
one upstream, stepping down to the sea (small vertical drops — riffles — smoothable purely by
the step dial; tilted continuous-slope water is the deferred model B). Reaches are ordinary
water bodies: WBID cells + a WBTB entry (`type 2 = river`, fresh) each; WSRF derives from body
levels exactly as for lakes, and river water renders through the C1/task-13 path with the
task-15 presence rule at its banks. Lake-enders route the last reach into their lake by the
lowground Dijkstra (a pooling terminal IS a local minimum — blind descent dead-ends there);
rivers meet lakes and the sea without repainting them (existing bodies are never overwritten).
Only the lowland reaches are ROUTE-SMOOTHED (RDP+Chaikin, the road pipeline): the upland stems
already thread carved valley floors, and smoothing them off-line cut valley walls (measured).
The BIOME oracle holds (classify untouched; `1_biomes` md5-identical); `0_water` and the
re-captured `0_height` change — that IS the river water and its beds (both snapshots are
re-captured after the river pass so the exported PNGs show them). Max-cut is now reported
CUMULATIVELY vs the pre-pass surface.
3. **Sea level and water** — sea level per the configured model (`SeaLevelModel`: `"flat"` scalar
— the default, `SeaLevelValue` 0.15 — or the legacy `"field"` latitude Lerp); flood fill