更新亮点 / 注意事项

• 支持 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 不再于每次启动时强制更新全部地图；而是持久化记录上一次完整更新的时间，
  并依据 core.conf 中配置的 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

亮点与说明

• 支持 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

亮点与说明

• 支持 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

更新亮点 / 注意事项

• 支持 Minecraft 26.2 版本
• 调整了地图更新任务的调度方式：渲染任务现在可在服务器重启或重载后持续存在

从 5.20 版本升级说明

• 将 bluemap.jar 文件替换为新版文件
• 将 plugin.conf 中的 full-update-interval（全量更新间隔）与 update-cooldown（更新冷却时间）配置项迁移至 core.conf

本次更新包含若干内部改动，可能影响部分依赖自定义方块渲染器的 BlueMap 插件。
→ 请务必确认您所使用的插件是否需要同步更新。

自 5.20 版本以来的更新日志

• 更新资源扩展以适配 Minecraft 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.19 升级

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

自 5.19 以来的更新日志

• 修复了一个导致 BlueMap 无法再加载旧格式（26.1 之前）世界的错误
• 修复了一个错误：由于忙等待区域文件夹存在，在某些情况下会导致 cpu 占用过高
• 修复了一个错误：在重新加载 bluemap 时，webserver 不会关闭活动连接
• 改进了调试转储，加入了更多信息

完整更新日志

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

亮点 / 说明

此版本修复了上一版本中的一些漏洞。

从 5.19 升级

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

自 5.19 以来的更新日志

• 修复了一个导致 BlueMap 无法再加载旧格式（26.1 之前）世界的漏洞
• 修复了一个在某些情况下因忙等待区域文件夹存在而导致 CPU 占用过高的漏洞
• 修复了一个在重新加载 BlueMap 时，Web 服务器不会关闭活动连接的漏洞
• 改进了调试转储，加入了更多信息

完整更新日志

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

亮点 / 说明

此版本修复了上一版中的一些错误。

从 5.19 升级

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

自 5.19 以来的更新日志

• 修复了一个导致 BlueMap 无法再加载旧格式（26.1 之前）的世界的错误
• 修复了一个在某些情况下因忙等待区域文件夹存在而导致 cpu 占用过高的错误
• 修复了一个在重新加载 bluemap 时，webserver 不会关闭活动连接的错误
• 改进了调试转储，加入了更多信息

完整更新日志

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

亮点 / 注意事项

此版本修复了上一版本中的一些 bug。

从 5.19 升级

• 将 bluemap.jar 文件替换为新文件

自 5.19 以来的更新日志

• 修复了一个导致 BlueMap 无法再加载旧格式（26.1 之前）的世界的 bug
• 修复了一个 bug，该 bug 会因忙等待区域文件夹存在而在某些情况下导致 CPU 占用过高
• 修复了一个 bug：重新加载 bluemap 时，webserver 不会关闭活动连接
• 改进了 debug-dump，增加了一些信息

完整更新日志

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

亮点 / 说明

此版本修复了上一版中的一些错误。

从 5.19 升级

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

自 5.19 以来的更新日志

• 修复了一个导致 BlueMap 无法再加载旧版（26.1 之前）格式世界的错误
• 修复了一个错误，该错误会在某些情况下因忙等待区域文件夹存在而导致 CPU 占用过高
• 修复了一个在重载 BlueMap 时，Web 服务器不会关闭活动连接的错误
• 改进了调试转储，加入了更多信息

完整更新日志

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

亮点 / 说明

此版本修复了上一版本中的一些错误。

从 5.19 升级

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

自 5.19 以来的更新日志

• 修复了一个导致 BlueMap 无法再加载旧格式（26.1 之前）世界的错误
• 修复了一个错误，该错误会因忙等待 region 文件夹存在而在某些情况下导致 CPU 占用过高
• 修复了一个错误：重新加载 bluemap 时，webserver 不会关闭活动连接
• 改进了 debug-dump，添加了更多信息

完整更新日志

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

亮点 / 注意事项

此版本修复了由最新 Paper 构建版中的一项破坏性更改在 26.1.1 中引发的两个问题。

从 5.18 升级

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

自 5.18 以来的更新日志

• 修复了在最新 paper 构建版上，BlueMap 在默认地图配置中生成错误世界路径的问题
• 修复了在最新 paper 构建版上，BlueMap 不显示玩家标记的问题
• 修复了 spigot 实现中的世界文件夹解析逻辑，以更好地支持最新的 paper 构建版和混合端

完整更新日志

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

亮点 / 注意事项

此版本修复了由最新版 Paper 构建中的一项破坏性更改在 26.1.1 中引发的两个问题。

