BlueMap

亮点 / 备注

增加了对 Minecraft 26.3 世界的兼容性，并包含一些修复和改进。

从 5.23 升级

• 用新版本替换 bluemap.jar 文件

自 5.23 以来的变更日志

• 添加了对 Minecraft 26.3 世界的支持
• 通过 data/<namespace>/defaultBlockstates.json 解析 26.3+ 世界的默认方块状态
• SSE 连接现在发送定期保活消息，以防止空闲连接超时（感谢 pR0Ps，#829）
• 更新了波兰语翻译（感谢 alliewegner，#832）
• 将 js-yaml 从 4.3.0 升级到 4.3.1（#831）
• 修复了没有更改的区域更新任务未立即释放内存的问题
• 修复了 BlueMap 调度器未作为守护线程运行的问题
• 修复了 BlueMap 卸载时 Web 服务器请求处理程序未正确关闭的问题
• 修复了 storage 命令有时无法正确识别已加载地图的问题
• 修复了任务有时无法正确保存/加载的错误（再次修复）
• 修复了在 BlueMap 完全加载之前更新玩家时出现的错误
• 修复了实体旋转问题（如果有添加实体模型的插件）

完整变更日志

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

亮点 / 备注

增加了对 Minecraft 26.3 世界的兼容性，并包含一些修复和改进。

从 5.23 升级

• 用新版本替换 bluemap.jar 文件

自 5.23 以来的变更日志

• 添加了对 Minecraft 26.3 世界的支持
• 通过 data/<namespace>/defaultBlockstates.json 解析 26.3+ 世界的默认方块状态
• SSE 连接现在会发送定期心跳消息，以防止空闲连接超时（感谢 pR0Ps，#829）
• 更新了波兰语翻译（感谢 alliewegner，#832）
• 将 js-yaml 从 4.3.0 升级到 4.3.1（#831）
• 修复了没有更改的区域更新任务未立即释放内存的问题
• 修复了 BlueMap 调度器未作为守护线程运行的问题
• 修复了 BlueMap 卸载时 Web 服务器请求处理器未正确关闭的问题
• 修复了 storage 命令有时无法正确识别已加载地图的问题
• 修复了任务有时无法正确保存/加载的错误（再次修复）
• 修复了在 BlueMap 完全加载之前更新玩家时出现的错误
• 修复了实体旋转问题（如果有添加实体模型的插件）

完整变更日志

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

亮点 / 备注

增加了对 Minecraft 26.3 世界的兼容性，并包含一些修复和改进。

从 5.23 升级

• 用新版本替换 bluemap.jar 文件

自 5.23 以来的变更日志

• 添加了对 Minecraft 26.3 世界的支持
• 通过 data/<namespace>/defaultBlockstates.json 解析 26.3+ 世界的默认方块状态
• SSE 连接现在会发送定期心跳消息，以防止空闲连接超时（感谢 pR0Ps，#829）
• 更新了波兰语翻译（感谢 alliewegner，#832）
• 将 js-yaml 从 4.3.0 升级到 4.3.1（#831）
• 修复了没有更改的区域更新任务未立即释放内存的问题
• 修复了 BlueMap 调度器未作为守护线程运行的问题
• 修复了 BlueMap 卸载时 Web 服务器请求处理器未正确关闭的问题
• 修复了 storage 命令有时无法正确识别已加载地图的问题
• 修复了任务有时无法正确保存/加载的错误（再次修复）
• 修复了在 BlueMap 完全加载之前更新玩家时出现的错误
• 修复了实体旋转问题（如果有添加实体模型的插件）

完整变更日志

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

亮点 / 备注

集成 Web 服务器现在使用 SSE 将标记和新渲染的图块更新推送到连接的 Web 应用。 此外还有一些修复和较小的改进。

从 5.22 升级

• 用新版本替换 bluemap.jar 文件
• 删除您的 <webroot>/index.html 以便 BlueMap 更新 Web 应用

可选操作：

• 将以下行添加到您的 webserver.conf：

  # 是否使用服务器发送事件 (SSE) 将图块和标记更新推送到连接的客户端。
  # 默认为 true
  sse-enabled: true
  

