Voxy Map

Voxy Map

What you see is what you get — the map draws exactly as far as you can see. Voxy Map turns Voxy's existing LOD data into a real-time fullscreen map: no chunk loading, no world generation — the world you can see becomes a 3D terrain map.

Client-side only. Fabric 26.2 · Fabric 26.1.2 · NeoForge 1.21.1.

Works best together with Voxy SeedGen — it pre-generates distant terrain from the world seed, so even places you never actually loaded can be drawn on the map: https://www.curseforge.com/minecraft/mc-mods/voxy-seedgen

Why Voxy Map

• Real block colours — the map can now be drawn in each block's actual colours, and this is the default style; for now only vanilla blocks are covered, mod support is planned.
• See the whole world at a glance — the map is built directly from the LOD data Voxy has already stored, so opening it shows the entire explored world at once; nothing is loaded or generated while the map is open, and newly explored areas appear on the map as you play.
• Opens fast, runs well — the first open takes a few seconds, and each world keeps its own cache, so afterwards (even after restarting the game) it opens almost instantly; while the map is open, world rendering is paused so the frame rate goes to the map.
• A 3D map you can orbit — GPU-rendered terrain at a true 1:1 scale: middle-click switches, drag to orbit, scroll to zoom; it updates live and stays smooth.
• Smooth animation — the map scales in and out, wheel zoom anchors on the cursor, Space eases the view onto the player, leaving 3D plays a short rotation back to the flat map, and switching between 2D and 3D is seamless.
• Works with your pack — Fabric 26.2 / 26.1.2 and NeoForge 1.21.1; supports Voxy SeedGen, terrain mods and biome mods; 9 languages.
• Looks good and is easy to tune — seven palettes (default: the 200-colour Block colours material palette), contours, hillshade, water-depth shading, biome borders and labels, a right-click menu (copy / teleport / export PNG), per-world memory, and an in-game config screen where every option is explained.

Screenshots

Fullscreen map

Using the Tectonic mod's "i use voxy btw" preset terrain, Voxy SeedGen distance 382 chunks, yellow box = real render distance:

Vanilla terrain, Voxy SeedGen distance 382 chunks, yellow box = real render distance:

Vanilla terrain, Voxy SeedGen distance 382 chunks, yellow box = real render distance:

Close-up: contours, hillshade, water-depth shading, biome borders and labels:

3D mode:

Config screen:

Six palettes

Using the Tectonic mod's "i use voxy btw" preset terrain, Voxy SeedGen distance 382 chunks, yellow box = real render distance (natural / gradient / GMT / nautical / gradient-turbo / gradient-soft):

Quick start

Build	Install
Fabric 26.2	Fabric 26.2 + Fabric API + Voxy
Fabric 26.1.2	Fabric 26.1.2 + Fabric API + Voxy
NeoForge 1.21.1	NeoForge 21.1.224+ + Voxy + Roxy + Sodium

• Download the matching jar from Releases, drop it into mods/, launch the game and press N.
• The first open takes about 10–20 s depending on the explored area; after that each world is cached and reopens in 1–2 s, and opening/closing inside one session is instant.

Controls

Action	Default
Open / close map	N
Re-centre on the player	Space
Zoom	Mouse wheel
Pan	Hold left mouse button and drag
Switch 2D ↔ 3D	Middle-click, or the 3D button
Orbit the 3D camera	Hold middle mouse button and drag
Map menu	Right mouse button (copy coordinates / teleport / export PNG)
Debug panel	Q
Close	Esc

Compatibility

• 9 languages: English, 简体中文, 繁體中文, 日本語, Русский, Deutsch, Français, Español, Português (BR); all text is translatable, so resource packs can override or add languages.
• Terrain mods: the sea level and colour range are read from the world's actual data, so custom terrain keeps the right coastline and colour spread (the screenshots use Tectonic terrain).
• Biome mods: biome names and borders come from the data stored for the world, and modded biomes follow the game language.
• Client-side only — nothing needs to be installed on the server.

Configuration

Everything is in the in-game config screen, and every option is explained there. You can also edit the file directly: Fabric config/voxymap-client.json, NeoForge config/voxymap-client.toml. The config only sets defaults for new worlds; each world remembers its own palette, overlays, map scale and zoom.

The complete option list is in TECHNICAL.md.

FAQ

• The map only covers part of the world / the edges are black? Voxy is missing (NeoForge also needs Roxy), or SeedGen is not installed and the map only covers what Voxy actually stored. Black edges mean "no data", not a rendering error.
• The map looks wrong right after opening? It corrects itself once loading finishes; if it still looks wrong, click Refresh in the bottom-right corner.
• Frame rate feels low? Keep skipWorldRender on (it is by default); turning off the biome overlay or using a coarser map scale also helps.
• Only part of the map's tiles show up? This is most likely the VRAM budget; adjust it in the config screen to match your GPU's memory.

Known limitations

• Currently overworld only — the Nether and the End are not drawn.
• Biomes are matched by registry name, so identically named biomes from different mods may rarely collide.

Implementation details, the full option list and build instructions: TECHNICAL.md.

Support

• Issues and suggestions: https://github.com/Tsutsutsuu/voxy-map/issues
• Map data: Voxy · distant pre-generation: Voxy SeedGen

License

MIT — see LICENSE. Icon and screenshots © Tsutsutsuu.