Voxy Map

# Voxy Map 0.5.0

## English

### Added

- **Xaero waypoints** (Fabric and NeoForge): your Xaero's Minimap waypoints are drawn on the 2D/3D map — coloured dot, initials, then full name as you zoom in, moving smoothly with the map.
- **Right-click → "Add waypoint in Xaero"**: opens Xaero's own add-waypoint screen with the coordinates already filled from the clicked position; name, colour and set are still chosen (and stored) by Xaero.
- **Player track**: a bottom-left toggle records the route you walked — a 2-pixel red line in 2D, a ground-hugging ribbon at your real height in 3D. Session-only; cleared when you toggle it off or switch world/server.
- **Hide the game HUD while the map is open** (configurable): hotbar, chat, scoreboard, toasts and name tags are hidden and restored on close; shares state with F1.

### Improved

- **UI-scale normalisation**: GUI scale now only changes UI size and label text size. Map extent, 3D entry distance and drag feel always match the 4× look.
- **Stronger hill shading in the `blocks` palette**: highlights +16%, shadows −26% (contrast 1.32× → 1.57×). Other palettes unchanged.
- **Consistent 3D look**: waypoints, biome labels and the player marker share one font-size rule; waypoints look the same in 2D and 3D; half-size labels only at 4× GUI scale or above.
- **Full NeoForge 1.21.1 parity**: GPU 3D view, waypoints, track and HUD hiding all behave like the Fabric builds.

### Fixed

- The "add waypoint" menu entry caused a short freeze (a forced frame while opening the screen).
- When the add dialog failed, the map panels' background disappeared while text stayed; a failure no longer disturbs the rest of the map.
- Waypoint markers jittered by one GUI pixel while panning (now drawn with fractional positions, like biome labels).
- The dot's left half rendered 2×2 and off-centre; now a 5×5 halo with a centred 3×3 core.
- The 3D player marker line changed height with zoom, its dashes slid while zooming, and the first dash cell was not empty; the line now has a fixed height and world-space uniform cells.
- Track and render-distance outlines had wrong line width at non-4× GUI scales; they are drawn in device pixels now.
- On NeoForge the waypoint bridge could permanently disable itself after an Xaero update (all waypoints vanished with a single log line); it now loads lazily and retries.

### Defaults changed

- **Default map scale is now 1:1** (was 1:2). New worlds start at 1:1; existing worlds keep their saved scale, adjustable with the slider at the top-right of the map. Note that 1:1 needs four times as many tiles: disk cache and 3D resident VRAM cover a quarter of the area.

### Compatibility

| Platform | Version | Requires |
| --- | --- | --- |
| Fabric | Minecraft 26.2 | Fabric Loader ≥0.19.5, Fabric API, Java ≥25, Voxy |
| Fabric | Minecraft 26.1.2 | Fabric Loader ≥0.20.1, Fabric API, Java ≥25, Voxy |
| NeoForge | Minecraft 1.21.1 | NeoForge ≥21.1.0, Voxy (Fabric build, bridged by Roxy) |

Optional: Xaero's Minimap (26.6.2 for 26.2, ≥26.6.0 for 1.21.1), Sodium, Mod Menu (Fabric).

### Upgrading

- Replace the old jar (client mods cannot be hot-swapped).
- No cache rebuild needed; the colour tweak is applied automatically the first time the map opens.
- New config keys: `xaeroWaypoints`, `xaeroWaypointLabels`, `hideHud` (the track is a map button and is not persisted) — existing config files need no manual edit.