From e435843e9a3fc7cd0fbe18b8cdf68a29364b901e Mon Sep 17 00:00:00 2001 From: beezm Date: Fri, 7 Aug 2026 06:25:19 -0400 Subject: [PATCH] docs: SeaLevelModel/SeaLevelValue config notes (terrain-water task 04) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Both sea-level modes documented (flat default 0.15 / legacy field Lerp); noted the blueprint does not record which model produced it — the WBTB levels are the observable. Batch runner lives in /tmp (throwaway), not in-repo. Co-Authored-By: Claude Fable 5 --- Core/Scripts/BLUEPRINT_FORMAT.md | 12 ++++++++++++ Tools/Scripts/README.md | 5 +++-- 2 files changed, 15 insertions(+), 2 deletions(-) diff --git a/Core/Scripts/BLUEPRINT_FORMAT.md b/Core/Scripts/BLUEPRINT_FORMAT.md index 493758f..9a498ca 100644 --- a/Core/Scripts/BLUEPRINT_FORMAT.md +++ b/Core/Scripts/BLUEPRINT_FORMAT.md @@ -94,6 +94,18 @@ sections `5·MapSize²` bytes (4 height + 1 biome) ≈ **320 MiB at 8K**, vs v1' `9·MapSize²` (adds 2 B `WBID` + 2 B `WSRF`) ≈ **576 MiB at 8K** plus a trivial `WBTB` (20 B per body). +### Config knobs that shape blueprint content (not part of the byte format) + +- **`SeaLevelModel`** (`"flat"` | `"field"`) + **`SeaLevelValue`** (float; used when flat) — + D-033: selects what `MapGenerator.GetSeaLevel` returns. `"flat"` (the default, value 0.15) is + one scalar sea level everywhere; `"field"` is the legacy latitude Lerp (0.26 north → 0.15 + south). Generator-only — all nine `GetSeaLevel` call sites inherit the model; nothing at + runtime computes sea level. The model in force shapes the coastline, masks, biomes, water + bodies, and `WBTB` levels of the blueprint being generated; the file itself does not record + which model produced it (the `WBTB` levels are the observable). +- **`SkipRoads`** (bool, default false) — exports with present-but-empty road sections (see the + road-section table note). + ### Deliberately NOT a section: basins (`BSIN`) The priority-flood pit-fill that runs in the water-bodies stage is **diagnostics only** and diff --git a/Tools/Scripts/README.md b/Tools/Scripts/README.md index 81d23d7..466dbb6 100644 --- a/Tools/Scripts/README.md +++ b/Tools/Scripts/README.md @@ -11,8 +11,9 @@ Generates the entire 2D blueprint. Roughly in order: 2. **Topography** — FastNoiseLite base height plus a mountain spine, minus a squircle distance falloff, giving a guaranteed island. Noise frequency is divided by `scaleFactor` (`MapSize / 1024f`) so terrain features stay the same real-world size at any map profile. -3. **Sea level and water** — temperature-driven sea level; flood fill separates true ocean from - inland lakes; a mainland fill guarantees one contiguous landmass. +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 + separates true ocean from inland lakes; a mainland fill guarantees one contiguous landmass. 4. **The crater** — placed along the northern coast and carved to below sea level, but only out to **80 % of its radius**, which guarantees a landbridge rather than severing the island. 5. **Water bodies** — promotes the classified water into explicit data: the ocean as body 1, each