BlueMap - 更新日志

基本信息

我的世界Java版本

平台

运行环境

其他链接

反馈问题查看源码

Modrinth地址

搬运团队

BBSMC 官方搬运(1)团队

搬运资源声明

对于可进行 JAR 文件搬运的许可证，我们提供站内下载服务；其他资源会跳转到原帖下载。资源更新可能不及时，建议前往资源内提供的原帖链接下载最新版本。

详情信息

许可证 MIT

发布于 a year ago

更新于 a month ago

5.13-fabric

on 2025 Nov 05

下载

亮点 / 说明

新增了铜箱子（copper-chests）和铜傀儡雕像（coppergolem statues）的模型。
同时回退了 5.12 版本中集成 Web 服务器的更改。
(由于虚拟线程与数据库存储结合使用时存在一些问题，可能导致 Web 服务器无响应。该问题在 Java 24+ 中已解决，但只要 BlueMap 仍支持 Java 21，我们将恢复为之前的 Web 服务器实现)

从 5.12 版本升级

将 bluemap.jar 文件替换为新版本文件

自 5.12 版本以来的更新日志

新增铜箱子的模型
新增铜傀儡雕像的模型
新增 attached=false 的悬挂告示牌模型
新增所有苍白橡木（pale-oak）告示牌的模型
回退 5.12 版本中集成 Web 服务器的更改
修复 Forge 1.21.9+ 上的加载错误 (#743)
当连续多次更新同一区域文件时，增加更新冷却时间
资源包中现在也会扫描 item 文件夹以查找方块模型（修复了与 ItemsAdder 资源包的兼容性问题）
修复并改进了多个小型代码问题

完整更新日志

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.13

5.13-sponge

on 2025 Nov 05

下载

亮点 / 说明

新增了铜箱子（copper-chests）和铜傀儡雕像（coppergolem statues）的模型。
同时回退了 5.12 版本中集成的 Web 服务器更改。
(由于虚拟线程与数据库存储结合使用时存在一些问题，可能导致 Web 服务器无响应。该问题在 Java 24+ 中已解决，但只要 BlueMap 仍支持 Java 21，我们将恢复为之前的 Web 服务器实现)

从 5.12 版本升级

将 bluemap.jar 文件替换为新版本文件

自 5.12 版本以来的更新日志

新增铜箱子的模型
新增铜傀儡雕像的模型
新增 attached=false 的悬挂告示牌模型
新增所有苍白橡木（pale-oak）告示牌的模型
回退 5.12 版本中的集成 Web 服务器更改
修复 Forge 1.21.9+ 上的加载错误 (#743)
当连续多次更新同一区域文件时，增加更新冷却时间
资源包中现在也会扫描 item 文件夹以查找方块模型（修复了与 ItemsAdder 资源包的兼容性问题）
修复并优化了多个小型代码问题

完整更新日志

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.13

5.13-spigot

on 2025 Nov 05

下载

亮点 / 说明

从 5.12 版本升级

将 bluemap.jar 文件替换为新版本文件

自 5.12 版本以来的更新日志

新增铜箱子的模型
新增铜傀儡雕像的模型
新增 attached=false 的悬挂告示牌模型
新增所有苍白橡木（pale-oak）告示牌的模型
回退 5.12 版本中集成 Web 服务器的更改
修复 Forge 1.21.9+ 上的加载错误 (#743)
当连续多次更新同一区域文件时，增加更新冷却时间
资源包中现在也会扫描 item 文件夹以查找方块模型（修复了与 ItemsAdder 资源包的兼容性问题）
修复并优化了多个小型代码问题

完整更新日志

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.13

5.13-neoforge

on 2025 Nov 05

下载

亮点 / 说明

从 5.12 版本升级

将 bluemap.jar 文件替换为新版本文件

自 5.12 版本以来的更新日志

新增铜箱子的模型
新增铜傀儡雕像的模型
新增 attached=false 的悬挂告示牌模型
新增所有苍白橡木（pale-oak）告示牌的模型
回退 5.12 版本中集成 Web 服务器的更改
修复 Forge 1.21.9+ 上的加载错误 (#743)
当连续多次更新同一区域文件时，增加冷却时间
资源包中也会扫描 item 文件夹以查找方块模型（修复与 ItemsAdder 资源包的兼容性问题）
修复并优化了多个小型代码问题

完整更新日志

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.13

5.13-forge

on 2025 Nov 05

下载

亮点 / 说明

新增了铜箱子（copper-chests）和铜傀儡雕像（coppergolem statues）的模型。
同时回退了 5.12 版本中集成的 Web 服务器更改。
(在将虚拟线程与数据库存储结合使用时存在一些问题，可能导致 Web 服务器无响应。该问题在使用 Java 24+ 时已解决，但由于 BlueMap 仍支持 Java 21，因此我们回退到之前的 Web 服务器实现)

从 5.12 升级

将 bluemap.jar 文件替换为新版本文件

自 5.12 版本以来的更新日志

新增铜箱子的模型
新增铜傀儡雕像的模型
新增 attached=false 的悬挂告示牌模型
新增所有苍白橡木（pale-oak）告示牌的模型
回退 5.12 版本中的集成 Web 服务器更改
修复 Forge 1.21.9+ 上的加载错误 (#743)
当连续多次更新同一个区域文件时，添加了冷却时间
资源包中现在也会扫描 item 文件夹以查找方块模型（修复了与 ItemsAdder 资源包的兼容性问题）
修复并改进了多个小型代码问题

完整更新日志

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.13

5.13-paper

on 2025 Nov 05

下载

亮点 / 说明

新增了铜箱子（copper-chests）和铜傀儡雕像（coppergolem statues）的模型。
并回退了 5.12 版本中集成 Web 服务器的更改。
(由于虚拟线程与数据库存储结合使用时存在一些问题，可能导致 Web 服务器无响应。该问题在使用 Java 24+ 时已解决，但由于 BlueMap 仍支持 Java 21，因此我们回退到之前的 Web 服务器实现)

从 5.12 版本升级

将 bluemap.jar 文件替换为新版本文件

自 5.12 版本以来的更新日志

新增铜箱子的模型
新增铜傀儡雕像的模型
新增 attached=false 的悬挂告示牌模型
新增所有苍白橡木（pale-oak）告示牌的模型
回退 5.12 版本中集成 Web 服务器的更改
修复 Forge 1.21.9+ 上的加载错误 (#743)
当连续多次更新同一区域文件时，增加冷却时间
资源包中现在也会扫描 item 文件夹以查找方块模型（修复了与 ItemsAdder 资源包的兼容性问题）
修复并改进了多个小型代码问题

完整更新日志

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.13

5.12-mc1.20-6-forge

on 2025 Oct 08

下载

亮点 / 注意事项

由于需求极高，此为 BlueMap 5.12 针对 Forge 1.20 - 1.20.4（包括 1.20.1）的一次性回退移植版本。

此版本需要 Java 21 才能运行！
Forge 和大多数模组应可在 Java 21 上正常运行，替代 Java 17。如果你无法使用 Java 21，则需改用 BlueMap 5.3。

从 5.3 版本升级

此前支持 Forge 1.20.x 的 BlueMap 版本是 5.3，因此你很可能正从该版本升级。

此次更新包含大量变更和新的配置项等，因此强烈建议你对 BlueMap 进行一次完整的干净安装：

停止服务器
备份数据
删除当前的 ./mods/bluemap-x-yz.jar
删除 ./config/bluemap 文件夹
删除 ./bluemap 目录
将新的 bluemap-5.12-mc1.20-6-forge.jar 放入 ./mods 文件夹
启动服务器
使用新生成的配置文件重新配置 BlueMap
你可以保留备份中的旧配置文件，以便参考迁移设置
执行命令 /bluemap reload

如果你不想进行干净安装，并希望保留当前已渲染的地图，请按照以下更新日志中的升级步骤操作：

更新日志

请参阅以下链接查看完整更新日志： https://github.com/BlueMap-Minecraft/BlueMap/releases

5.12-fabric

on 2025 Oct 08

下载

亮点 / 说明

完整支持 1.21.9，重构集成 Web 服务器，并带来更多错误修复和改进！

从 5.11 升级

将 bluemap.jar 文件替换为新版本

自 5.11 版本以来的更新日志

更新 Fabric 实现至 1.21.9
重构集成 Web 服务器，从 NIO 迁移至虚拟线程（Virtual-Threads），提升性能与可维护性
为资源包版本 67 添加 chain → iron_chain 的重映射，以增强向后兼容性
在方块颜色配置中添加对方块属性的支持
添加对插件依赖项和软依赖项的支持 (#730)
BlueMapAPI 升级至 2.7.6
改进区域/区块加载错误的日志输出
修复 Paper 在非正式版本（快照版、预发布版、候选发布版）中读取错误的 Minecraft 版本 ID 的问题
修复元素默认 UV 计算，修正了炼药锅和仙人掌花盆的显示问题
修复西瓜和南瓜藤蔓着色不正确的问题 (#734)
修复内翻立方体不生效的问题，修正所有刷怪笼方块的外观
修复 /bluemap debug map ... 命令中显示错误瓦片坐标的问题
修复环境光遮蔽（ambient-occlusion）属性未能从父级方块模型继承的问题（感谢 Uiniel，#729）
修复 Web 服务器对 HTTP "path" 绝对路径格式处理不当的问题 (#737)
修复旧版配置错误未显示具体问题配置文件的问题

完整更新日志

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.12

5.12-spigot

on 2025 Oct 08

下载

亮点 / 说明

完整支持 1.21.9，重构集成 Web 服务器，并带来更多错误修复和改进！

从 5.11 升级

将 bluemap.jar 文件替换为新版本

自 5.11 版本以来的更新日志

更新 Fabric 实现至 1.21.9
重构集成 Web 服务器，从 NIO 迁移至虚拟线程（Virtual-Threads），提升性能与可维护性
为资源包版本 67 添加 chain → iron_chain 的重映射，以增强向后兼容性
在方块颜色配置中添加对方块属性的支持
添加对插件依赖项和软依赖项的支持 (#730)
BlueMapAPI 升级至 2.7.6
改进区域/区块加载错误的日志输出
修复 Paper 在非正式版本（快照版、预发布版、候选发布版）下读取错误的 Minecraft 版本 ID 的问题
修复元素默认 UV 计算，修正了炼药锅和仙人掌花盆的显示问题
修复西瓜和南瓜茎方块颜色不正确的问题 (#734)
修复内翻立方体不生效的问题，修正所有刷怪笼方块的外观
修复 /bluemap debug map ... 命令中显示错误瓦片坐标的问题
修复环境光遮蔽（ambient-occlusion）属性未能从父级方块模型继承的问题（感谢 Uiniel，#729）
修复 Web 服务器对 HTTP "path" 的绝对路径格式处理不当的问题 (#737)
修复旧版配置错误未显示具体问题配置文件的问题

完整更新日志

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.12

5.12-sponge

on 2025 Oct 08

下载

亮点 / 说明

完整支持 1.21.9，重构集成 Web 服务器，并带来更多错误修复和改进！

从 5.11 升级

将 bluemap.jar 文件替换为新版本

自 5.11 版本以来的更新日志

更新 Fabric 实现至 1.21.9
重构集成 Web 服务器，从 NIO 迁移至虚拟线程（Virtual-Threads），提升性能与可维护性
为资源包版本 67 添加 chain → iron_chain 的重映射，以增强向后兼容性
在方块颜色配置中添加对 block-properties 的支持
添加对插件依赖项和软依赖项的支持 (#730)
BlueMapAPI 升级至 2.7.6
改进区域/区块加载错误的日志输出
修复 Paper 在非正式版本（快照版、预发布版、RC 版）时读取错误的 Minecraft 版本 ID 的问题
修复元素默认 UV 计算，修正了炼药锅和仙人掌花盆的显示问题
修复西瓜和南瓜茎方块颜色不正确的问题 (#734)
修复内翻立方体不生效的问题，修正所有刷怪笼方块的外观
修复 /bluemap debug map ... 命令中显示错误瓦片坐标的问题
修复环境光遮蔽（ambient-occlusion）属性从父级方块模型继承的问题（感谢 Uiniel，#729）
修复 Web 服务器对 HTTP "path" 绝对路径格式处理不当的问题 (#737)
修复旧版配置错误未显示具体问题配置文件的问题

完整更新日志

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.12

5.12-forge

on 2025 Oct 08

下载

亮点 / 说明

完整支持 1.21.9，重构集成 Web 服务器，并带来更多错误修复和改进！

从 5.11 升级

将 bluemap.jar 文件替换为新版本

自 5.11 版本以来的更新日志

更新 Fabric 实现至 1.21.9
重构集成 Web 服务器，从 NIO 迁移至虚拟线程（Virtual-Threads），提升性能与可维护性
为资源包版本 67 添加 chain → iron_chain 的重映射，以增强向后兼容性
在方块颜色配置中添加对方块属性的支持
添加对插件依赖项和软依赖项的支持 (#730)
BlueMapAPI 升级至 2.7.6
改进区域/区块加载错误的日志输出
修复 Paper 在非正式版本（快照版、预发布版、候选发布版）中读取错误的 Minecraft 版本 ID 的问题
修复元素默认 UV 计算，修正了炼药锅和仙人掌花盆的显示问题
修复西瓜和南瓜茎方块颜色不正确的问题 (#734)
修复内翻立方体不生效的问题，修正所有刷怪笼方块的外观
修复 /bluemap debug map ... 命令中显示错误瓦片坐标的问题
修复环境光遮蔽（ambient-occlusion）属性未能从父级方块模型继承的问题（感谢 Uiniel，#729）
修复 Web 服务器对 HTTP "path" 绝对路径格式处理不当的问题 (#737)
修复旧版配置错误未显示具体问题配置文件的问题

完整更新日志

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.12

5.12-paper

on 2025 Oct 08

下载

亮点 / 说明

完整支持 1.21.9，重构集成 Web 服务器，并带来更多错误修复和改进！

从 5.11 升级

将 bluemap.jar 文件替换为新版本

自 5.11 版本以来的更新日志

更新 Fabric 实现至 1.21.9
重构集成 Web 服务器，从 NIO 迁移至虚拟线程（Virtual-Threads），提升性能与可维护性
为资源包版本 67 添加 chain → iron_chain 的重映射，以增强向后兼容性
在方块颜色配置中添加对方块属性的支持
添加对插件依赖项和软依赖项的支持 (#730)
BlueMapAPI 升级至 2.7.6
改进区域/区块加载错误的日志输出
修复 Paper 在非正式版本（快照版、预发布版、候选发布版）中读取错误 Minecraft 版本 ID 的问题
修复元素默认 UV 计算，修正了炼药锅和仙人掌花盆的显示问题
修复西瓜和南瓜茎秆颜色不正确的问题 (#734)
修复内翻立方体不生效的问题，修正所有刷怪笼方块的外观
修复 /bluemap debug map ... 命令中显示错误瓦片坐标的问题
修复环境光遮蔽（ambient-occlusion）属性未能从父级方块模型继承的问题（感谢 Uiniel，#729）
修复 Web 服务器对 HTTP "path" 绝对路径格式处理不当的问题 (#737)
修复旧版配置错误未显示具体问题配置文件的问题

完整更新日志

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.12

5.12-neoforge

on 2025 Oct 08

下载

亮点 / 说明

完整支持 1.21.9，重构集成的 Web 服务器，并带来更多错误修复和改进！

从 5.11 版本升级

将 bluemap.jar 文件替换为新版本

自 5.11 版本以来的更新日志

更新 Fabric 实现至 1.21.9
重构集成的 Web 服务器，从 NIO 迁移至虚拟线程（Virtual-Threads），提升性能与可维护性
为资源包版本 67 添加 chain → iron_chain 的重映射，以增强向后兼容性
在方块颜色配置中添加对方块属性的支持
添加对插件依赖项和软依赖项的支持 (#730)
BlueMapAPI 升级至 2.7.6
改进区域/区块加载错误的日志输出
修复 Paper 在非正式版本（快照版、预发布版、候选发布版）下读取错误的 Minecraft 版本 ID 的问题
修复元素默认 UV 计算，修正了炼药锅和仙人掌花盆的显示问题
修复西瓜和南瓜藤茎未正确着色的问题 (#734)
修复内部翻转的立方体不生效的问题，修正所有刷怪笼方块的外观
修复 /bluemap debug map ... 命令中显示错误瓦片坐标的问题
修复环境光遮蔽（ambient-occlusion）属性未能从父级方块模型继承的问题（感谢 Uiniel，#729）
修复 Web 服务器对 HTTP "path" 绝对路径格式处理错误的问题 (#737)
修复旧版配置错误时未显示具体问题配置文件的问题

完整更新日志

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.12

5.11-spigot

on 2025 Aug 24

下载

亮点/注释

使用渲染掩码，现在可以将地图渲染限制为各种形状，并完美控制地图上要显示的内容以及哪些区域应保持隐藏。

从 5.10 升级

用新的 bluemap.jar 文件替换旧的
删除你的 <webroot>/index.html 以使 bluemap 更新 Web 应用程序
你需要更新你的地图配置！
- 在你的地图配置文件中找到带有 min-x、max-x、min-z、max-z、min-y 和 max-y 的部分，例如：
```
#min-x: -4000
#max-x: 4000
#min-z: -4000
#max-z: 4000
#min-y: 50
max-y: 90
```
  并在该部分之前添加 render-mask: [ {，在该部分之后添加 ] }，例如：
```
render-mask: [ 
  {
    #min-x: -4000
    #max-x: 4000
    #min-z: -4000
    #max-z: 4000
    #min-y: 50
    max-y: 90
  }
]
```
  -> 这里有一个视频示例
- 可选地，你也可以在地图配置中添加新的 edge-light-strength: 15 属性

自 5.10 以来的变更日志

在地图配置中添加了 render-mask 列表，替换了以前的 min-x、max-z 等属性 (#81)
在地图配置中添加了 edge-light-strength，以在启用 render-edges 时控制地图边缘的照明
默认情况下，自定义维度现在按最后顺序排序
改进了默认地图配置的结构和注释
添加了对 Minecraft Snapshot 25w31a 中引入的次要包版本的支持
修复了睡莲没有色调颜色的问题 (#727)
修复了如果生物群系水颜色有 alpha 时的错误 (#715)
将 bluemap-api 更新到 2.7.5

完整变更日志

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.11

5.9-spigot

on 2025 Aug 24

下载

亮点 / 注释

修复了 5.8 引入的 2 个无害但恼人的问题也查看一下 5.8 的变更日志！

从 5.8 升级

用新的 bluemap.jar 文件替换旧的

5.8 之后的变更日志

修复了一个（无害的）非法状态异常
修复了一个我忘记再次删除的调试日志

完整变更日志

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.9

5.11-fabric

on 2025 Aug 08

下载

亮点/注释

使用渲染掩码，现在可以将地图渲染限制为各种形状，并完美控制地图上想要显示的内容以及哪些区域应保持隐藏。

从 5.10 升级

用新的bluemap.jar文件替换bluemap.jar文件
删除你的<webroot>/index.html以使 bluemap 更新 webapp
你需要更新你的地图配置！
- 在你的地图配置文件中找到带有min-x、max-x、min-z、max-z、min-y和max-y的部分，例如：
```
#min-x: -4000
#max-x: 4000
#min-z: -4000
#max-z: 4000
#min-y: 50
max-y: 90
```
  并在该部分之前添加render-mask: [ {，在该部分之后添加] }，例如：
```
render-mask: [ 
  {
    #min-x: -4000
    #max-x: 4000
    #min-z: -4000
    #max-z: 4000
    #min-y: 50
    max-y: 90
  }
]
```
  -> 这里有一个视频示例
- 可选地，你也可以在地图配置中添加新的edge-light-strength: 15属性

自 5.10 以来的变更日志

在地图配置中添加了render-mask列表，取代了以前的min-x、max-z等属性(#81)
在地图配置中添加了edge-light-strength，以在启用render-edges时控制地图边缘的光照
默认情况下，自定义维度现在最后排序
改进了默认地图配置的结构和注释
增加了对 Minecraft Snapshot 25w31a 中引入的次要包版本的支持
修复了睡莲没有色调颜色的问题(#727)
修复了如果生物群系水色有 alpha 时的错误(#715)
将 bluemap-api 更新到 2.7.5

完整变更日志

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.11

5.11-sponge

on 2025 Aug 08

下载

亮点/注释

使用渲染掩码，现在可以将地图渲染限制为各种形状，并完美控制地图上想要显示的内容以及哪些区域应保持隐藏。

从 5.10 升级

用新的bluemap.jar文件替换bluemap.jar文件
删除你的<webroot>/index.html以让 bluemap 更新 webapp
你需要更新你的地图配置！
- 在你的地图配置文件中找到带有min-x、max-x、min-z、max-z、min-y和max-y的部分，例如：
```
#min-x: -4000
#max-x: 4000
#min-z: -4000
#max-z: 4000
#min-y: 50
max-y: 90
```
  并在该部分之前添加render-mask: [ {，在该部分之后添加] }，例如：
```
render-mask: [ 
  {
    #min-x: -4000
    #max-x: 4000
    #min-z: -4000
    #max-z: 4000
    #min-y: 50
    max-y: 90
  }
]
```
  -> 这里有一个视频示例
- 可选地，你也可以在地图配置中添加新的edge-light-strength: 15属性

自 5.10 以来的变更日志

在地图配置中添加了render-mask列表，替换了之前的min-x、max-z等属性(#81)
在地图配置中添加了edge-light-strength，以在render-edges启用时控制地图边缘的照明
默认情况下，自定义维度现在最后排序
改进了默认地图配置的结构和注释
添加了对 Minecraft Snapshot 25w31a 中引入的次要包版本的支持
修复了睡莲没有色调颜色的问题(#727)
修复了如果生物群系水色有 alpha 时的错误(#715)
将 bluemap-api 更新到 2.7.5

完整变更日志

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.11

5.11-spigot

on 2025 Aug 08

下载

亮点 / 注释

使用渲染掩码，现在可以将地图渲染限制为各种形状，并完美控制在地图上想要显示的内容以及哪些区域应保持隐藏。

从 5.10 升级

用新的 bluemap.jar 文件替换旧的
删除你的 <webroot>/index.html 以使 bluemap 更新 Web 应用程序
你需要更新你的地图配置！
- 在你的地图配置文件中找到带有 min-x、max-x、min-z、max-z、min-y 和 max-y 的部分，例如：
```
#min-x: -4000
#max-x: 4000
#min-z: -4000
#max-z: 4000
#min-y: 50
max-y: 90
```
  并在该部分之前添加 render-mask: [ {，在该部分之后添加 ] }，例如：
```
render-mask: [ 
  {
    #min-x: -4000
    #max-x: 4000
    #min-z: -4000
    #max-z: 4000
    #min-y: 50
    max-y: 90
  }
]
```
  -> 这里有一个视频示例
- 可选地，你还可以在地图配置中添加新的 edge-light-strength: 15 属性

自 5.10 以来的变更日志

在地图配置中添加了 render-mask 列表，替换了之前的 min-x、max-z 等属性 (#81)
在地图配置中添加了 edge-light-strength，以在启用 render-edges 时控制地图边缘的照明
默认维度现在默认按最后顺序排序
改进了默认地图配置的结构和注释
添加了对 Minecraft Snapshot 25w31a 中引入的次要包版本的支持
修复了睡莲没有色调颜色的问题 (#727)
修复了如果生物群系水颜色有 alpha 时的错误 (#715)
将 bluemap-api 更新到 2.7.5

完整变更日志

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.11

5.11-paper

on 2025 Aug 08

下载

亮点 / 注释

使用渲染掩码，现在可以将地图渲染限制为各种形状，并完美控制地图上想要显示的内容以及哪些区域应保持隐藏。

从 5.10 升级

用新的 bluemap.jar 文件替换旧的
删除你的 <webroot>/index.html 以使 bluemap 更新 Web 应用程序
你需要更新你的地图配置！
- 在你的地图配置文件中找到带有 min-x、max-x、min-z、max-z、min-y 和 max-y 的部分，例如：
```
#min-x: -4000
#max-x: 4000
#min-z: -4000
#max-z: 4000
#min-y: 50
max-y: 90
```
  并在该部分之前添加 render-mask: [ {，在该部分之后添加 ] }，例如：
```
render-mask: [ 
  {
    #min-x: -4000
    #max-x: 4000
    #min-z: -4000
    #max-z: 4000
    #min-y: 50
    max-y: 90
  }
]
```
  -> 这里有一个视频示例
- 可选地，你也可以在地图配置中添加新的 edge-light-strength: 15 属性

自 5.10 以来的变更日志

在地图配置中添加了 render-mask 列表，取代了以前的 min-x、max-z 等属性 (#81)
在地图配置中添加了 edge-light-strength，以在启用 render-edges 时控制地图边缘的照明
默认情况下，自定义维度现在按最后顺序排序
改进了默认地图配置的结构和注释
添加了对 Minecraft Snapshot 25w31a 中引入的次要包版本的支持
修复了睡莲没有色调颜色的问题 (#727)
修复了如果生物群系水颜色有 alpha 时的错误 (#715)
将 bluemap-api 更新到 2.7.5

完整变更日志

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.11

5.11-neoforge

on 2025 Aug 08

下载

亮点 / 注释

使用渲染掩码，现在可以将地图渲染限制为各种形状，并完美控制地图上想要显示的内容以及哪些区域应保持隐藏。

从 5.10 升级

用新的 bluemap.jar 文件替换旧的
删除你的 <webroot>/index.html 以使 bluemap 更新 webapp
你需要更新你的地图配置！
- 在你的地图配置文件中找到带有 min-x、max-x、min-z、max-z、min-y 和 max-y 的部分，例如：
```
#min-x: -4000
#max-x: 4000
#min-z: -4000
#max-z: 4000
#min-y: 50
max-y: 90
```
  并在该部分之前添加 render-mask: [ {，在该部分之后添加 ] }，例如：
```
render-mask: [ 
  {
    #min-x: -4000
    #max-x: 4000
    #min-z: -4000
    #max-z: 4000
    #min-y: 50
    max-y: 90
  }
]
```
  -> 这里有一个视频示例
- 可选地，你还可以在地图配置中添加新的 edge-light-strength: 15 属性

自 5.10 以来的变更日志

在地图配置中添加了 render-mask 列表，取代了之前的 min-x、max-z 等属性 (#81)
在地图配置中添加了 edge-light-strength，以在启用 render-edges 时控制地图边缘的照明
默认情况下，自定义维度现在按最后顺序排序
改进了默认地图配置的结构和注释
添加了对 Minecraft Snapshot 25w31a 中引入的次要包版本的支持
修复了睡莲没有色调颜色的问题 (#727)
修复了生物群系水颜色有 alpha 的错误 (#715)
将 bluemap-api 更新到 2.7.5

完整变更日志

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.11