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
5.14-fabric
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.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



