Voxy Map

# Voxy Map 0.4.0

> 0.4.0 adds a **block-material map style** with a 200-colour palette and per-biome tints, fixes several surface/biome merging bugs, and brings the same feature set to Fabric 26.1.2 and NeoForge 1.21.1. It also fixes two issues found during testing: a driver-level VRAM crash when closing the map on 26.1.2, and a one-frame world flash while the 3D view is still loading.

### New "Block colors" map style

- Added a seventh palette, **Block colors** (`blocks`): every surface block is drawn with its real map colour instead of a height ramp — grass, dirt, stone families, sand, wood, leaves, wool, concrete, terracotta and more
- Backed by a **200-colour material palette** (1192 exact block states plus rule-based fallback for unknown/modded blocks), generated from vanilla textures
- **Per-biome tints**: grass, leaves and water use the same colours vanilla uses, including the swamp/dark-forest grass modifiers and modded biome names that lost their namespace in Voxy data
- New **`biomeColors`** option (on by default); turning it off uses the palette's flat class colours
- Block colors is now the **default style**; the six existing palettes are unchanged

### Map correctness

- Fixed several LOD merge edge cases: coarse water no longer floods finer dry columns, enclosed water is demoted correctly, sea-level/empty-column locks are respected, and a coarser solid no longer overrides a finer floor
- Fixed surface **biome attribution**: when the top block is discarded and the column falls back to its floor, the floor block's biome is now used (underground biomes no longer label the surface)
- Fixed tiles that were treated as "has data" when only empty columns were merged (no more bogus zero-height tiles)
- Faster first open: sections of one tile are now decoded in parallel batches, with the same deterministic merge order — identical output, much less waiting on large areas
- A failed `id_mappings` scan now retries instead of caching an empty water/tint table; tint tables are not reset to plains by a failed scan

### 3D view and stability

- Fixed the 26.1.2 NVIDIA VRAM crash when closing the map after leaving it open for a while: one hidden world frame per second keeps Voxy's renderer/upload ring warm, and closing the map now always releases the 3D GPU terrain (`keep3dTilesIn2d` only applies while the map stays open)
- Fixed a one-frame world flash while the 3D view was still loading: the 3D pass clears the background even before the first tile exists. This is a background clear, not a UI overlay, so the terrain and labels stay visible
- Closing the map, changing worlds and leaving 3D all release their resources cleanly; optional `vram=` lines were added to the debug log

### NeoForge 1.21.1

- Block colors, the material palette, biome tints, `biomeColors`, the seven-style menu and 9 languages are all backported — **feature parity with the Fabric builds**
- Fixed 1.21.1 blocks being colour-mapped wrongly: Voxy's mapping text renders an NBT terminator as `.`, which made leaf names miss the palette and fall back to the wood class (leaves looked yellow-brown); names are trimmed before lookup now
- 1.21.1 API adaptations: biome registry access, `ResourceLocation`, `DynamicTexture`, pixel format, build height; dry-foliage uses the constant fallback (1.21.1 has no leaf litter)
- Palette compatibility checked against the 1.21.1 block set: 1062 block states, only 7 missing exact entries (6 air-like blocks + `chain`, which falls back to a neutral colour)
- The VRAM keepalive and the 3D loading background fix are ported here too

### Fabric 26.1.2

- Block colors and all 0.4.0 fixes are backported; 26.1.2 and 26.2 now have the same feature set
- Tile/snapshot/colour cache versions bumped so existing worlds rebuild their colours once after updating

### Config and languages

- Option count is now **61** (added `biomeColors`), all with localised descriptions
- Default palette is `blocks`; defaults were tuned to the tested configuration: 472 MB texture budget, water blur radius 4, render-distance box on, 3D player marker scale 2.5×
- The style dropdown blocker now accounts for all seven entries, so labels no longer overlap the open menu
- 9 languages, 192 text keys (new: style name, option name and description)

### Caches and compatibility

- Palette and merge changes bump the tile/snapshot/colour caches: the first map open after updating rebuilds once, then reopens are fast again; NeoForge also invalidates old pre-release tile caches
- Fabric 26.2, Fabric 26.1.2 and NeoForge 1.21.1 remain client-side only and share the same data pipeline