• 将以下行添加到您的 webapp.conf：

  # 这将配置 Web 应用以请求压缩的地图图块并手动解压它们。
  # 仅当您打算在外部 Web 服务器上静态托管 Web 应用且无需额外配置时启用此项。
  # 默认为 "false"
  #client-decompression: true
  

自 5.22 以来的变更日志

• 使用服务器发送事件推送地图图块、玩家和标记的更新（可选，感谢 @pR0Ps，#819）
• 添加了 Web 应用选项以在客户端解压图块，使得静态托管 Web 应用成为可能（感谢 @fechan，#815）
• 如果不存在区域文件，不再删除整个地图（地图可能配置不正确）
• 加载资源时尝试解析符号链接
• 添加了（通常隐藏的）dimension-type 配置，以修复由 paper-api 添加的世界
• 移除了原生线性区域格式支持，请改用 linear-addon
• 按地图跟踪完整更新间隔，而非全局跟踪
• 修复了保存低分辨率图块时有时会导致其损坏的竞争条件（#821）
• 修复了实时玩家标记配置未被尊重的问题
• 修复了维度键中包含 / 的世界在 Paper 上无法被正确检测的问题
• 修复了任务有时无法正确保存/加载的问题
• 修复了内存中的区域更新时间戳在清理时未重置的问题

完整变更日志

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

亮点 / 备注

集成 Web 服务器现在使用 SSE 将标记和新渲染的图块更新推送到连接的 Web 应用。 此外还有一些修复和较小的改进。

从 5.22 升级

• 用新版本替换 bluemap.jar 文件
• 删除您的 <webroot>/index.html 以便 BlueMap 更新 Web 应用

可选操作：

• 将以下行添加到您的 webserver.conf：

  # 是否使用服务器发送事件 (SSE) 将图块和标记更新推送到连接的客户端。
  # 默认为 true
  sse-enabled: true
  

• 将以下行添加到您的 webapp.conf：

  # 这将配置 Web 应用以请求压缩的地图图块并手动解压它们。
  # 仅当您打算在外部 Web 服务器上静态托管 Web 应用且无需额外配置时启用此项。
  # 默认为 "false"
  #client-decompression: true
  

自 5.22 以来的变更日志

• 使用服务器发送事件推送地图图块、玩家和标记的更新（可选，感谢 @pR0Ps，#819）
• 添加了 Web 应用选项以在客户端解压图块，使得可以静态托管 Web 应用（感谢 @fechan，#815）
• 如果不存在区域文件，不再删除整个地图（地图可能配置不正确）
• 加载资源时尝试解析符号链接
• 添加了（通常隐藏的）dimension-type 配置，以修复由 paper-api 添加的世界
• 移除了原生线性区域格式支持，请改用 linear-addon
• 按地图而非全局跟踪完整更新间隔
• 修复了保存低分辨率图块时有时导致其损坏的竞争条件（#821）
• 修复了实时玩家标记配置未被尊重的问题
• 修复了维度键中包含 / 的世界在 Paper 上无法被正确检测的问题
• 修复了任务有时无法正确保存/加载的问题
• 修复了内存中的区域更新时间戳在清理时未重置的问题

完整变更日志

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

亮点 / 备注

集成 Web 服务器现在使用 SSE 将标记和新渲染的图块更新推送到连接的 Web 应用。 此外还有一些修复和较小的改进。

从 5.22 升级

• 用新版本替换 bluemap.jar 文件
• 删除您的 <webroot>/index.html 以便 BlueMap 更新 Web 应用

可选操作：

• 将以下行添加到您的 webserver.conf：

  # 是否使用服务器发送事件 (SSE) 将图块和标记更新推送到连接的客户端。
  # 默认为 true
  sse-enabled: true
  

• 将以下行添加到您的 webapp.conf：

  # 这将配置 Web 应用以请求压缩的地图图块并手动解压它们。
  # 仅当您打算在外部 Web 服务器上静态托管 Web 应用且无需额外配置时启用此项。
  # 默认为 "false"
  #client-decompression: true
  

