Skip to content

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

Choose a tag to compare

@Tsutsutsuu Tsutsutsuu released this 12 Nov 06:50
· 6 commits to main since this release

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