| name | layer-viz |
| description | Generate professional HTML infographics for all current voxel world biomes (15 surface + 3 underground). Shows layer structure, elevation bands, vegetation, cave fill, light sources, and decorations. Triggers: "layer visualization", "biome layers", "/layer-viz"
|
Layer Visualization Generator
Generate professional HTML infographics showing depth-dependent features across every biome.
Usage
/layer-viz
Generates a single interactive HTML file with tabs for all biomes.
What it does
Creates layer_viz.html with interactive visualization showing:
Overview Tab:
- 🌍 Biome distribution across all 18 biomes (grouped by category)
- Elevation reference: world height, sea level, lava zone, snow line
- Cave fill guide: dry vs flooded vs ice vs lava by biome
- Underground spread: Lush/Dripstone (Y:11-74), Deep Dark (Y:0-31)
- Key depth markers: bedrock Y:0, lava Y:2-10, sea level Y:75, snow line Y:155, build height Y:511
Layer Structure (Per-Biome):
- World height 0-511 with biome-specific surface Y
- Dry / flooded / ice caves and lava distribution by biome
- Snow caps where applicable (mountains above Y:155)
- Color-coded layers with hover details
Depth-Dependent Features:
- 🌳 Vegetation: tree species, height ranges, densities
- 💡 Natural light sources: glowstone, crystals, glowmushroom zones
- 🏔️ Cave decorations: stalactites, stalagmites, icicles distribution
Interactive Features:
- Tab-based switching with emoji icons
- Smooth fade-in animations
- Hover effects on layers and elevation bars
- Biome-specific color coding
World & Elevation Reference
- World height: 512 blocks (Y:0-511)
- Sea level: Y:75
- Lava lakes: Y:2-10 in every biome; mountains keep lava/water caves up to sea level
- Snow line: stone above Y:155 in mountains converts to snow
- Underground spans: Lush/Dripstone typically Y:11-74; Deep Dark Y:0-31
- Bedrock: single unbreakable layer at Y:0
Biome Reference (current data from scripts/generate_layer_viz.py)
Temperate
- Plains 🌾 — Surface ~Y100; grass over dirt; oak 6-10 (5%); tall grass + red/yellow/blue flowers 10-13%; dry caves; sparse oaks & wildflowers.
- Meadow 🌸 — Surface ~Y105; grass/dirt; oak 6-10 (3%, very sparse); many flowers + tall grass 20%; dry caves; rolling hills.
- Forest 🌳 — Surface ~Y100; grass/dirt; oak 6-10 (25%); grass/ferns/blue flowers 10%; dry caves; dense canopy.
- Birch Forest 🌲 — Surface ~Y100; grass/dirt; birch 10-14 (20%); grass/ferns/blue flowers 10%; dry caves; bright white trunks.
- Dark Forest 🌑 — Surface ~Y100; grass over coarse dirt/dirt; oak 6-10 (35% very dense); mushrooms/ferns/sparse grass 18%; dry caves; low-light canopy.
Hot & Dry
- Desert 🏜️ — Surface ~Y100; sand over sandstone; cacti 3-6 (2%); dead bushes 3%; caves fully dry; sand dunes/sandstone subsurface.
- Savanna 🦁 — Surface ~Y100; grass/coarse dirt over coarse dirt/dirt; acacia 8-12 (6%, bent umbrellas); sparse grass + dead bushes 10%; dry caves; flat with coarse patches.
Tropical
- Jungle 🌴 — Surface ~Y100; grass/dirt; jungle trees 15-25 (40% dense); dense grass/ferns/flowers 28%; dry caves; towering canopy & undergrowth.
- Swamp 🐊 — Surface ~Y76 (just above sea); mud over clay/mud; willows 10-14 (12% drooping); tall grass/mushrooms/lily pads 22%; water-filled caves below Y80 (SEA+5); flooded terrain.
Cold
- Taiga 🌲 — Surface ~Y100; grass/podzol over dirt; pine 12-18 (18%); ferns/grass 12%; dry caves; tall pines with podzol patches.
- Snowy Taiga 🎄 — Surface ~Y100; snow over podzol/dirt; snow pines 8-14 (20%); sparse ferns/grass 6%; ice-walled caves; snow-covered branches.
- Snowy Plains ❄️ — Surface ~Y100; snow over packed ice/ice; snow pines + dead trees 6-14 (14% total: 6% pines, 8% dead); sparse grass 2%; ice caves (air interior, ice walls); frozen tundra.
- Mountains ⛰️ — Surface ~Y165; stone/gravel over stone; pines 12-18 (3%, only below Y80); sparse grass + blue flowers 6%; deep caves mix lava/water up to sea level; snow caps above Y155; exposed stone peaks.
Aquatic
- Ocean 🌊 — Seafloor ~Y40; sand/gravel/clay over sand/clay; no trees; seagrass 12%; caves fully submerged (water to sea level).
- Beach 🏖️ — Surface ~Y76; sand over sand/clay; no trees or vegetation; dry caves; coastal transition with clay pockets.
Underground
- Lush Caves 🌿 — Moss/rooted dirt over stone; bioluminescent vegetation (moss carpet, hanging roots, glow berries, glow lichen, mushrooms ~35%); dry caves; main lush zone Y:32-74, mixed lush/stone Y:11-31.
- Dripstone Caves 🗻 — Dripstone/calcite over stone; extra-dense stalactites & stalagmites; dry caves; dripstone zone Y:32-74, dense formations Y:11-31.
- Deep Dark 🕳️ — Deepslate throughout; sparse glow lichen/mushrooms (~8%); dry caves; dominant at Y:0-31.
Implementation
When invoked, run the Python script:
python3 scripts/generate_layer_viz.py
The script at scripts/generate_layer_viz.py is the source of truth for biome layers, surface heights, cave fill, vegetation, light sources, and decorations. See scripts/README.md for more notes.