自 5.22 以来的变更日志

• 使用服务器发送事件推送地图图块、玩家和标记的更新（可选，感谢 @pR0Ps，#819）
• 添加了 Web 应用选项以在客户端解压图块，使得可以静态托管 Web 应用（感谢 @fechan，#815）
• 如果不存在区域文件，不再删除整个地图（地图可能配置不正确）
• 加载资源时尝试解析符号链接
• 添加了（通常隐藏的）dimension-type 配置，以修复由 paper-api 添加的世界
• 移除了原生线性区域格式支持，请改用 linear-addon
• 按地图而非全局跟踪完整更新间隔
• 修复了保存低分辨率图块时有时导致其损坏的竞争条件（#821）
• 修复了实时玩家标记配置未被尊重的问题
• 修复了维度键中包含 / 的世界在 Paper 上无法被正确检测的问题
• 修复了任务有时无法正确保存/加载的问题
• 修复了内存中的区域更新时间戳在清理时未重置的问题

完整变更日志

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

亮点 / 备注

修复了 5.21 版本中导致地图损坏的 bug：请直接更新到此版本，跳过 5.21 版本！

从 5.20（及 5.21）升级

• 用新文件替换 bluemap.jar 文件
• 将 full-update-interval 和 update-cooldown 设置从您的 plugin.conf 移动到 core.conf

此更新包含一些内部变更，可能会破坏某些使用自定义方块渲染器的 BlueMap 插件。
-> 请务必检查您的插件是否需要更新。

自 5.21 以来的变更日志

• 修复了一个导致旧版本地图纹理损坏的问题

完整变更日志

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

亮点 / 备注

修复了 5.21 版本中导致地图损坏的漏洞：请直接更新到此版本，跳过 5.21 版本！

从 5.20（及 5.21）升级

• 用新文件替换 bluemap.jar 文件
• 将 full-update-interval 和 update-cooldown 设置从您的 plugin.conf 移动到 core.conf

本次更新包含一些内部变更，可能会破坏某些使用自定义方块渲染器的 BlueMap 插件。
-> 请务必检查您的插件是否需要更新。

自 5.21 以来的变更日志

• 修复了一个导致旧版本地图纹理损坏的问题

完整变更日志

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

亮点 / 备注

修复了 5.21 版本中导致地图损坏的漏洞：请直接更新到此版本，跳过 5.21 版本！

从 5.20（及 5.21）升级

• 用新文件替换 bluemap.jar 文件
• 将 full-update-interval 和 update-cooldown 设置从您的 plugin.conf 移动到 core.conf

此更新包含一些内部变更，可能会破坏某些使用自定义方块渲染器的 BlueMap 插件。
-> 请务必检查您的插件是否需要更新。

自 5.21 以来的变更日志

• 修复了一个导致旧版本地图纹理损坏的问题

完整变更日志

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

亮点 / 备注

• 支持 Minecraft 26.2
• 更改了地图更新的调度方式。渲染任务现在可在重启/重载后持久保存

从 5.20 升级

• 用新版本替换 bluemap.jar 文件
• 将 full-update-interval 和 update-cooldown 设置从 plugin.conf 移动到 core.conf

此更新包含一些内部变更，可能会破坏某些使用自定义方块渲染器的 BlueMap 插件。
-> 请确保检查您的插件是否需要更新。

自 5.20 以来的变更日志

• 更新了资源扩展以适配 26.2 版本的床和告示牌变更（-> 支持 26.2）
• BlueMap 现在会跟踪上次更新每个区域文件的时间，并利用此信息对其更新任务进行排序。
  这确保了无论更新过程相对于世界变化的速度有多慢， 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-permission-api 的支持
• 皮肤配置文件请求现在使用无连字符的 UUID 格式（与 Mojang 默认格式保持一致）
• 增强了调试转储功能，包含注册表信息
• 在调试日志中添加了版本信息
• 修复了 Paper 无法正确加载自定义维度信息的问题
• 修复了皮肤下载配置无效的问题
• 修复了尝试加载带有格式化 CustomName 的实体区块时可能出现的错误

完整变更日志

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