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

docs: island falloff, coast shelf, offshore islets (terrain-water task 11)

Browse source 
Tools/Scripts/README.md: the falloff dials and what they actually do --
including that IslandAxisX is a weak lever because the island is already
Trench-clamped at ~90% of the map width, so nobody re-derives that the hard
way. The spine crest fix, and an explicit note that the spine's AXIS is
still a straight line down the map centre: known, deferred, its own task.

BLUEPRINT_FORMAT.md config-knobs section: the three new dials, each labelled
with whether it moves biomes. CoastProfile does NOT (it cannot move the
waterline, so HGTS changes while BIOM/WBID/WBTB/WSRF stay bit-identical);
IslandAxis* and OffshoreIslandDensity DO, by design.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Stewart Howe 2026-08-08 23:31:40 -04:00
parent 6c318e4df0
commit 5ba868f038
2 changed files with 29 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

15
Tools/Scripts/README.md
View file

@ -11,6 +11,21 @@ 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.
The island's proportions are the `IslandAxisX`/`IslandAxisY` dials (`1.30`/`0.78`; the
pre-task-11 shape was `1.15`/`0.90`). **`IslandAxisX` is a weak lever** — the island is
already Trench-clamped at ~90 % of the map width, so aspect responds almost entirely to
`IslandAxisY`, which trades against land area. These move the coastline, so they move biomes.
The mountain spine shares `IslandAxisX` for its width, and its crest is rounded
(`IslandFalloff.SmoothAbs`) — `1 - |x - centre|` used to peak with a slope discontinuity that
was, measured, the largest slope step on the map outside the Trench walls. **The spine's AXIS
is still a straight line down the map centre; that is known, deferred, and its own task.**
With `CoastProfile: "wide"` (the default) the *seabed* leaving the shoreline is shelved
(`IslandFalloff.CoastShelf`): the height curve is identity at and below sea level, so it never
reached the water, and the shoreline used to shelve gently on land then drop 6.7× steeper the
moment it went under. The shelf cannot move the waterline — it is strictly positive for
positive depth — so biomes and water are bit-identical with it on or off. `OffshoreIslandDensity`
(`0.02`, `0` disables) seeds sparse discoverable islets in the open ocean; they are held off the
mainland by a depth moat and out of the Trench by a distance mask, both by construction.
When `TerrainCurve: "v5"` (the default — the task-09 gate's BALANCED winner), the calibrated
height-redistribution curve
(`HeightCurve.cs` — the terraced ascent with spatially modulated shelves: flat farmable