5.17-paper
on 2026 Mar 24亮点 / 说明
现已要求使用 Java 25,并已添加对 Minecraft 26.1 的支持。
从 5.16 升级
- 用新的
bluemap.jar文件替换旧文件 - 删除你的
<webroot>/index.html,以便让 bluemap 更新网页应用
自 5.16 以来的更新日志
- 已切换至 Java 25
- 已添加对 Minecraft 26.1 世界格式变更的支持
- 已切换为基于虚拟线程的网页服务器实现
- 已停止在图片写入时使用临时缓存文件
- 已修复当区块时间戳为 0 时无法渲染的问题
- 已修复一个可能导致服务端崩溃的罕见竞争条件
- 已修复使用 CUSTOM 格式的大型材质会导致 bluemap 加载卡死的问题
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.17
5.17-neoforge
on 2026 Mar 24亮点 / 注意事项
现在需要 Java 25,并已添加对 Minecraft 26.1 的支持。
从 5.16 升级
- 用新的
bluemap.jar文件替换旧文件 - 删除你的
<webroot>/index.html,以便让 bluemap 更新网页应用
自 5.16 以来的更新日志
- 已切换至 Java 25
- 已添加对 Minecraft 26.1 世界格式变更的支持
- 已切换为基于虚拟线程的网页服务器实现
- 不再使用临时缓存文件来写入图片
- 修复了当区块时间戳为 0 时无法渲染的问题
- 修复了一个罕见的竞争条件,该问题可能导致服务端崩溃
- 修复了使用 CUSTOM 格式的大型材质会导致 bluemap 加载卡死的问题
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.17
5.17-fabric
on 2026 Mar 24亮点 / 说明
现已要求 Java 25,并添加了对 Minecraft 26.1 的支持。
从 5.16 升级
- 用新的
bluemap.jar文件替换旧文件 - 删除你的
<webroot>/index.html,以让 bluemap 更新 webapp
自 5.16 以来的更新日志
- 已切换到 Java 25
- 已添加对 Minecraft 26.1 世界格式变更的支持
- 已切换为基于 virtual-threads 的网页服务器实现
- 已停止在写入图片时使用临时缓存文件
- 已修复当区块的时间戳为 0 时不会渲染的问题
- 已修复一个罕见的竞争条件,它可能导致服务端崩溃
- 已修复使用 CUSTOM 格式的大型材质会导致 bluemap 加载卡死的问题
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.17
5.16-sponge
on 2026 Feb 13亮点/注意事项
一系列较小的新增内容、改进和修复。
从5.15升级
- 用新的
bluemap.jar文件替换旧文件 - 删除您的
<webroot>/index.html以使Bluemap更新Web应用程序
自5.15以来的更改日志
- WebApp: 使用no-cache标头替换用于缓存控制的数字参数 (#762, 感谢Macil)
- WebApp: 在支持的情况下,在自由飞行指针锁定模式下使用unadjustedMovement (#763, 感谢Macil)
- 增加了对“超大区块”的支持 → 存储在区域文件之外的大型区块 (#772)
- 增加了
render-thread-priority配置值,用于设置渲染线程的Java线程优先级 - 增加了RenderPasses,允许插件修改整个瓦片模型,而不必绑定到自定义方块或实体
- 增加了更多日志信息,以便在CLI上监视地图更新时提供更多信息
- 增加了对非标准pack.mcmeta格式的宽容支持
- 改进了API使用者的异常处理
- 改进了解析sponge-dimension目录时的异常处理
- 改进了故障排除命令
- 修复了在解析配置异常时可能发生的死锁
- 修复了未正确从level.dat读取世界重生点位置的问题
- 修复了MapUpdateService线程、Web服务器和调度器的线程名称
- 修复了如果皮肤提供程序返回空皮肤时,玩家皮肤未从地图存储中移除的问题
完整更改日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.16
5.16-spigot
on 2026 Feb 13亮点/注意事项
一些较小的添加、改进和修复。
从5.15升级
- 用新的
bluemap.jar文件替换旧的 - 删除您的
<webroot>/index.html以使Bluemap更新Web应用程序
自5.15以来的更改日志
- WebApp:使用no-cache头替换缓存控制中的数字参数 (#762, 感谢Macil)
- WebApp:在自由飞行指针锁定模式下,如果支持则使用unadjustedMovement (#763, 感谢Macil)
- 增加了对“超大区块”的支持 → 存储在区域文件之外的大区块 (#772)
- 增加了
render-thread-priority配置值,用于设置渲染线程的Java线程优先级 - 增加了RenderPasses,允许插件修改整个瓦片模型而不必绑定到自定义方块或实体
- 增加了在CLI上监视地图更新时的日志信息
- 增加了对非标准pack.mcmeta格式的宽松支持
- 改进了API使用者的异常处理
- 改进了解析sponge-dimension目录时的异常处理
- 改进了故障排除命令
- 修复了在解析配置异常时可能发生的死锁
- 修复了从level.dat中读取世界出生点位置不正确的问题
- 修复了MapUpdateService-Thread、Web服务器和调度器的线程名称
- 修复了当皮肤提供者返回空皮肤时,玩家皮肤未从地图存储中移除的问题
完整更改日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.16
5.16-paper
on 2026 Feb 13亮点/注释
一系列较小的新增功能、改进和修复。
从5.15升级
- 用新的
bluemap.jar文件替换旧的 - 删除你的
<webroot>/index.html以使BlueMap更新Web应用程序
自5.15以来的更新日志
- WebApp: 使用no-cache头替代缓存控制中的数字参数 (#762, 感谢Macil)
- WebApp: 在自由飞行指针锁定模式下,如果支持则使用unadjustedMovement (#763, 感谢Macil)
- 增加了对“超大区块”的支持 → 存储在区域文件之外的大区块 (#772)
- 增加了
render-thread-priority配置值,用于设置渲染线程的Java线程优先级 - 增加了RenderPasses,允许插件修改整个瓦片模型而不必绑定到自定义方块或实体
- 增加了在CLI上监视地图更新时的日志信息
- 增加了对非标准pack.mcmeta格式的宽松支持
- 改进了API使用者的异常处理
- 改进了解析sponge-dimension目录时的异常处理
- 改进了故障排查命令
- 修复了在解析配置异常时可能发生的死锁
- 修复了世界重生点未正确从level.dat中读取的问题
- 修复了MapUpdateService线程、Web服务器和调度器的线程名称
- 修复了当皮肤提供者返回空皮肤时,玩家皮肤未从地图存储中移除的问题
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.16
5.16-neoforge
on 2026 Feb 13亮点/注意事项
一系列较小的添加、改进和修复。
从5.15升级
- 用新的
bluemap.jar文件替换旧文件 - 删除您的
<webroot>/index.html以使Bluemap更新Web应用程序
自5.15以来的更改日志
- WebApp: 使用no-cache标头替换缓存控制中的数字参数 (#762, 感谢Macil)
- WebApp: 如果支持,在自由飞行指针锁定模式下使用unadjustedMovement (#763, 感谢Macil)
- 增加了对“超大区块”的支持 → 存储在区域文件之外的大区块 (#772)
- 增加了
render-thread-priority配置值,用于设置渲染线程的Java线程优先级 - 增加了RenderPasses,允许插件修改整个瓦片模型,而不必绑定到自定义方块或实体
- 增加了更多日志信息,以便在CLI上监视地图更新时提供更多详情
- 增加了对非标准pack.mcmeta格式的宽容支持
- 改进了API使用者的异常处理
- 改进了解析sponge-dimension目录时的异常处理
- 改进了故障排除命令
- 修复了在解析配置异常时可能发生的死锁
- 修复了从level.dat中读取世界生成点位置不正确的问题
- 修复了MapUpdateService-Thread、Web服务器和调度器的线程名称
- 修复了如果玩家皮肤提供程序返回空皮肤时玩家皮肤未从地图存储中移除的问题
完整更改日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.16
5.16-forge
on 2026 Feb 13亮点/注释
一系列较小的新增内容、改进和修复。
从5.15升级
- 用新的
bluemap.jar文件替换旧的 - 删除你的
<webroot>/index.html以使BlueMap更新Web应用程序
自5.15以来的更改日志
- WebApp: 使用no-cache头替换用于缓存控制的数字参数 (#762, 感谢Macil)
- WebApp: 在自由飞行指针锁定模式下,如果支持则使用unadjustedMovement (#763, 感谢Macil)
- 增加了对“超大区块”的支持 → 存储在区域文件之外的大区块 (#772)
- 增加了
render-thread-priority配置值,用于设置渲染线程的Java线程优先级 - 增加了RenderPasses,允许插件修改整个瓦片模型而不必绑定到自定义方块或实体
- 增加了更多日志信息,以便在CLI上监视地图更新时提供更多详情
- 增加了对非标准pack.mcmeta格式的宽容支持
- 改进了API使用者的异常处理
- 改进了解析sponge-dimension目录时的异常处理
- 改进了故障排除命令
- 修复了解析配置异常时可能发生的死锁
- 修复了从level.dat中读取世界生成点位置不正确的问题
- 修复了MapUpdateService线程、Web服务器和调度器的线程名称
- 修复了当皮肤提供者返回空皮肤时,玩家皮肤未从地图存储中移除的问题
完整更改日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.16
5.16-fabric
on 2026 Feb 13亮点/注意事项
一系列较小的新增功能、改进和修复。
从5.15升级
- 用新的
bluemap.jar文件替换旧的 - 删除您的
<webroot>/index.html以使BlueMap更新Web应用
自5.15以来的更新日志
- Web应用:使用no-cache头替换缓存控制中的数字参数 (#762, 感谢Macil)
- Web应用:在自由飞行指针锁定模式下,如果支持则使用unadjustedMovement (#763, 感谢Macil)
- 增加了对“超大区块”的支持 → 存储在区域文件之外的大区块 (#772)
- 增加了
render-thread-priority配置值,用于设置渲染线程的Java线程优先级 - 增加了RenderPasses,允许插件修改整个瓦片模型,而无需绑定到自定义方块或实体
- 增加了在CLI上监视地图更新时的日志信息
- 增加了对非标准pack.mcmeta格式的宽容支持
- 改进了API使用者的异常处理
- 改进了解析sponge-dimension目录时的异常处理
- 改进了故障排除命令
- 修复了解析配置异常时可能的死锁
- 修复了从level.dat中读取世界出生点位置不正确的问题
- 修复了MapUpdateService线程、Web服务器和调度器的线程名称
- 修复了当皮肤提供者返回空皮肤时,玩家皮肤未从地图存储中移除的问题
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.16
5.15-sponge
on 2025 Dec 11更新亮点 / 备注
修复了与 1.21.11 版本兼容的几个漏洞。
从 5.14 升级
- 将
bluemap.jar文件替换为新版本
自 5.14 版本以来的更新日志
- 更新 fabric-permission-api 至 0.6.1,以支持 MC 1.21.11
- 针对 Paper 实验版本中的一个漏洞添加了临时解决方案,该漏洞在玩家尝试加入时会抛出异常
- 修复了 Fabric、Forge 和 NeoForge 在玩家尝试加入时偶尔抛出异常的问题(#761)
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.15
5.15-spigot
on 2025 Dec 11更新亮点 / 备注
修复了与 1.21.11 版本兼容的几个漏洞。
从 5.14 升级
- 将
bluemap.jar文件替换为新版本
自 5.14 版本以来的更新日志
- 更新 fabric-permission-api 至 0.6.1,以支持 MC 1.21.11
- 针对 Paper(实验版本)中的一个漏洞添加了临时解决方案,该漏洞在玩家尝试加入时会抛出异常
- 修复了 Fabric、Forge 和 NeoForge 在玩家尝试加入时偶尔抛出异常的问题 (#761)
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.15
5.15-paper
on 2025 Dec 11亮点 / 备注
修复了与 1.21.11 兼容相关的几个漏洞。
从 5.14 升级
- 将
bluemap.jar文件替换为新版本
自 5.14 版本以来的更新日志
- 更新 fabric-permission-api 至 0.6.1,以支持 MC 1.21.11
- 针对 Paper 实验性版本中的一个漏洞添加了临时解决方案,该漏洞在玩家尝试加入时会抛出异常
- 修复了 Fabric、Forge 和 NeoForge 在玩家尝试加入时偶尔抛出异常的问题 (#761)
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.15
5.15-neoforge
on 2025 Dec 11亮点 / 注释
修复了对 1.21.11 支持的几个漏洞。
从 5.14 升级
- 将
bluemap.jar文件替换为新的文件
自 5.14 版本以来的更新日志
- 更新 fabric-permission-api 至 0.6.1,以兼容 MC 1.21.11
- 添加了一个针对 Paper 的漏洞(在 Paper 实验版本中)的变通方案,该漏洞在玩家尝试加入时会抛出异常
- 修复了 Fabric、Forge 和 NeoForge 在玩家尝试加入时有时会抛出异常的问题 (#761)
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.15
5.15-forge
on 2025 Dec 11亮点 / 备注
修复了对 1.21.11 支持的几个漏洞。
从 5.14 升级
- 将
bluemap.jar文件替换为新版本
自 5.14 版以来的更新日志
- 更新 fabric-permission-api 至 0.6.1,以支持 MC 1.21.11
- 针对 Paper 实验性版本中的一个漏洞添加了临时解决方案,该漏洞在玩家尝试加入时会抛出异常
- 修复了 Fabric、Forge 和 NeoForge 在玩家尝试加入时有时会抛出异常的问题 (#761)
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.15
5.15-fabric
on 2025 Dec 11亮点 / 备注
修复了与 1.21.11 版本兼容的几个漏洞。
从 5.14 升级
- 将
bluemap.jar文件替换为新版本
自 5.14 版本以来的更新日志
- 更新 fabric-permission-api 至 0.6.1,以支持 MC 1.21.11
- 针对 Paper(实验版本)中的一个漏洞添加了临时解决方案,该漏洞在玩家尝试加入时会抛出异常
- 修复了 Fabric、Forge 和 NeoForge 在玩家尝试加入时偶尔抛出异常的问题 (#761)
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.15
5.14-sponge
on 2025 Dec 10亮点 / 注释
初步支持 1.21.11 版本,并带来更多的改进与修复。
从 5.13 升级
- 将
bluemap.jar文件替换为新版本
自 5.13 版本以来的更新日志
- 更新 fabric、forge 和 neoforge 以支持 1.21.11(cli、spigot、paper 和 sponge 实现无需更改)
- 增加对 25w46a 版本中新增模型旋转的支持
- 配置项
ignore-missing-light-data: true现在也会忽略单个缺失的区块 - SQL 存储在仅读取时(仅限 Web 服务器,不进行渲染)不再需要数据库写入权限
- 从 Web 服务器日志记录器的 IP 地址中移除
/ - 改进了配置模板中的格式以及语法/拼写(#756、#758,感谢 nightowl286 和 TechnicJelle)
- 改进内部缓存管理
- 修复圆形和椭圆渲染遮罩忽略其中心位置设置的问题
- 修复 Web 服务器处理边界情况(无效)HTTP 请求时的异常
- 修复樱桃木告示牌未渲染的问题
- 修复旧版链式方块的向后兼容性问题
- 修复蘑菇装饰方块上有时出现黑色边缘线的问题
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.14
5.14-spigot
on 2025 Dec 10亮点 / 注释
初步支持 1.21.11,并带来更多的改进与修复。
从 5.13 升级
- 将
bluemap.jar文件替换为新版本
自 5.13 版本以来的更新日志
- 更新 Fabric、Forge 和 NeoForge 以支持 1.21.11(CLI、Spigot、Paper 和 Sponge 实现无需更改)
- 添加对 25w46a 引入的新模型旋转的支持
- 配置中设置
ignore-missing-light-data: true现在也会忽略单个缺失的区块 - SQL 存储在仅读取时(仅限 Web 服务器,不进行渲染)不再需要数据库写入权限
- 从 Web 服务器日志记录器的 IP 地址中移除
/ - 改进了配置模板中的格式以及语法/拼写(#756、#758,感谢 nightowl286 和 TechnicJelle)
- 改进了内部缓存管理
- 修复了圆形和椭圆渲染遮罩忽略其中心位置设置的问题
- 修复了 Web 服务器处理边界情况(无效)HTTP 请求时出现的异常
- 修复了樱桃木告示牌无法渲染的问题
- 修复了旧版链条方块的向后兼容性问题
- 修复了蘑菇装饰方块上有时出现黑色边缘线的问题
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.14
5.14-paper
on 2025 Dec 10亮点 / 注释
初步支持 1.21.11 及更多改进与修复。
从 5.13 升级
- 将
bluemap.jar文件替换为新版本
自 5.13 版本以来的更新日志
- 更新 fabric、forge 和 neoforge 以支持 1.21.11(cli、spigot、paper 和 sponge 实现无需更改)
- 添加对 25w46a 引入的新模型旋转的支持
- 配置项
ignore-missing-light-data: true现在也会忽略个别缺失的区块 - SQL 存储在仅读取时(仅限 Web 服务器,不进行渲染)不再需要数据库写入权限
- 从 Web 服务器日志记录器的 IP 地址中移除
/ - 改进了配置模板中的格式及语法/拼写(#756、#758,感谢 nightowl286 和 TechnicJelle)
- 改进了内部缓存管理
- 修复了圆形和椭圆渲染遮罩忽略其中心位置设置的问题
- 修复了 Web 服务器处理边缘情况(无效)HTTP 请求时出现的异常
- 修复了樱桃木告示牌未渲染的问题
- 修复了旧版链条方块的向后兼容性问题
- 修复了蘑菇装饰方块上有时出现黑色边缘线的问题
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.14
5.14-neoforge
on 2025 Dec 10亮点 / 备注
初步支持 1.21.11 版本,并带来更多改进与修复。
从 5.13 升级
- 将
bluemap.jar文件替换为新版本
自 5.13 版本以来的更新日志
- 更新 Fabric、Forge 和 NeoForge 以支持 1.21.11(CLI、Spigot、Paper 和 Sponge 实现无需更改)
- 增加对 25w46a 引入的新模型旋转的支持
- 配置项
ignore-missing-light-data: true现在也会忽略单个缺失的区块 - SQL 存储在仅读取时(仅限 Web 服务器,不进行渲染)不再需要数据库写入权限
- 从 Web 服务器日志记录器的 IP 地址中移除
/ - 改进了配置模板中的格式以及语法/拼写(#756、#758,感谢 nightowl286 和 TechnicJelle)
- 改进内部缓存管理
- 修复圆形和椭圆渲染遮罩忽略其中心位置设置的问题
- 修复 Web 服务器处理边界情况(无效)HTTP 请求时的异常
- 修复樱桃木告示牌无法渲染的问题
- 修复旧版链条方块的向后兼容性问题
- 修复蘑菇装饰方块上有时出现黑色边缘线的问题
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.14
5.14-forge
on 2025 Dec 10亮点 / 备注
初步支持 1.21.11 版本,并带来多项改进与修复。
从 5.13 升级
- 使用新版本替换原有的
bluemap.jar文件
自 5.13 版本以来的更新日志
- 更新 Fabric、Forge 和 NeoForge 以支持 1.21.11 版本(CLI、Spigot、Paper 和 Sponge 实现无需更改即可运行)
- 新增对 25w46a 引入的新模型旋转的支持
- 配置项
ignore-missing-light-data: true现在也会忽略个别缺失的区块 - SQL 存储在仅读取时(仅限 Web 服务器,不进行渲染)不再需要数据库写入权限
- 从 Web 服务器日志记录器的 IP 地址中移除
/ - 改进了配置模板中的格式及语法/拼写(#756、#758,感谢 nightowl286 和 TechnicJelle)
- 改进内部缓存管理
- 修复圆形和椭圆渲染遮罩忽略其中心位置设置的问题
- 修复 Web 服务器处理边界情况(无效)HTTP 请求时出现的异常
- 修复樱桃木告示牌未渲染的问题
- 修复旧版连锁方块的向后兼容性问题
- 修复蘑菇装饰方块上偶尔出现黑色边缘线的问题
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.14



