5.24-sponge
on 2026 Sep 10重点 / 说明
新增了对 Minecraft 26.3 世界的兼容性,并包含一些修复和改进。
从 5.23 升级
- 用新的
bluemap.jar文件替换旧文件
自 5.23 以来的更新日志
- 新增对 Minecraft 26.3 世界的支持
- 通过
data/<namespace>/defaultBlockstates.json解析 26.3+ 世界的默认方块状态 - SSE 连接现在会定期发送 keepalive 消息,以防止空闲连接超时(感谢 pR0Ps,#829)
- 更新了波兰语翻译(感谢 alliewegner,#832)
- 将 js-yaml 从 4.3.0 升级到 4.3.1(#831)
- 修复了无更改的区块更新任务不会立即释放内存的问题
- 修复了 BlueMap 调度器未作为守护线程运行的问题
- 修复了 BlueMap 卸载时网页服务器请求处理器未正确关闭的问题
- 修复了
storage命令有时无法正确识别已加载地图的问题 - 修复了任务有时无法正确保存/加载的错误(再次修复)
- 修复了在 BlueMap 完全加载之前更新玩家时出现的错误
- 修复了实体旋转的问题(如果有添加实体模型的附加模组)
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.24
5.24-spigot
on 2026 Sep 10亮点 / 说明
新增对 Minecraft 26.3 世界的兼容支持,并包含若干修复和改进。
从 5.23 升级
- 将
bluemap.jar文件替换为新版本
自 5.23 以来的更新日志
- 新增对 Minecraft 26.3 世界的支持
- 通过
data/<namespace>/defaultBlockstates.json解析 26.3+ 世界的默认方块状态 - SSE 连接现在会定期发送 keepalive 消息,以防止空闲连接超时(感谢 pR0Ps,#829)
- 更新了波兰语翻译(感谢 alliewegner,#832)
- 将 js-yaml 从 4.3.0 升级至 4.3.1(#831)
- 修复了无更改的区域更新任务未立即释放内存的问题
- 修复了 BlueMap 调度器未作为守护线程运行的问题
- 修复了 BlueMap 卸载时网页服务器请求处理器未正确关闭的问题
- 修复了
storage命令有时无法正确识别已加载地图的问题 - 修复了任务有时无法正确保存/加载的错误(再次修复)
- 修复了在 BlueMap 完全加载前更新玩家时出现的错误
- 修复了实体旋转问题(如果有添加实体模型的插件)
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.24
5.24-paper
on 2026 Sep 10亮点 / 说明
新增对 Minecraft 26.3 世界的兼容性,并包含一些修复和改进。
从 5.23 升级
- 将
bluemap.jar文件替换为新的版本
自 5.23 以来的更新日志
- 新增对 Minecraft 26.3 世界的支持
- 通过
data/<namespace>/defaultBlockstates.json为 26.3+ 世界解析默认方块状态 - SSE 连接现在会定期发送 keepalive 消息,以防止空闲连接超时(感谢 pR0Ps,#829)
- 更新了波兰语翻译(感谢 alliewegner,#832)
- 将 js-yaml 从 4.3.0 升级到 4.3.1(#831)
- 修复了无更改的区域更新任务未立即释放内存的问题
- 修复了 BlueMap 调度器未作为守护线程运行的问题
- 修复了 BlueMap 卸载时网页服务请求处理器未正确关闭的问题
- 修复了
storage命令有时无法正确识别已加载地图的问题 - 修复了任务有时无法正确保存/加载的错误(再次修复)
- 修复了在 BlueMap 未完全加载时更新玩家出现的错误
- 修复了实体旋转问题(如果有添加实体模型的插件)
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.24
5.24-neoforge
on 2026 Sep 10亮点 / 说明
新增对 Minecraft 26.3 世界的兼容支持,并包含若干修复与改进。
从 5.23 升级
- 用新文件替换
bluemap.jar
自 5.23 以来的更新日志
- 新增对 Minecraft 26.3 世界的支持
- 通过
data/<namespace>/defaultBlockstates.json解析 26.3+ 世界的默认方块状态 - SSE 连接现在会定期发送 keepalive(保活)消息,以防止空闲连接超时(感谢 pR0Ps,#829)
- 更新了波兰语翻译(感谢 alliewegner,#832)
- 将 js-yaml 从 4.3.0 升级到 4.3.1(#831)
- 修复了没有更改的区域文件更新任务未立即释放内存的问题
- 修复了 BlueMap 调度器未作为守护线程运行的问题
- 修复了 BlueMap 卸载时网页服务请求处理器未能正确关闭的问题
- 修复了
storage命令有时无法正确识别已加载地图的问题 - 修复了任务有时无法正确保存/加载的错误(再次)
- 修复了在 BlueMap 完全加载之前更新玩家时出现的错误
- 修复了实体旋转问题(如果有添加实体模型的附加组件)
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.24
5.24-forge
on 2026 Sep 10亮点 / 说明
增加了对 Minecraft 26.3 世界的兼容性,外加若干修复和改进。
从 5.23 升级
- 用新文件替换
bluemap.jar
自 5.23 以来的更新日志
- 增加了对 Minecraft 26.3 世界的支持
- 通过
data/<namespace>/defaultBlockstates.json解析 26.3+ 世界的默认方块状态 - SSE 连接现在会定期发送 keepalive 消息,以防止空闲连接超时(感谢 pR0Ps,#829)
- 更新了波兰语翻译(感谢 alliewegner,#832)
- 将 js-yaml 从 4.3.0 升级到 4.3.1(#831)
- 修复了无更改的区域更新任务未立即释放其内存的问题
- 修复了 BlueMap 调度器未作为守护线程运行的问题
- 修复了 BlueMap 卸载时网页服务器请求处理器未正确关闭的问题
- 修复了
storage命令有时无法正确识别已加载地图的问题 - 修复了任务有时无法正确保存/加载的错误(再次修复)
- 修复了在 BlueMap 未完全加载时更新玩家出现的错误
- 修复了实体旋转问题(如果有添加实体模型的插件)
5.24-fabric
on 2026 Sep 10亮点 / 说明
添加了对 Minecraft 26.3 世界的兼容性,另外还包含一些修复和改进。
从 5.23 升级
- 用新文件替换
bluemap.jar
自 5.23 以来的更新日志
- 添加了对 Minecraft 26.3 世界的支持
- 通过
data/<namespace>/defaultBlockstates.json为 26.3+ 的世界解析默认方块状态 - SSE 连接现在会定期发送 KeepAlive 消息,以防止空闲连接超时(感谢 pR0Ps,#829)
- 更新了波兰语翻译(感谢 alliewegner,#832)
- 将 js-yaml 从 4.3.0 升级到 4.3.1(#831)
- 修复了没有更改的区域更新任务无法立即释放其内存的问题
- 修复了 BlueMap 调度器未作为守护线程运行的问题
- 修复了 BlueMap 卸载时网页服务器请求处理器未能正确关闭的问题
- 修复了
storage命令有时无法正确识别已加载地图的问题 - 修复了任务有时无法正确保存/加载时的错误(再次修复)
- 修复了在 BlueMap 完全加载之前更新玩家时出现的错误
- 修复了实体旋转的问题(当有添加实体模型的附属模组时)
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.24
5.23-sponge
on 2026 Aug 06亮点 / 注意事项
集成的网页服务器现在使用 SSE(服务器推送事件)向已连接的网页应用推送标记和最新渲染的地图瓦片更新。
此外还包含一些其他修复和小幅改进。
从 5.22 升级
- 使用新版本替换
bluemap.jar文件 - 删除您的
<webroot>/index.html,以便 BlueMap 更新网页应用
可选操作:
- 在
webserver.conf中添加以下内容:# 是否使用服务器推送事件(SSE)向已连接的客户端推送地图瓦片和标记更新。 # 默认值为 true sse-enabled: true - 在
webapp.conf中添加以下内容:# 此配置将使网页应用请求压缩格式的地图瓦片,并在客户端手动解压。 # 仅当您打算通过外部网页服务器以静态方式托管网页应用,且未进行额外配置时才启用此项。 # 默认值为 "false" #client-decompression: true
自 5.22 版本以来的变更日志
- 使用服务器推送事件(SSE)推送地图瓦片、玩家和标记的更新(可选,感谢 @pR0Ps,#819)
- 新增网页应用选项,支持在客户端解压瓦片,从而实现静态托管网页应用(感谢 @fechan,#815)
- 当不存在区域文件时,不再删除整个地图(可能是地图配置错误)
- 加载资源时尝试解析符号链接
- 添加了(通常隐藏的)
dimension-type配置项,用于修复 Paper API 添加的世界 - 移除了原生线性区域格式支持,请改用 linear-addon
- 按地图分别跟踪完整更新间隔,而非全局统一
- 修复了保存低分辨率瓦片时因竞态条件偶尔导致损坏的问题(#821)
- 修复了实时玩家标记配置未被正确应用的问题
- 修复了在 Paper 上维度键包含
/的世界无法被正确识别的问题 - 修复了任务有时无法正确保存/加载的问题
- 修复了内存中的区域更新时间戳在清理后未重置的问题
完整变更日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.23
5.23-spigot
on 2026 Aug 06亮点 / 注意事项
集成的网页服务器现在通过 SSE(服务器推送事件)向已连接的网页应用推送标记和最新渲染的地图区块更新。
此外还包含一些其他修复和小幅改进。
从 5.22 升级
- 将
bluemap.jar文件替换为新版本 - 删除您的
<webroot>/index.html文件,以便 BlueMap 更新网页应用
可选操作:
- 在
webserver.conf中添加以下内容:# 是否使用服务器推送事件(SSE)向已连接的客户端推送地图区块和标记更新。 # 默认值为 true sse-enabled: true - 在
webapp.conf中添加以下内容:# 此选项将配置网页应用请求压缩格式的地图区块,并在客户端手动解压。 # 仅当您打算通过外部网页服务器以静态方式托管网页应用且未进行额外配置时才启用此选项。 # 默认值为 "false" #client-decompression: true
自 5.22 版本以来的变更日志
- 使用服务器推送事件(SSE)推送地图区块、玩家和标记的更新(可选,感谢 @pR0Ps,#819)
- 新增网页应用选项,支持在客户端解压地图区块,从而实现静态托管网页应用(感谢 @fechan,#815)
- 当不存在区域文件时,不再删除整个地图(可能是地图配置错误)
- 加载资源时尝试解析符号链接
- 添加了(通常隐藏的)
dimension-type配置项,用于修复 Paper-API 添加的世界 - 移除了原生线性区域格式支持,请改用 linear-addon 插件
- 按地图分别跟踪完整更新间隔,而非全局统一
- 修复了保存低分辨率区块时因竞态条件偶尔导致损坏的问题(#821)
- 修复了实时玩家标记配置未被正确应用的问题
- 修复了 Paper 上维度键包含
/的世界无法被正确识别的问题 - 修复了任务有时无法正确保存/加载的问题
- 修复了内存中的区域更新时间戳在清除后未重置的问题
完整变更日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.23
5.23-paper
on 2026 Aug 06亮点 / 注意事项
集成的网页服务器现在通过 SSE(服务器推送事件)向已连接的网页应用推送标记和最新渲染的地图瓦片更新。
此外还包含一些其他修复和小幅改进。
从 5.22 升级
- 使用新的
bluemap.jar文件替换旧文件 - 删除您的
<webroot>/index.html,以便 BlueMap 更新网页应用
可选操作:
- 在您的
webserver.conf中添加以下内容:# 是否使用服务器推送事件(SSE)向已连接的客户端推送地图瓦片和标记更新。 # 默认值为 true sse-enabled: true - 在您的
webapp.conf中添加以下内容:# 此配置将使网页应用请求压缩格式的地图瓦片,并在客户端手动解压。 # 仅当您打算通过外部网页服务器以静态方式托管网页应用且未进行额外配置时才启用此项。 # 默认值为 "false" #client-decompression: true
自 5.22 版本以来的变更日志
- 使用服务器推送事件(SSE)推送地图瓦片、玩家和标记的更新(可选,感谢 @pR0Ps,#819)
- 新增网页应用选项,支持在客户端解压瓦片,从而实现静态托管网页应用(感谢 @fechan,#815)
- 当不存在区域文件时,不再删除整个地图(可能是地图配置错误)
- 加载资源时尝试解析符号链接
- 添加了(通常隐藏的)
dimension-type配置项,用于修复 Paper API 添加的世界 - 移除了原生线性区域格式支持,请改用 linear-addon 插件
- 按地图单独跟踪完整更新间隔,而非全局统一
- 修复了保存低分辨率瓦片时偶尔因竞争条件导致损坏的问题(#821)
- 修复了实时玩家标记配置未被正确应用的问题
- 修复了在 Paper 上维度键包含
/的世界无法被正确识别的问题 - 修复了任务有时无法正确保存或加载的问题
- 修复了内存中的区域更新时间戳在清理后未重置的问题
完整变更日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.23
5.23-neoforge
on 2026 Aug 06亮点 / 注意事项
集成的网页服务器现在使用 SSE(服务器发送事件)向已连接的网页应用推送标记和最新渲染的地图瓦片更新。
此外还包含一些其他修复和小幅改进。
从 5.22 升级
- 使用新版本替换
bluemap.jar文件 - 删除您的
<webroot>/index.html,以便 BlueMap 更新网页应用
可选操作:
- 在
webserver.conf中添加以下内容:# 是否使用服务器发送事件(SSE)向已连接的客户端推送地图瓦片和标记更新。 # 默认值为 true sse-enabled: true - 在
webapp.conf中添加以下内容:# 此选项将配置网页应用以请求压缩格式的地图瓦片,并在客户端手动解压。 # 仅当您打算通过外部网页服务器静态托管网页应用且未进行额外配置时才启用此项。 # 默认值为 "false" #client-decompression: true
自 5.22 起的更新日志
- 使用服务器发送事件(SSE)推送地图瓦片、玩家和标记的更新(可选,感谢 @pR0Ps,#819)
- 新增网页应用选项,支持在客户端解压瓦片,从而实现静态托管网页应用(感谢 @fechan,#815)
- 若不存在区域文件,则不再删除整个地图(可能是地图配置错误)
- 加载资源时尝试解析符号链接
- 添加了(通常隐藏的)
dimension-type配置项,用于修复 Paper API 添加的世界 - 移除了原生线性区域格式支持,请改用 linear-addon
- 按地图分别跟踪完整更新间隔,而非全局统一
- 修复了保存低分辨率瓦片时因竞态条件偶尔导致损坏的问题(#821)
- 修复了实时玩家标记配置未被正确应用的问题
- 修复了在 Paper 上维度键包含
/的世界无法被正确识别的问题 - 修复了任务有时无法正确保存或加载的问题
- 修复了内存中的区域更新时间戳在清除后未重置的问题
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.23
5.23-forge
on 2026 Aug 06亮点 / 注意事项
集成的网页服务器现在通过 SSE(服务器推送事件)向已连接的网页应用推送标记和最新渲染的地图瓦片更新。
此外还包含一些其他修复和小幅改进。
从 5.22 版本升级
- 使用新的
bluemap.jar文件替换旧文件 - 删除你的
<webroot>/index.html文件,以便 BlueMap 更新网页应用
可选操作:
- 在
webserver.conf中添加以下内容:# 是否使用服务器推送事件(SSE)向已连接的客户端推送地图瓦片和标记更新。 # 默认值为 true sse-enabled: true - 在
webapp.conf中添加以下内容:# 此配置将使网页应用请求压缩格式的地图瓦片,并在客户端手动解压。 # 仅当你打算通过外部网页服务器以静态方式托管网页应用、且未进行额外配置时才启用此项。 # 默认值为 "false" #client-decompression: true
自 5.22 版本以来的变更日志
- 使用服务器推送事件(SSE)推送地图瓦片、玩家和标记的更新(可选,感谢 @pR0Ps,#819)
- 新增网页应用选项,支持在客户端解压瓦片,从而实现静态托管网页应用(感谢 @fechan,#815)
- 当不存在区域文件时,不再删除整个地图(可能是地图配置错误)
- 加载资源时尝试解析符号链接
- 添加了(通常隐藏的)
dimension-type配置项,用于修复 Paper API 添加的世界 - 移除了原生线性区域格式支持,请改用 linear-addon
- 按地图单独跟踪完整更新间隔,而非全局统一
- 修复了保存低分辨率瓦片时因竞争条件偶尔导致损坏的问题(#821)
- 修复了实时玩家标记配置未被正确应用的问题
- 修复了在 Paper 上维度键包含
/的世界无法被正确识别的问题 - 修复了任务有时无法正确保存或加载的问题
- 修复了内存中的区域更新时间戳在清除后未重置的问题
完整变更日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.23
5.23-fabric
on 2026 Aug 06亮点 / 注意事项
集成的网页服务器现在通过 SSE(服务器发送事件)向已连接的网页应用推送标记和最新渲染的地图瓦片更新。
此外还包含一些其他修复和小幅改进。
从 5.22 升级
- 将
bluemap.jar文件替换为新版本 - 删除您的
<webroot>/index.html,以便 BlueMap 更新网页应用
可选操作:
- 在
webserver.conf中添加以下内容:# 是否使用服务器发送事件(SSE)向已连接的客户端推送地图瓦片和标记更新。 # 默认值为 true sse-enabled: true - 在
webapp.conf中添加以下内容:# 此选项将配置网页应用请求压缩格式的地图瓦片,并在客户端手动解压。 # 仅当您打算通过外部网页服务器以静态方式托管网页应用,且未进行额外配置时才启用此选项。 # 默认值为 "false" #client-decompression: true
自 5.22 版本以来的更新日志
- 使用服务器发送事件(SSE)推送地图瓦片、玩家和标记的更新(可选,感谢 @pR0Ps,#819)
- 新增网页应用选项,支持在客户端解压瓦片,从而实现静态托管网页应用(感谢 @fechan,#815)
- 当不存在区域文件时,不再删除整个地图(可能是地图配置错误)
- 加载资源时尝试解析符号链接
- 新增(通常隐藏的)
dimension-type配置项,用于修复 Paper API 添加的世界 - 移除了原生线性区域格式支持,请改用 linear-addon 插件
- 按地图单独跟踪完整更新间隔,而非全局统一
- 修复了保存低分辨率瓦片时因竞态条件偶尔导致损坏的问题(#821)
- 修复了实时玩家标记配置未被正确应用的问题
- 修复了在 Paper 上维度键包含
/的世界无法被正确识别的问题 - 修复了任务有时无法正确保存/加载的问题
- 修复了内存中的区域更新时间戳在清除后未重置的问题
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.23
5.22-sponge
on 2026 Jun 17亮点与说明
修复了 5.21 版本中一个导致地图崩溃的严重 Bug:请直接升级至本版本,跳过 5.21 版本!
从 5.20(及 5.21)版本升级
- 将
bluemap.jar文件替换为新版本文件 - 将
plugin.conf中的full-update-interval和update-cooldown配置项移至core.conf中
本次更新包含若干内部改动,可能会影响部分依赖自定义方块渲染器的 BlueMap 插件。
→ 请务必检查您的插件是否需要同步更新。
自 5.21 版本以来的更新日志
- 修复了旧版本地图纹理在加载时损坏的问题
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.22
5.22-spigot
on 2026 Jun 17更新亮点 / 注意事项
修复了 5.21 版本中一个导致地图崩溃的严重 Bug:请直接升级至本版本,跳过 5.21 版本!
从 5.20(及 5.21)版本升级
- 将
bluemap.jar文件替换为新版本文件 - 将
plugin.conf中的full-update-interval和update-cooldown配置项迁移至core.conf
本次更新包含若干内部改动,可能影响部分依赖自定义方块渲染器的 BlueMap 插件。
→ 请务必检查您的插件是否需要同步更新。
自 5.21 版本以来的更新日志
- 修复了旧版本地图纹理损坏的问题
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.22
5.22-paper
on 2026 Jun 17更新亮点 / 注意事项
修复了 5.21 版本中一个导致地图损坏的严重 Bug:请直接升级至本版本,跳过 5.21 版本!
从 5.20(及 5.21)版本升级
- 将
bluemap.jar文件替换为新版本文件 - 将
plugin.conf中的full-update-interval和update-cooldown配置项迁移至core.conf
本次更新包含若干内部改动,可能影响部分依赖自定义方块渲染器的 BlueMap 插件。
→ 请务必确认您的插件是否需要同步更新。
自 5.21 版本以来的更新日志
- 修复了旧版本地图纹理损坏的问题
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.22
5.22-neoforge
on 2026 Jun 17更新亮点 / 注意事项
修复了 5.21 版本中导致地图损坏的严重 Bug:请直接升级至本版本,跳过 5.21 版本!
从 5.20(及 5.21)版本升级
- 将
bluemap.jar文件替换为新版本文件 - 将
plugin.conf中的full-update-interval和update-cooldown配置项迁移至core.conf
本次更新包含若干内部改动,可能影响部分依赖自定义方块渲染器的 BlueMap 插件。
→ 请务必确认您的插件是否需要同步更新。
自 5.21 版本以来的更新日志
- 修复了旧版本地图纹理损坏的问题
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.22
5.22-forge
on 2026 Jun 17更新亮点 / 注意事项
修复了 5.21 版本中一个会导致地图损坏的严重 Bug:请直接升级至本版本,跳过 5.21 版本!
从 5.20(及 5.21)版本升级
- 将
bluemap.jar文件替换为新版本文件 - 将
plugin.conf中的full-update-interval和update-cooldown配置项迁移至core.conf
本次更新包含若干内部改动,可能影响部分依赖自定义方块渲染器的 BlueMap 插件。
→ 请务必检查您的插件是否需要同步更新。
自 5.21 版本以来的更新日志
- 修复了旧版本地图纹理损坏的问题
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.22
5.22-fabric
on 2026 Jun 17亮点与说明
修复了 5.21 版本中一个导致地图崩溃的严重 Bug:请直接升级至本版本,跳过 5.21 版本!
从 5.20(及 5.21)版本升级
- 将
bluemap.jar文件替换为新版本文件 - 将
plugin.conf中的full-update-interval和update-cooldown配置项移至core.conf中
本次更新包含若干内部改动,可能影响部分依赖自定义方块渲染器的 BlueMap 插件。
→ 请务必确认您的插件是否需要同步更新。
自 5.21 版本以来的更新日志
- 修复了旧版本地图纹理损坏的问题
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.22
5.21-sponge
on 2026 Jun 16亮点与说明
- 支持 Minecraft 26.2 版本
- 调整了地图更新任务的调度机制:渲染任务现在可在服务器重启或重载后持续存在
从 5.20 版本升级指南
- 将
bluemap.jar文件替换为新版文件 - 将
plugin.conf中的full-update-interval(完整更新间隔)与update-cooldown(更新冷却时间)配置项迁移至core.conf
本次更新包含若干内部改动,可能影响部分依赖自定义方块渲染器的 BlueMap 插件扩展。
→ 请务必确认您的插件扩展是否需要同步更新。
自 5.20 版本以来的更新日志
- 更新资源扩展以适配 26.2 版本对床与告示牌的改动(→ 实现对 26.2 的支持)
- BlueMap 现在会记录每个区域文件的最后更新时间,并据此对更新任务进行排序,
确保无论更新速度相较世界变化有多慢,所有区域文件最终均会被完整更新。 - BlueMap 现在会在重启或重载时保存并重新加载渲染任务
- BlueMap 不再于每次启动时强制更新全部地图;而是持久化记录上一次完整更新的时间,
并依据full-update-interval配置项来调度下一轮完整地图更新 - 将
update-cooldown与full-update-interval配置项从plugin.conf迁移至core.conf - 新增命令
/bluemap tasks cancel all,用于一次性取消全部渲染任务 - API 升级至 2.8.0 版本
- 重构方块颜色计算逻辑,新增插件扩展用的颜色注册表,
并支持通过blockColors.json配置自定义颜色映射纹理 - 重新启用 Fabric 权限 API 支持
- 玩家皮肤档案请求现采用无连字符 UUID 格式(与 Mojang 默认格式保持一致)
- 增强调试信息导出功能,新增注册表相关信息
- 在调试日志中添加版本信息
- 修复 Paper 服务端无法正确加载自定义维度信息的问题
- 修复皮肤下载配置项实际未生效的问题
- 修复尝试加载带有格式化 CustomName(自定义名称)的实体区块时可能出现的潜在错误
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.21
5.21-spigot
on 2026 Jun 16亮点与说明
- 支持 Minecraft 26.2 版本
- 调整了地图更新任务的调度方式。渲染任务现可在服务器重启或重载后持续存在
从 5.20 版本升级指南
- 将
bluemap.jar文件替换为新版文件 - 将
plugin.conf中的full-update-interval(完整更新间隔)与update-cooldown(更新冷却)配置项迁移至core.conf
本次更新包含若干内部改动,可能影响部分依赖自定义方块渲染器的 BlueMap 插件扩展。
→ 请务必确认您的插件扩展是否需要同步更新。
自 5.20 版本以来的更新日志
- 更新资源扩展以适配 26.2 版本中床与告示牌的变更(→ 实现对 26.2 的支持)
- BlueMap 现在会记录每个区域文件(region file)的最后更新时间,并据此对更新任务进行排序,
确保无论更新速度相较世界变化有多慢,所有区域文件最终均会被更新完成。 - BlueMap 现在会在重启或重载时保存并重新加载渲染任务
- BlueMap 不再于每次加载时更新全部地图;取而代之的是,它将持久化记录上一次完整更新的时间,
并依据full-update-interval配置项来调度完整地图更新 - 将
update-cooldown与full-update-interval配置项从plugin.conf迁移至core.conf - 新增命令
/bluemap tasks cancel all,用于一次性取消全部渲染任务 - API 更新至 2.8.0 版本
- 重构方块颜色计算逻辑,新增插件扩展可注册的方块颜色映射表,
并支持通过blockColors.json配置自定义颜色贴图纹理 - 重新启用 fabric-permission-api 支持
- 玩家皮肤档案请求现采用无连字符 UUID 格式(与 Mojang 默认格式保持一致)
- 增强调试信息转储功能,加入注册表相关信息
- 在调试日志中添加版本信息
- 修复 Paper 无法正确加载自定义维度信息的问题
- 修复皮肤下载配置项失效的问题
- 修复在尝试加载带有格式化 CustomName 的实体区块时可能出现的错误
完整更新日志
https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.21




