Repository navigation
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
biomeColorsoption (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_mappingsscan 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 (
keep3dTilesIn2donly 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.1chainuses the neutral fallback and may differ slightly from the other builds