Voxy Map 0.4.0 (Fabric 26.2 / 26.1.2, NeoForge 1.21.1)

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.

0.4.0 新增「方块颜色」材质样式（200 色色表 + 群系染色），修复多处地表/群系合并问题，并把同一套功能带到 Fabric 26.1.2 与 NeoForge 1.21.1；同时修掉测试中发现的两个问题：26.1.2 关图时的驱动级显存崩溃，以及 3D 视图加载期间闪一帧世界画面。

English changelog

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

中文更新日志

新增「方块颜色」地图样式

• 新增第 7 套配色 方块颜色（blocks）：按每个地表方块的真实地图颜色绘制，不再使用高度色带——草、泥土、石头系、沙子、木头、树叶、羊毛、混凝土、陶瓦等都有对应颜色
• 背后是一张 200 色材质色表（1192 条精确方块状态 + 未知/模组方块规则兜底），颜色由原版材质生成
• 群系染色：草、树叶、水使用与原版一致的颜色，包括沼泽/黑森林的草色修正，以及 Voxy 数据里丢失命名空间的模组群系名
• 新增 biomeColors 开关（默认开）；关闭后使用色表的固定类颜色
• 「方块颜色」成为默认样式；原有 6 套配色保持不变

地图正确性

• 修复多处 LOD 合并边界：粗层水面不再淹没更细层的干地、封闭水域正确降级、海平面/空段锁生效、粗层实心不再覆盖更细层的地板
• 修复地表群系归属：顶层方块被丢弃、列回退到地板时，改用地板方块的群系（地下群系不再标到地表）
• 修复“只有空列被合并”时瓦片被当成有数据的问题（不再出现假的零高度瓦片）
• 首次打开更快：同一瓦片内的 section 改为分批并行解码，合并顺序不变——输出完全一致，大范围加载等待明显减少
• id_mappings 扫描失败会重试，不再缓存空的水/染色表；失败也不会把染色表重置成平原颜色

3D 视图与稳定性

• 修复 26.1.2 地图打开较久后关图的 NVIDIA 显存崩溃：地图打开期间每秒放行 1 帧隐藏的世界渲染，让 Voxy 的渲染环/上传队列保持推进；关图时无条件释放 3D GPU 地形（keep3dTilesIn2d 只在地图仍打开时生效）
• 修复 3D 视图加载期间闪一帧世界画面：即使还没有任何瓦片，3D 通道也会先清一次背景。这是背景清屏而不是 UI 遮罩，地形和标签不会被挡住
• 关图、换世界、退出 3D 都会正确释放资源；调试日志新增可选的 vram= 行

NeoForge 1.21.1

• 方块颜色、材质色表、群系染色、biomeColors、7 套样式菜单与 9 种语言全部回移——与 Fabric 版功能一致
• 修复 1.21.1 方块颜色映射错误：Voxy mapping 文本会把 NBT 终止字节渲染成 .，导致树叶名字查不到色表而落到木头类（树叶显示成黄棕色）；现在解析后会去掉末尾的点
• 1.21.1 API 适配：群系注册表访问、ResourceLocation、DynamicTexture、像素格式、建筑高度；干树叶使用常量兜底（1.21.1 没有 leaf litter）
• 色表与 1.21.1 方块集兼容性检查：1062 个方块状态，仅 7 个缺少精确条目（6 个空气类 + chain，走中性色兜底）
• 显存 keepalive 与 3D 加载背景修复同样回移

Fabric 26.1.2

• 方块颜色与 0.4.0 全部修复回移；26.1.2 与 26.2 功能一致
• 提升瓦片/快照/颜色缓存版本，升级后首次打开会重建一次颜色缓存

配置与语言

• 配置项增加到 61 项（新增 biomeColors），说明全部本地化
• 默认样式为 blocks；默认值按实测配置调整：纹理预算 472MB、水面模糊半径 4、显示视距框、3D 玩家标记 2.5×
• 样式下拉的遮挡框按 7 项计算，标签不再压到展开的菜单上
• 9 种语言、192 个文本键（新增：样式名、配置项名、配置说明）

缓存与兼容性

• 色表与合并逻辑变化会提升瓦片/快照/颜色缓存版本：升级后首次开图重建一次，之后恢复秒开；NeoForge 额外让测试版留下的旧瓦片缓存失效
• Fabric 26.2、Fabric 26.1.2、NeoForge 1.21.1 仍为纯客户端模组，共用同一套数据管线

