From a53d4e85122b93407836a614bc5a5cd5314c7ce3 Mon Sep 17 00:00:00 2001 From: beezm Date: Tue, 11 Aug 2026 18:34:02 -0400 Subject: [PATCH] docs: the 21b mixed promotion in the generator README (terrain-water task 21b) Co-Authored-By: Claude Fable 5 --- Tools/Scripts/README.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/Tools/Scripts/README.md b/Tools/Scripts/README.md index 054bace..cdbaf9a 100644 --- a/Tools/Scripts/README.md +++ b/Tools/Scripts/README.md @@ -87,10 +87,16 @@ Generates the entire 2D blueprint. Roughly in order: 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 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 — - 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. + points, and lean endorheic terminals. Task 21b extends the plan to the developer's MIXED + promotion: the ocean trunks PLUS the top endorheic giants (`RIVERPLAN_GIANT_N`, default 3), + each classified — a giant whose terminal basin holds a classify lake stays a **lake-ender** + (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 — the default, `SeaLevelValue` 0.15 — or the legacy `"field"` latitude Lerp); flood fill