Voxy Map
所见即所得——地图会根据你的可视范围绘制内容。Voxy Map 将 Voxy 现有的 LOD 数据实时转换为全屏地图:无需加载区块,也不会生成世界;你能看到的世界都会变成 3D 地形地图。
截图
介绍
Voxy Map

眼见即所得——地图会精确绘制你视野所及的范围。Voxy Map 会将 Voxy 已有的 LOD 数据实时转换为全屏地图:无需加载区块,也不会生成世界——你能看到的世界都会变成 3D 地形地图。
仅客户端。Fabric 26.2 · Fabric 26.1.2 · NeoForge 1.21.1。
搭配 Voxy SeedGen 效果更佳——它会根据世界种子预生成远处的地形,因此连你从未实际加载过的地方也能绘制到地图上:https://www.curseforge.com/minecraft/mc-mods/voxy-seedgen

Voxy Map 的特点
- 方块真实配色——现在地图可以按每种方块的实际颜色绘制,且这也是默认样式;目前仅支持原版方块,后续计划加入模组支持。
- 一眼纵览整个世界——地图直接使用 Voxy 已存储的 LOD 数据构建,因此打开后即可一次看到所有已探索区域;地图打开期间不会加载或生成任何内容,你游玩时新探索的区域也会出现在地图上。
- 打开迅速,运行流畅——首次打开需要几秒钟,每个世界都会单独缓存,因此之后(即使重启游戏)也几乎能瞬间打开;地图打开时会暂停世界渲染,让帧率留给地图。
- 可自由旋转的 3D 地图——由 GPU 渲染的地形,比例为真实 1:1:点击鼠标中键切换,拖动旋转,滚轮缩放;地图实时更新,运行流畅。
- 平滑动画——地图会平滑缩放,滚轮缩放以光标位置为中心,按空格可平滑移至玩家位置,退出 3D 时会短暂旋转回平面地图,2D 与 3D 模式之间切换也很流畅。
- 兼容你的整合包——支持 Fabric 26.2 / 26.1.2 和 NeoForge 1.21.1;兼容 Voxy SeedGen、地形模组和生物群系模组;支持 9 种语言。
- 好看又好调整——提供七种调色板(默认使用包含 200 种颜色的 方块配色 材质调色板)、等高线、山体阴影、水深着色、生物群系边界和名称标签、右键菜单(复制 / 传送 / 导出 PNG)、每个世界独立记忆设置,以及逐项说明所有选项的游戏内配置界面。
截图
全屏地图
使用 Tectonic 模组的“i use voxy btw”预设地形,Voxy SeedGen 距离为 382 个区块,黄色方框 = 实际渲染距离:

原版地形,Voxy SeedGen 距离为 382 个区块,黄色方框 = 实际渲染距离:

原版地形,Voxy SeedGen 距离为 382 个区块,黄色方框 = 实际渲染距离:

近景:等高线、山体阴影、水深着色、生物群系边界和名称标签:

3D 模式:



配置界面:

六种调色板
使用 Tectonic 模组的“i use voxy btw”预设地形,Voxy SeedGen 距离为 382 个区块,黄色方框 = 实际渲染距离(自然 / 渐变 / GMT / 航海 / 渐变涡轮 / 柔和渐变):

快速开始
| 构建 | 安装 |
|---|---|
| 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 |
- 从 Releases下载对应的 jar 文件,将它放入
mods/,启动游戏并按下 N。 - 首次打开需要约 10–20 秒,具体取决于已探索区域的大小;之后每个世界都会缓存,再次打开只需 1–2 秒,同一游戏会话中打开和关闭地图则是即时的。
操作说明
| 操作 | 默认按键 |
|---|---|
| 打开 / 关闭地图 | N |
| 重新以玩家为中心 | Space |
| 缩放 | 鼠标滚轮 |
| 平移 | 按住鼠标左键拖动 |
| 切换 2D ↔ 3D | 点击鼠标中键,或点击 3D 按钮 |
| 旋转 3D 摄像机 | 按住鼠标中键拖动 |
| 地图菜单 | 鼠标右键(复制坐标 / 传送 / 导出 PNG) |
| 调试面板 | Q |
| 关闭 | Esc |
兼容性
- 支持 9 种语言:English、简体中文、繁體中文、日本語、Русский、Deutsch、Français、Español、Português (BR);所有文本均可翻译,因此资源包可以覆盖现有语言或添加新语言。
- 地形模组:海平面和颜色范围会从世界的实际数据中读取,因此自定义地形也能保持正确的海岸线和色彩分布(截图使用的是 Tectonic 地形)。
- 生物群系模组:生物群系名称和边界来自世界存储的数据,模组添加的生物群系名称也会随游戏语言显示。
- 仅客户端——服务器无需安装任何内容。
- Xaero’s Minimap(可选):读取 Xaero’s Minimap 中的航点,并可通过 Voxy Map 的右键菜单添加航点。
配置
所有选项都在游戏内配置界面中,并附有说明。你也可以直接编辑配置文件:Fabric config/voxymap-client.json,NeoForge config/voxymap-client.toml。配置只会为新世界设置默认值;每个世界都会分别记住自己的调色板、叠加层、地图比例和缩放级别。
完整选项列表见 TECHNICAL.md。
常见问题
- 地图只显示了世界的一部分 / 边缘是黑色的? Voxy 未安装(NeoForge 还需要 Roxy),或者未安装 SeedGen,此时地图只会显示 Voxy 实际存储的区域。黑色边缘表示“没有数据”,并非渲染错误。
- 地图刚打开时显示不正常?加载完成后会自动修正;如果仍然显示异常,请点击右下角的 刷新。
- 帧率感觉偏低?保持
skipWorldRender启用(默认开启);关闭生物群系叠加层或使用更粗略的地图比例也有帮助。 - 地图上只显示了部分图块?这很可能是显存预算不足;请在配置界面中根据显卡显存调整预算。
已知限制
- 目前仅支持主世界——不会绘制下界和末地。
- 生物群系通过注册表名称匹配,因此不同模组中名称相同的生物群系偶尔可能冲突。
实现细节、完整选项列表和构建说明:TECHNICAL.md。
支持
- 问题反馈和建议:https://github.com/Tsutsutsuu/voxy-map/issues
- 地图数据:Voxy · 远距离预生成:Voxy SeedGen
许可证
MIT——详见 LICENSE。图标和截图 © Tsutsutsuu。
常见问题
Voxy Map 支持哪些 Minecraft 版本?
Voxy Map 支持 Minecraft Java 版 1.21.1–26.2,共 3 个版本,可用的加载器:Fabric / NeoForge。下载时注意选择和你游戏版本一致的文件。
Voxy Map 怎么安装?
先用 PCL2 或 HMCL 启动器安装对应版本的 Fabric / NeoForge,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。
评论
登录后评论和评分