下载 / Downloads

File	Platform	MC
voxy-map-0.4.0+26.2+fabric.jar	Fabric	26.2
voxy-map-0.4.0+26.1.2+fabric.jar	Fabric	26.1.2
voxy-map-0.4.0+1.21.1+neoforge.jar	NeoForge	1.21.1

安装提醒 / Notes

• 纯客户端模组，不需要装到服务端 / Client-side only
• Fabric 需要 Fabric API 与对应版本的 Voxy；NeoForge 需要 Voxy、Roxy、Sodium / Fabric needs Fabric API + matching Voxy; NeoForge needs Voxy, Roxy, Sodium
• 推荐搭配 Voxy SeedGen / Voxy SeedGen is recommended
• 目前只绘制主世界 / Only the overworld is drawn for now
• 升级后首次打开地图会重建一次缓存 / The first map open after updating rebuilds the cache once
• 1.21.1 的 chain 使用中性色兜底，颜色可能与其它版本略有差异 / On 1.21.1 chain uses the neutral fallback and may differ slightly from the other builds

Voxy Map 0.3.0 (Fabric 26.2 / 26.1.2, NeoForge 1.21.1)

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.

0.3.0 重做了地图渲染（统一瓦片 2D），新增 GPU 渲染的 3D 地形视图，并把 NeoForge 1.21.1 版对齐到与 Fabric 版完全一致的功能集。

English changelog

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

中文更新日志

三维地图（全新）

• 新增 3D 地形视图：同一张地图一键立起来（右上角「3D」按钮，或鼠标中键短按），可自由环绕、缩放、平移
• 默认按真实 1:1 高度渲染（verticalScale3d 可调），GPU 逐瓦片绘制，近/中/远三级精度 + 接缝裙边，缩放与旋转流畅
• 2D ↔ 3D 无缝切换：位置与比例对应，退出时短暂旋转归位；每个世界记住 3D 相机
• 3D 专属交互：群系标签（距离限制 + 地形遮挡）、悬浮玩家箭头、射线拾取坐标、右键菜单、贴地渲染距离带
• 显存与资源管理：纹理预算、优先淘汰最远瓦片、延迟回收；Q 面板可查看网格/图集/深度显存分项

二维地图重写（统一瓦片）

