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

docs: the 21b mixed promotion in the generator README (terrain-water task 21b)

Browse source 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Stewart Howe 2026-08-11 18:34:02 -04:00
parent 2de9502e4f
commit a53d4e8512
1 changed files with 10 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
Tools/Scripts/README.md
View file

@ -87,10 +87,16 @@ Generates the entire 2D blueprint. Roughly in order:
depressions survive as terminal basins, D8 flow directions + Kahn accumulation build the depressions survive as terminal basins, D8 flow directions + Kahn accumulation build the
drainage network, and the top ~3 TRUE-ocean outlets (the ocean body, WBID 1 — enclosed lagoons drainage network, and the top ~3 TRUE-ocean outlets (the ocean body, WBID 1 — enclosed lagoons
do not count as "the sea") become trunk candidates with lean tributaries, mountain-exit handoff do not count as "the sea") become trunk candidates with lean tributaries, mountain-exit handoff
points, and lean endorheic terminals. Output is a JSON *plan* sidecar + console report — points, and lean endorheic terminals. Task 21b extends the plan to the developer's MIXED
deliberately NOT a blueprint section, so a plan can never masquerade as realized water. Part 2 promotion: the ocean trunks PLUS the top endorheic giants (`RIVERPLAN_GIANT_N`, default 3),
(task 22) carves and waters the gated plan. Pure analysis: the source blueprint is never each classified — a giant whose terminal basin holds a classify lake stays a **lake-ender**
written. (rivers ending in lakes are real geography); a dry-pan giant, and always the **SOUTHERN
CANDIDATE** (the giant pooling nearest the southernmost town), gets a **PROVISIONAL route** to
the ocean: steepest descent on the full (no-terminal) fill, so the basin overtops at its spill
and the walk follows the terrain's own drainage to the sea — drawn dashed for the gate, never
carved. Output is a JSON *plan* sidecar + console report — deliberately NOT a blueprint
section, so a plan can never masquerade as realized water. Part 2 (task 22) carves and waters
the gated plan. Pure analysis: the source blueprint is never written.
3. **Sea level and water** — sea level per the configured model (`SeaLevelModel`: `"flat"` scalar 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 — the default, `SeaLevelValue` 0.15 — or the legacy `"field"` latitude Lerp); flood fill