更新亮点 / 备注

修复了与 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

更新亮点 / 备注

修复了与 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

亮点 / 备注

修复了与 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

亮点 / 注释

修复了对 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

亮点 / 备注

修复了对 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

亮点 / 备注

修复了与 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

亮点 / 注释

初步支持 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

亮点 / 注释

初步支持 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

亮点 / 注释

初步支持 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

亮点 / 备注

初步支持 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

亮点 / 备注

初步支持 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

亮点 / 注释

初步支持 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

亮点 / 说明

新增了铜箱子（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

亮点 / 说明

新增了铜箱子（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

亮点 / 说明

新增了铜箱子（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

亮点 / 说明

新增了铜箱子（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

亮点 / 说明

新增了铜箱子（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

亮点 / 说明

新增了铜箱子（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

亮点 / 注意事项

由于需求极高，此为 BlueMap 5.12 针对 Forge 1.20 - 1.20.4（包括 1.20.1）的一次性回退移植版本。

此版本需要 Java 21 才能运行！
Forge 和大多数模组应可在 Java 21 上正常运行，替代 Java 17。如果你无法使用 Java 21，则需改用 BlueMap 5.3。

从 5.3 版本升级

此前支持 Forge 1.20.x 的 BlueMap 版本是 5.3，因此你很可能正从该版本升级。

此次更新包含大量变更和新的配置项等，因此强烈建议你对 BlueMap 进行一次完整的干净安装：

• 停止服务器
• 备份数据
• 删除当前的 ./mods/bluemap-x-yz.jar
• 删除 ./config/bluemap 文件夹
• 删除 ./bluemap 目录
• 将新的 bluemap-5.12-mc1.20-6-forge.jar 放入 ./mods 文件夹
• 启动服务器
• 使用新生成的配置文件重新配置 BlueMap
  你可以保留备份中的旧配置文件，以便参考迁移设置
• 执行命令 /bluemap reload

如果你不想进行干净安装，并希望保留当前已渲染的地图，请按照以下更新日志中的升级步骤操作：

• https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.5
• https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.11

更新日志

请参阅以下链接查看完整更新日志： https://github.com/BlueMap-Minecraft/BlueMap/releases

亮点 / 说明

完整支持 1.21.9，重构集成 Web 服务器，并带来更多错误修复和改进！

从 5.11 升级

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

自 5.11 版本以来的更新日志

• 更新 Fabric 实现至 1.21.9
• 重构集成 Web 服务器，从 NIO 迁移至虚拟线程（Virtual-Threads），提升性能与可维护性
• 为资源包版本 67 添加 chain → iron_chain 的重映射，以增强向后兼容性
• 在方块颜色配置中添加对方块属性的支持
• 添加对插件依赖项和软依赖项的支持 (#730)
• BlueMapAPI 升级至 2.7.6
• 改进区域/区块加载错误的日志输出
• 修复 Paper 在非正式版本（快照版、预发布版、候选发布版）中读取错误的 Minecraft 版本 ID 的问题
• 修复元素默认 UV 计算，修正了炼药锅和仙人掌花盆的显示问题
• 修复西瓜和南瓜藤蔓着色不正确的问题 (#734)
• 修复内翻立方体不生效的问题，修正所有刷怪笼方块的外观
• 修复 /bluemap debug map ... 命令中显示错误瓦片坐标的问题
• 修复环境光遮蔽（ambient-occlusion）属性未能从父级方块模型继承的问题（感谢 Uiniel，#729）
• 修复 Web 服务器对 HTTP "path" 绝对路径格式处理不当的问题 (#737)
• 修复旧版配置错误未显示具体问题配置文件的问题

完整更新日志

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