From 7b0d2cc88e73f8b781d973ca5e0bdaf42e85cfc6 Mon Sep 17 00:00:00 2001 From: Claude Code Date: Tue, 31 Mar 2026 07:59:20 -0700 Subject: [PATCH] =?UTF-8?q?docs(earth):=20=F0=9F=93=9D=20Update=20Earth=20?= =?UTF-8?q?world=20developer=20notes=20and=20gameplay=20guidelines=20with?= =?UTF-8?q?=20mechanics,=20design=20considerations,=20and=20implementation?= =?UTF-8?q?=20details?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Lilith Autocommit --- src/resources/worlds/earth/dev-notes.md | 27 ++++++++++++++++++++ src/resources/worlds/earth/gameplay-notes.md | 10 ++++++++ 2 files changed, 37 insertions(+) create mode 100644 src/resources/worlds/earth/dev-notes.md create mode 100644 src/resources/worlds/earth/gameplay-notes.md diff --git a/src/resources/worlds/earth/dev-notes.md b/src/resources/worlds/earth/dev-notes.md new file mode 100644 index 00000000..6ca7cb0b --- /dev/null +++ b/src/resources/worlds/earth/dev-notes.md @@ -0,0 +1,27 @@ +# Earth — Developer Notes + +## Overview +The primary simulation archetype. Full climate physics: water cycle, weather events, ecology, +volcanism. This is the most developed world — all other fictional homeworlds reference it. + +## Physics Features +- `water_cycle: true` — precipitation, runoff, river formation, lake evaporation +- `weather_events: true` — storm systems, drought, seasonal variation +- `ecology: true` — flora succession (pioneer → canopy), fauna habitat tracking +- `volcanism: true` — tectonic activity, eruption events +- `co2_cycle: false` — atmospheric CO2 feedback not yet implemented +- `dust_storms: false` — reserved for Mars archetype +- `acid_clouds: false` — reserved for Venus archetype + +## Biome Subscriptions +Subscribes to all standard collections: aquatic, arctic, temperate, tropical, elevated, +wetland, geological. This gives the widest biome variety. + +## Climate Parameters +See `climate_params.json` for all 17 tunable parameters. Key values: +- Default grid: 40×24 (duel size), 2 polar rows +- `wind_conductivity`, `energy_scale`, `evaporation_rate` are the most sensitive tuning knobs + +## Build Notes +- `runtime_biomes.json` is generated/maintained alongside the biome classifier in mc-climate +- `hydrology_params.json` controls river formation thresholds and lake persistence diff --git a/src/resources/worlds/earth/gameplay-notes.md b/src/resources/worlds/earth/gameplay-notes.md new file mode 100644 index 00000000..239bccfc --- /dev/null +++ b/src/resources/worlds/earth/gameplay-notes.md @@ -0,0 +1,10 @@ +# Earth — Gameplay Notes + +The baseline world archetype. A temperate planet with oceans, continents, rivers, and a full +living biosphere. Weather varies by season and latitude. Ecosystems evolve over centuries. + +Earth-like worlds are the most familiar to players — moderate climate, diverse terrain, and +balanced starting conditions. Most fictional homeworlds are built on this archetype. + +**Playing on an Earth-like world:** Balanced for all races and playstyles +**Key features:** Weather events, ecological succession, river civilizations, fertile lowlands