从 5.18 升级

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

自 5.18 以来的更新日志

• 修复了 BlueMap 在最新版 Paper 构建中，在默认地图配置里生成错误世界路径的问题
• 修复了 BlueMap 在最新版 Paper 构建中不显示玩家标记的问题
• 修复了 spigot 实现中的世界文件夹解析逻辑，以更好地支持最新版 Paper 构建和混合端

完整更新日志

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

亮点 / 说明

此版本修复了由最新 Paper 构建版中的破坏性更改导致的两个问题，这些问题影响了 26.1.1。

从 5.18 升级

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

自 5.18 以来的更新日志

• 修复了在最新的 Paper 构建版中，BlueMap 在默认地图配置里生成错误世界路径的问题
• 修复了在最新的 Paper 构建版中，BlueMap 不显示玩家标记的问题
• 修复了 spigot 实现中的世界文件夹解析逻辑，以更好地支持最新的 Paper 构建版和混合服务端

完整更新日志

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

亮点 / 说明

此版本修复了由最新 Paper 26.1.1 构建版本中的一项破坏性更改导致的两个问题。

从 5.18 升级

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

自 5.18 以来的更新日志

• 修复了 BlueMap 在最新 Paper 构建版本中于默认地图配置里生成错误世界路径的问题
• 修复了 BlueMap 在最新 Paper 构建版本中不显示玩家标记的问题
• 修复了 spigot 实现中的世界文件夹解析逻辑，以更好地支持最新的 Paper 构建版本和混合服务端

完整更新日志

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

亮点 / 说明

此版本修复了由最新 Paper 构建版中的破坏性更改在 26.1.1 中引发的两个问题。

从 5.18 升级

• 用新的 bluemap.jar 文件替换原文件

自 5.18 以来的更新日志

• 修复了 BlueMap 在最新 Paper 构建版中于默认地图配置里生成错误世界路径的问题
• 修复了 BlueMap 在最新 Paper 构建版中不显示玩家标记的问题
• 修复了 Spigot 实现中的世界文件夹解析逻辑，以更好地支持最新的 Paper 构建版和混合核心

完整更新日志

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

亮点 / 说明

此版本修复了由最新版 Paper 构建中一项破坏性更改导致的两个问题，适用于 26.1.1。

从 5.18 升级

• 用新的 bluemap.jar 文件替换原文件

自 5.18 以来的更新日志

• 修复了 BlueMap 在最新版 paper 构建中于默认地图配置里生成错误世界路径的问题
• 修复了 BlueMap 在最新版 paper 构建中不显示玩家标记的问题
• 修复了 spigot 实现中的 worldfolder 解析逻辑，以更好地支持最新版 paper 构建和混合核心

完整更新日志

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

亮点 / 说明

新增了对 Forge 26.1 的实现，并修复了两个小问题。

从 5.17（或 5.16）升级

• 请确保你使用的是 Java 25
• 将 bluemap.jar 文件替换为新的版本

自 5.17 以来的更新日志

• （重新）添加了适用于 Minecraft 26.1 的 Forge 实现
• 修复了旗帜和铜傀儡的纹理
• 修复了 Dockerfile 未使用正确 Java 版本的问题

完整更新日志

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

亮点 / 说明

新增了对 forge 26.1 的实现，并修复了两个小问题。

从 5.17（或 5.16）升级

• 请确保你使用的是 Java 25
• 将 bluemap.jar 文件替换为新的版本

自 5.17 以来的更新日志

• （重新）添加了适用于 minecraft 26.1 的 forge 实现
• 修复了旗帜和铜傀儡的纹理
• 修复了 dockerfile 未使用正确 Java 版本的问题

完整更新日志

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

亮点 / 说明

添加了对 Forge 26.1 的实现，以及两个小修复。

从 5.17（或 5.16）升级

• 请确保你使用的是 Java 25
• 用新的 bluemap.jar 文件替换旧文件

自 5.17 以来的更新日志

• （重新）添加了适用于 Minecraft 26.1 的 Forge 实现
• 修复了旗帜和铜傀儡的纹理
• 修复了 dockerfile 未使用正确 Java 版本的问题

完整更新日志

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

亮点 / 说明

已添加对 Forge 26.1 的实现，并修复了两个小问题。

从 5.17（或 5.16）升级

• 请确保你使用的是 Java 25
• 将 bluemap.jar 文件替换为新的版本

自 5.17 以来的更新日志

• （重新）添加了适用于 Minecraft 26.1 的 Forge 实现
• 修复了旗帜和铜傀儡的纹理
• 修复了 dockerfile 未使用正确 Java 版本的问题

完整更新日志

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