Voxy Map

# Voxy Map 0.3.0

> 0.3.0 rebuilds the map rendering (unified tiles), adds a GPU-rendered 3D terrain view and brings the NeoForge 1.21.1 build to full feature parity with the Fabric builds.

### 3D map (new)

- New **3D terrain view**: tilt the same map up with one click (the **3D** button, or a short middle-click) and orbit, zoom and pan freely
- Rendered at a true **1:1 height** by default (`verticalScale3d` is adjustable); GPU per-tile drawing with near/mid/far precision levels and seam-hiding skirts, so zooming and rotating stay smooth
- **Seamless 2D ↔ 3D switching**: position and scale line up, leaving 3D plays a short rotation back; the 3D camera is remembered per world
- 3D-only interactions: biome labels (distance limit + terrain occlusion), a floating player arrow, ray-picked coordinates, the right-click menu, and a render-distance ribbon that hugs the terrain
- VRAM and resource management: texture budget, farthest tiles evicted first, deferred release; the `Q` panel reports mesh / atlas / depth VRAM separately

### 2D map rewritten (unified tiles)

- The 2D map now builds and draws in **256×256 tiles** instead of one giant texture: only tiles near the view are built, so even huge worlds open quickly
- Every tile is coloured and textured on its own; changing palettes or toggling overlays only rebuilds the affected tiles instead of the whole map
- **Live updates**: new Voxy data, newly explored area (or new SeedGen terrain) appears on the map as it arrives
- New per-world tile cache (`tiles/*.vxt` + source index): reopened maps come back fast after a restart; the old whole-map refresh path is gone
- Fixed: the read-only database handle never saw newly written data, which left new worlds stuck half-loaded and made Refresh do nothing
- Lots of performance work: parallel decode/colour workers, texture VRAM budget with farthest-tile eviction, disk cache cap + LRU, negative caching, and no heavy work on the main thread

### Animation and interaction

- Wheel zoom is now **interpolated** (anchored on the cursor) and behaves the same in 2D and 3D; Space eases the view onto the player
- Open/close and 2D↔3D switching share one animation duration and easing curve
- **Middle-click gestures**: a short press toggles 2D/3D, holding and dragging orbits the 3D camera (the two never trigger each other)
- Animations stay time-based at high frame rates, so they never speed up

### Config screen

- Four tabs became **six**: General / Map / Map data / 3D View / Perf / Debug, with sections inside each page
- The option set grew to **60** (3D options, tile/texture budgets, caches, debug tracing…), all with descriptions localised in every language
- Draft mode (Cancel/Apply/Done/Reset), slider dragging and click-to-type are all kept; the dead refresh options were removed

### Biomes and rendering

- Biome labels now have **full-map / viewport** strategies: above 6 million pixels only the viewport is built, so memory peaks on large worlds drop sharply
- Biome borders and labels were rebuilt on the tile pipeline and are shared by 2D and 3D; occlusion, area filtering and adaptive font size are kept
- Colour tweaks: smoother lowland/seabed transitions in the gradient and rainbow palettes; the adaptive ramp follows the world's real height range

### NeoForge 1.21.1

- **Full parity with the Fabric build**: unified tile 2D, GPU 3D view, six-tab config screen, 9 languages
- Dedicated render/UI/config compatibility layers for 1.21.1, verified in game for 2D, 3D, the config screen and the caches
- Fixed 1.21.1-only issues: GUI text/texture corruption after entering 3D, and black fringes on semi-transparent arrow pixels

### Languages and compatibility

- 9 languages and all 189 text keys aligned; dead keys removed
- Fabric 26.1.2 got the GPU 3D view too; **all three builds (Fabric 26.2, Fabric 26.1.2, NeoForge 1.21.1) now have the same feature set**

### Other fixes

- Fixed the map opening triggering an unnecessary refresh, and refresh getting stuck at 0%
- Fixed black patches, tile-seam shimmer and biome labels landing outside their region after long travel
- Cleaner VRAM/RAM release: closing the map, changing worlds and switching views all free their resources correctly