Add Ground Zero foliage pass

2026-05-14 06:41:23 -07:00
parent 7a05e324a3
commit 7ffe3ec978
7 changed files with 397 additions and 4 deletions
@@ -0,0 +1,40 @@
+# Ground Zero First-Pass Foliage
+
+The Ground Zero demo map now has a first-pass foliage layer driven by terrain
+height and simple biome placement rules.
+
+## Implementation
+
+- Native actor: `AAgrarianFoliagePatch`
+- Map setup script: `Scripts/setup_ground_zero_demo_map.py`
+- Map actor label: `AGR_GroundZeroFoliage_FirstPass`
+- Mesh source: Unreal level prototyping meshes for now.
+
+The actor uses hierarchical instanced static mesh components for three visible
+foliage groups:
+
+- Trees: taller cylinder instances placed mostly on higher/hill terrain.
+- Shrubs: low blocky scrub instances across valley and hillside terrain.
+- Grass: small clump instances across the broader walkable tile.
+
+## Placement Rules
+
+The first pass is intentionally deterministic. It uses the Ground Zero Unreal
+heightmap and a fixed random seed so repeated map setup runs produce the same
+foliage distribution.
+
+The placement avoids the demo player start, shelter, campfire, resource nodes,
+and wildlife spawn area so the initial investor path remains readable.
+
+## Counts
+
+- Trees: `42`
+- Shrubs: `96`
+- Grass clumps: `180`
+
+## Follow-Up
+
+This is a visual and performance-safe placeholder pass, not final ecology. The
+next biome/resource passes should replace prototype meshes with real coastal
+California scrub, grassland, woodland, and resource-specific assets, then tie
+spawn density to land-cover and hydrography data.