aboutsummaryrefslogtreecommitdiffziptar.gz
path: root/example/masks
diff options
context:
space:
mode:
Diffstat (limited to 'example/masks')
-rw-r--r--example/masks/README.md14
1 files changed, 14 insertions, 0 deletions
diff --git a/example/masks/README.md b/example/masks/README.md
new file mode 100644
index 0000000..eea3162
--- /dev/null
+++ b/example/masks/README.md
@@ -0,0 +1,14 @@
+# Override masks (optional)
+
+Paint in GIMP/Krita as **equirectangular** grayscale PNGs, any size (2:1), 8- or 16-bit.
+Mid-gray (32768 in 16-bit, 128 in 8-bit) = neutral / no change. Transparent or missing = neutral.
+
+| File | Effect (white = +1, black = −1) |
+|---|---|
+| `land_hint.png` | bias toward land (+) or sea (−) on top of the sketch |
+| `mountain_hint.png` | extra uplift (+) |
+| `o2_zones.png` | O₂ modifier: 1 + 0.5·v (world.toml `[masks] o2_range`) |
+| `gravity_zones.png` | gravity modifier: 1 + 0.7·v; v < 0 = low-g zone (relief ×, spires) |
+| `lock.png` | where brighter than 75% grey (> +0.5), coastline follows land_hint strictly |
+
+Rebuild: `.venv/bin/python mapgen.py build` (masks are part of the cache key).