Repository navigation
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 (
verticalScale3dis 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
Qpanel 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