• 2D 地图从「整张大图」改为按 256×256 瓦片流式构建与绘制：只构建视野附近的瓦片，世界再大也能快速打开
• 每个瓦片独立着色与纹理；换配色、开关群系叠加时只重建受影响的瓦片，不再整图重画
• 实时更新：Voxy 写入新数据、探索到新区域（或 SeedGen 生成新远景）时，地图会实时长出来
• 新增每存档瓦片缓存（tiles/*.vxt + 来源索引）：重启游戏后快速出图；移除旧的整图刷新逻辑
• 修复：只读数据库句柄看不到新写入的数据，导致新世界地图只加载一半、刷新无效
• 大量性能优化：后台并行解码/着色、纹理显存预算与最远瓦片淘汰、磁盘缓存上限与 LRU、负缓存、主线程不再做重活

动画与交互

• 滚轮缩放改为插值（以鼠标位置为锚点），2D 与 3D 一致；空格改为缓动定位到玩家
• 开图/关图、2D↔3D 切换统一动画时长与缓动曲线
• 中键手势：短按切换 2D/3D，按住拖动环绕 3D 相机（短按/拖动不会互相误触）
• 高帧率下动画仍按时间推进，不会变快

配置界面

• 配置页从 4 页扩展为 6 页：常规 / 地图绘制 / 数据与刷新 / 3D 视图 / 性能 / 调试，页内分小节
• 配置项扩充到 60 项（新增 3D 相关、瓦片/纹理预算、缓存、调试追踪等），每项说明随语言本地化
• 保留草稿模式（取消/应用/完成/重置）、滑块拖动与点击输入；清理失效的旧刷新选项

群系与渲染

• 群系标签改为整图 / 视口两套策略：整图超过 600 万像素时只在视口区域构建，大世界内存峰值大幅下降
• 群系边界与标签在瓦片模式下重做，2D 与 3D 共用；标签遮挡、面积过滤、字号自适应保留
• 配色细节调整：渐变/彩虹配色的低地与海底过渡更自然；自适应色带按世界实际高度

NeoForge 1.21.1

• 与 Fabric 版功能完全对齐：统一瓦片 2D、GPU 3D 视图、6 页配置屏、9 种语言
• 为 1.21.1 单独实现渲染/界面/配置兼容层，实机验证 2D、3D、配置屏与缓存
• 修复 1.21.1 上进入 3D 后 GUI 文字/贴图异常、箭头半透明像素发黑的问题

语言与兼容性

• 9 种语言、189 个文本键全对齐，清理失效键
• Fabric 26.1.2 同步 GPU 3D 视图；三个版本（Fabric 26.2 / 26.1.2、NeoForge 1.21.1）功能一致

其它修复

• 修复打开地图误触发刷新、刷新卡在 0% 的问题
• 修复长时间旅行后出现的黑块、瓦片接缝抖动、群系标签跑到区域外
• 显存/内存回收更干净：关图、换世界、切换视图都会正确释放资源

下载 / Downloads

File	Platform	MC
voxy-map-0.3.0+26.2+fabric.jar	Fabric	26.2
voxy-map-0.3.0+26.1.2+fabric.jar	Fabric	26.1.2
voxy-map-0.3.0+1.21.1+neoforge.jar	NeoForge	1.21.1

安装提醒 / Notes

• 纯客户端模组，不需要装到服务端 / Client-side only
• Fabric 需要 Fabric API 与对应版本的 Voxy；NeoForge 需要 Voxy、Roxy、Sodium / Fabric needs Fabric API + matching Voxy; NeoForge needs Voxy, Roxy, Sodium
• 推荐搭配 Voxy SeedGen / Voxy SeedGen is recommended
• 目前只绘制主世界 / Only the overworld is drawn for now

Voxy Map 0.2.0 (Fabric 26.2 / 26.1.2, NeoForge 1.21.1)

Voxy Map 0.2.0

This is the first release that supports Fabric 26.2, Fabric 26.1.2 and NeoForge 1.21.1.
这是第一个同时支持 Fabric 26.2、Fabric 26.1.2 与 NeoForge 1.21.1 的版本。

English changelog

New platforms

• Added Fabric 26.2 and Fabric 26.1.2 (single Stonecutter project, one source tree)
• NeoForge 1.21.1 now has the same UI and features

Config screen rebuilt

• Fully self-drawn config screen: four grouped tabs, a description for every row, section dividers
• Three control types: toggles, dropdowns, sliders (drag, or click the value and type a number)
• Draft mode: Cancel discards, Apply saves without closing, Done saves and closes, Reset restores defaults
• Open/close fade, options fading in one after another on tab switches, animated hover
• The NeoForge build also uses this screen instead of the vanilla ConfigurationScreen

Map experience

• Smooth scale animation on open/close, the black overlay is gone
• Zoom is remembered per world (new "Remember map zoom" option, on by default)
• Closing releases only the big texture and keeps the 1/4 copy, so reopening is instant while the big texture rebuilds
• The biome overlay is built in the background — no more stutter when enabling it
• Biome boundaries are now a continuous 75% / 25% opacity checkerboard
• Biome labels are placed at the centre of the largest inscribed circle, never outside the region
• Unified panel opacity tiers (buttons 75%, floating menus 88%, dialogs 90%, info plates 40%) with smooth accent-tint hover
• All map-screen text is drawn with shadow for readability

Data and performance

• New rendered-colour cache color.vxc: first open after a restart takes about 1–2 s (skips the ~5 s re-render)
• Caches are now per-world directories: voxymap-cache/<hash>/ (map.vxm + color.vxc + state.properties); old flat caches are cleaned up automatically
• Textures are built on a worker thread, only the GPU upload runs on the main thread; a 1/4-resolution copy is shown while the big texture is being built
• Fixed the map opening triggering an unnecessary refresh ("Refreshing map… 0%" showing on open)

Languages

• Added 繁體中文, 日本語, Русский, Deutsch, Français, Español, Português (BR)
• 9 languages in total: English, 简体中文, 繁體中文, 日本語, Русский, Deutsch, Français, Español, Português (BR)

中文更新日志

新平台

• 新增 Fabric 26.2 与 Fabric 26.1.2（Stonecutter 单工程多版本构建，同一份源码）
• NeoForge 1.21.1 版同步全部界面与新特性

配置界面重做

• 自绘配置界面：四个分组标签页、每项带说明、分组之间的分割线
• 三种控件：开关、下拉、滑块（可拖动，也可点击数值手动输入）
• 草稿模式：取消 = 丢弃修改；应用 = 保存但不关闭；完成 = 保存并关闭；重置 = 恢复默认值
• 打开/关闭淡入淡出、切换标签页时选项依次淡入、悬停平滑动画
• NeoForge 侧同样使用自绘界面（不再跳转原生 ConfigurationScreen）

地图体验

• 打开/关闭地图改为平滑缩放动画，去掉了黑色遮罩
• 每个世界记住缩放（新增配置项「保留地图缩放」，默认开启）
• 关闭地图只释放大图、保留 1/4 小图，重开瞬间可见，大图后台重建
• 群系叠加改为后台生成，开启时不再卡顿
• 群系边界改为 75% / 25% 不透明度交替的连续棋盘格虚线
• 群系名标签位置改为区域最大内切圆中心，不再跑到区域外
• 界面透明度分层统一（按钮 75%、浮层 88%、对话框 90%、信息条 40%），悬停统一为平滑的强调色叠加
• 地图界面文字统一带阴影，更易读

数据与性能

• 新增渲染结果缓存 color.vxc：重启游戏后首次开图约 1–2 秒（约 5 秒的重新渲染被跳过）
• 缓存改为每世界独立目录：voxymap-cache/<hash>/（map.vxm + color.vxc + state.properties），旧的散落缓存会自动清理
• 大纹理在后台线程构建，主线程只做 GPU 上传；打开地图时先显示小图
• 修复：打开地图误触发刷新（顶部出现「正在刷新地图… 0%」）的问题

语言

• 新增 繁體中文、日本語、Русский、Deutsch、Français、Español、Português (BR)
• 目前共 9 种语言：English、简体中文、繁體中文、日本語、Русский、Deutsch、Français、Español、Português (BR)

下载 / Downloads

File	Platform	MC
voxy-map-0.2.0+26.2+fabric.jar	Fabric	26.2
voxy-map-0.2.0+26.1.2+fabric.jar	Fabric	26.1.2
voxy-map-0.2.0+1.21.1+neoforge.jar	NeoForge	1.21.1

安装提醒 / Notes

• 纯客户端模组，不需要装到服务端 / Client-side only
• Fabric 需要 Fabric API 与对应版本的 Voxy；NeoForge 需要 Voxy、Roxy、Sodium / Fabric needs Fabric API + matching Voxy; NeoForge needs Voxy, Roxy, Sodium
• 推荐搭配 Voxy SeedGen / Voxy SeedGen is recommended
• 目前只绘制主世界 / Only the overworld is drawn for now

Voxy Map 0.1.0 for Minecraft 1.21.1 NeoForge

A fullscreen world map read directly from Voxy's LOD storage — no chunk loading. The first build takes about 10–20 seconds depending on the explored area; after that it opens instantly from the cache.

Highlights

• Six palettes; contour lines, hillshade, water depth, biome boundaries and labels
• Map scale slider (1:1–1:8); palette, overlays and scale are remembered per world
• World rendering is paused while the map is open; one disk cache per world (5 kept)

Requires Minecraft 1.21.1 · NeoForge 21.1.224+ · Voxy · Roxy · Sodium (Voxy SeedGen recommended)

Install Drop voxy-map-0.1.0+1.21.1.jar+neoforge into mods, launch, press N.

Known limitations Overworld only (Nether/End show a notice); the cache does not invalidate automatically — press Refresh.

---

直接读取 Voxy LOD 存储的全屏世界地图，不加载区块。首次生成视探索范围约 10–20 秒，之后复用缓存秒开。

功能

• 6 种配色；等高线、山体阴影、水深、群系边界与标签
• 地图比例滑块（1:1–1:8）；配色、叠加层与比例按世界独立记忆
• 打开地图时暂停世界渲染；每个存档一份缓存（自动保留 5 份）

需要 Minecraft 1.21.1 · NeoForge 21.1.224+ · Voxy · Roxy · Sodium（推荐 Voxy SeedGen）

安装 把 voxy-map-0.1.0+1.21.1.jar+neoforge 放进 mods，启动后按 N。

已知限制 仅主世界（下界/末地只显示提示）；缓存不会自动失效，点「刷新」重建。