BlueMap

Highlights / Notes

Fix for a map-breaking bug in 5.21: update directly to this version, skip version 5.21!

Upgrading from 5.20 (and 5.21)

• Replace the bluemap.jar-file with the new one
• Move the full-update-interval and the update-cooldown settings from your plugin.conf into your core.conf

This update contains some internal changes which might break some BlueMap-Addons that work with custom block-renderers.
-> Make sure to check if your addons need to be updated.

Changelog since 5.21

• Fixed an issue causing the textures of maps from previous versions to be corrupted

Full Changelog

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

Highlights / Notes

Fix for a map-breaking bug in 5.21: update directly to this version, skip version 5.21!

Upgrading from 5.20 (and 5.21)

• Replace the bluemap.jar-file with the new one
• Move the full-update-interval and the update-cooldown settings from your plugin.conf into your core.conf

This update contains some internal changes which might break some BlueMap-Addons that work with custom block-renderers.
-> Make sure to check if your addons need to be updated.

Changelog since 5.21

• Fixed an issue causing the textures of maps from previous versions to be corrupted

Full Changelog

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

Highlights / Notes

Fix for a map-breaking bug in 5.21: update directly to this version, skip version 5.21!

Upgrading from 5.20 (and 5.21)

• Replace the bluemap.jar-file with the new one
• Move the full-update-interval and the update-cooldown settings from your plugin.conf into your core.conf

This update contains some internal changes which might break some BlueMap-Addons that work with custom block-renderers.
-> Make sure to check if your addons need to be updated.

Changelog since 5.21

• Fixed an issue causing the textures of maps from previous versions to be corrupted

Full Changelog

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

Highlights / Notes

Fix for a map-breaking bug in 5.21: update directly to this version, skip version 5.21!

Upgrading from 5.20 (and 5.21)

• Replace the bluemap.jar-file with the new one
• Move the full-update-interval and the update-cooldown settings from your plugin.conf into your core.conf

This update contains some internal changes which might break some BlueMap-Addons that work with custom block-renderers.
-> Make sure to check if your addons need to be updated.

Changelog since 5.21

• Fixed an issue causing the textures of maps from previous versions to be corrupted

Full Changelog

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

Highlights / Notes

Fix for a map-breaking bug in 5.21: update directly to this version, skip version 5.21!

Upgrading from 5.20 (and 5.21)

• Replace the bluemap.jar-file with the new one
• Move the full-update-interval and the update-cooldown settings from your plugin.conf into your core.conf

This update contains some internal changes which might break some BlueMap-Addons that work with custom block-renderers.
-> Make sure to check if your addons need to be updated.

Changelog since 5.21

• Fixed an issue causing the textures of maps from previous versions to be corrupted

Full Changelog

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

Highlights / Notes

Fix for a map-breaking bug in 5.21: update directly to this version, skip version 5.21!

Upgrading from 5.20 (and 5.21)

• Replace the bluemap.jar-file with the new one
• Move the full-update-interval and the update-cooldown settings from your plugin.conf into your core.conf

This update contains some internal changes which might break some BlueMap-Addons that work with custom block-renderers.
-> Make sure to check if your addons need to be updated.

Changelog since 5.21

• Fixed an issue causing the textures of maps from previous versions to be corrupted

Full Changelog

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

Highlights / Notes

• Minecraft 26.2 support
• Changes to how map-updates are scheduled. Render-Tasks now persist over restarts/reloads

Upgrading from 5.20

• Replace the bluemap.jar-file with the new one
• Move the full-update-interval and the update-cooldown settings from your plugin.conf into your core.conf

This update contains some internal changes which might break some BlueMap-Addons that work with custom block-renderers.
-> Make sure to check if your addons need to be updated.

Changelog since 5.20

• Updated resource-extensions to account for 26.2 bed and sign changes (-> 26.2 support)
• BlueMap now keeps track of when it last updated which region-file and uses this information to sort it's update-tasks.
  This makes sure that no matter how slow the update-process is in comparison to the world-changes,
  BlueMap will always have eventually updated each region-file.
• BlueMap now saves render-tasks and loads them when it restarts or reloads
• BlueMap no longer updates all maps each time it loads. Instead, it persists the last full-update time
  and schedules full map-updates based on the full-update-interval config
• Moved update-cooldown and full-update-interval configs from plugin.conf to core.conf
• Added /bluemap tasks cancel all command to cancel all render-tasks at once
• Updated API to 2.8.0
• Reworked block-color calculation, added a registry for addons and
  the ability to configure custom color-map textures in the blockColors.json
• Re-enabled support for fabric-pemission-api
• Skin-Profile requests now use the un-dashed UUID format (aligning with mojang-default)
• Enhanced debug-dump with registry-information
• Added version information to the debug-log
• Fixed an issue with paper not loading custom dimension information correctly
• Fixed skin-download config doing nothing
• Fixed potential error when trying to load an entity-chunk with a formatted CustomName

Full Changelog

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

Highlights / Notes

• Minecraft 26.2 support
• Changes to how map-updates are scheduled. Render-Tasks now persist over restarts/reloads

Upgrading from 5.20

• Replace the bluemap.jar-file with the new one
• Move the full-update-interval and the update-cooldown settings from your plugin.conf into your core.conf

This update contains some internal changes which might break some BlueMap-Addons that work with custom block-renderers.
-> Make sure to check if your addons need to be updated.

Changelog since 5.20

• Updated resource-extensions to account for 26.2 bed and sign changes (-> 26.2 support)
• BlueMap now keeps track of when it last updated which region-file and uses this information to sort it's update-tasks.
  This makes sure that no matter how slow the update-process is in comparison to the world-changes,
  BlueMap will always have eventually updated each region-file.
• BlueMap now saves render-tasks and loads them when it restarts or reloads
• BlueMap no longer updates all maps each time it loads. Instead, it persists the last full-update time
  and schedules full map-updates based on the full-update-interval config
• Moved update-cooldown and full-update-interval configs from plugin.conf to core.conf
• Added /bluemap tasks cancel all command to cancel all render-tasks at once
• Updated API to 2.8.0
• Reworked block-color calculation, added a registry for addons and
  the ability to configure custom color-map textures in the blockColors.json
• Re-enabled support for fabric-pemission-api
• Skin-Profile requests now use the un-dashed UUID format (aligning with mojang-default)
• Enhanced debug-dump with registry-information
• Added version information to the debug-log
• Fixed an issue with paper not loading custom dimension information correctly
• Fixed skin-download config doing nothing
• Fixed potential error when trying to load an entity-chunk with a formatted CustomName

Full Changelog

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

Highlights / Notes

• Minecraft 26.2 support
• Changes to how map-updates are scheduled. Render-Tasks now persist over restarts/reloads

Upgrading from 5.20

• Replace the bluemap.jar-file with the new one
• Move the full-update-interval and the update-cooldown settings from your plugin.conf into your core.conf

This update contains some internal changes which might break some BlueMap-Addons that work with custom block-renderers.
-> Make sure to check if your addons need to be updated.

Changelog since 5.20

• Updated resource-extensions to account for 26.2 bed and sign changes (-> 26.2 support)
• BlueMap now keeps track of when it last updated which region-file and uses this information to sort it's update-tasks.
  This makes sure that no matter how slow the update-process is in comparison to the world-changes,
  BlueMap will always have eventually updated each region-file.
• BlueMap now saves render-tasks and loads them when it restarts or reloads
• BlueMap no longer updates all maps each time it loads. Instead, it persists the last full-update time
  and schedules full map-updates based on the full-update-interval config
• Moved update-cooldown and full-update-interval configs from plugin.conf to core.conf
• Added /bluemap tasks cancel all command to cancel all render-tasks at once
• Updated API to 2.8.0
• Reworked block-color calculation, added a registry for addons and
  the ability to configure custom color-map textures in the blockColors.json
• Re-enabled support for fabric-pemission-api
• Skin-Profile requests now use the un-dashed UUID format (aligning with mojang-default)
• Enhanced debug-dump with registry-information
• Added version information to the debug-log
• Fixed an issue with paper not loading custom dimension information correctly
• Fixed skin-download config doing nothing
• Fixed potential error when trying to load an entity-chunk with a formatted CustomName

Full Changelog

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

Highlights / Notes

• Minecraft 26.2 support
• Changes to how map-updates are scheduled. Render-Tasks now persist over restarts/reloads

Upgrading from 5.20

• Replace the bluemap.jar-file with the new one
• Move the full-update-interval and the update-cooldown settings from your plugin.conf into your core.conf

This update contains some internal changes which might break some BlueMap-Addons that work with custom block-renderers.
-> Make sure to check if your addons need to be updated.

Changelog since 5.20

• Updated resource-extensions to account for 26.2 bed and sign changes (-> 26.2 support)
• BlueMap now keeps track of when it last updated which region-file and uses this information to sort it's update-tasks.
  This makes sure that no matter how slow the update-process is in comparison to the world-changes,
  BlueMap will always have eventually updated each region-file.
• BlueMap now saves render-tasks and loads them when it restarts or reloads
• BlueMap no longer updates all maps each time it loads. Instead, it persists the last full-update time
  and schedules full map-updates based on the full-update-interval config
• Moved update-cooldown and full-update-interval configs from plugin.conf to core.conf
• Added /bluemap tasks cancel all command to cancel all render-tasks at once
• Updated API to 2.8.0
• Reworked block-color calculation, added a registry for addons and
  the ability to configure custom color-map textures in the blockColors.json
• Re-enabled support for fabric-pemission-api
• Skin-Profile requests now use the un-dashed UUID format (aligning with mojang-default)
• Enhanced debug-dump with registry-information
• Added version information to the debug-log
• Fixed an issue with paper not loading custom dimension information correctly
• Fixed skin-download config doing nothing
• Fixed potential error when trying to load an entity-chunk with a formatted CustomName

Full Changelog

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

Highlights / Notes

• Minecraft 26.2 support
• Changes to how map-updates are scheduled. Render-Tasks now persist over restarts/reloads

Upgrading from 5.20

• Replace the bluemap.jar-file with the new one
• Move the full-update-interval and the update-cooldown settings from your plugin.conf into your core.conf

This update contains some internal changes which might break some BlueMap-Addons that work with custom block-renderers.
-> Make sure to check if your addons need to be updated.

Changelog since 5.20

• Updated resource-extensions to account for 26.2 bed and sign changes (-> 26.2 support)
• BlueMap now keeps track of when it last updated which region-file and uses this information to sort it's update-tasks.
  This makes sure that no matter how slow the update-process is in comparison to the world-changes,
  BlueMap will always have eventually updated each region-file.
• BlueMap now saves render-tasks and loads them when it restarts or reloads
• BlueMap no longer updates all maps each time it loads. Instead, it persists the last full-update time
  and schedules full map-updates based on the full-update-interval config
• Moved update-cooldown and full-update-interval configs from plugin.conf to core.conf
• Added /bluemap tasks cancel all command to cancel all render-tasks at once
• Updated API to 2.8.0
• Reworked block-color calculation, added a registry for addons and
  the ability to configure custom color-map textures in the blockColors.json
• Re-enabled support for fabric-pemission-api
• Skin-Profile requests now use the un-dashed UUID format (aligning with mojang-default)
• Enhanced debug-dump with registry-information
• Added version information to the debug-log
• Fixed an issue with paper not loading custom dimension information correctly
• Fixed skin-download config doing nothing
• Fixed potential error when trying to load an entity-chunk with a formatted CustomName

Full Changelog

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

Highlights / Notes

• Minecraft 26.2 support
• Changes to how map-updates are scheduled. Render-Tasks now persist over restarts/reloads

Upgrading from 5.20

• Replace the bluemap.jar-file with the new one
• Move the full-update-interval and the update-cooldown settings from your plugin.conf into your core.conf

This update contains some internal changes which might break some BlueMap-Addons that work with custom block-renderers.
-> Make sure to check if your addons need to be updated.

Changelog since 5.20

• Updated resource-extensions to account for 26.2 bed and sign changes (-> 26.2 support)
• BlueMap now keeps track of when it last updated which region-file and uses this information to sort it's update-tasks.
  This makes sure that no matter how slow the update-process is in comparison to the world-changes,
  BlueMap will always have eventually updated each region-file.
• BlueMap now saves render-tasks and loads them when it restarts or reloads
• BlueMap no longer updates all maps each time it loads. Instead, it persists the last full-update time
  and schedules full map-updates based on the full-update-interval config
• Moved update-cooldown and full-update-interval configs from plugin.conf to core.conf
• Added /bluemap tasks cancel all command to cancel all render-tasks at once
• Updated API to 2.8.0
• Reworked block-color calculation, added a registry for addons and
  the ability to configure custom color-map textures in the blockColors.json
• Re-enabled support for fabric-pemission-api
• Skin-Profile requests now use the un-dashed UUID format (aligning with mojang-default)
• Enhanced debug-dump with registry-information
• Added version information to the debug-log
• Fixed an issue with paper not loading custom dimension information correctly
• Fixed skin-download config doing nothing
• Fixed potential error when trying to load an entity-chunk with a formatted CustomName

Full Changelog

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

Highlights / Notes

This version fixes some bugs with the previous release.

Upgrading from 5.19

• Replace the bluemap.jar-file with the new one

Changelog since 5.19

• Fixed a bug that caused BlueMap to no longer be able to load worlds with the old (pre 26.1) format
• Fixed a bug causing some cases of high cpu-usage due to busy-waiting for region-folders to exist
• Fixed a bug where the webserver is not closing active connections when reloading bluemap
• Improved debug-dump with some more information

Full Changelog

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

Highlights / Notes

This version fixes some bugs with the previous release.

Upgrading from 5.19

• Replace the bluemap.jar-file with the new one

Changelog since 5.19

• Fixed a bug that caused BlueMap to no longer be able to load worlds with the old (pre 26.1) format
• Fixed a bug causing some cases of high cpu-usage due to busy-waiting for region-folders to exist
• Fixed a bug where the webserver is not closing active connections when reloading bluemap
• Improved debug-dump with some more information

Full Changelog

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

Highlights / Notes

This version fixes some bugs with the previous release.

Upgrading from 5.19

• Replace the bluemap.jar-file with the new one

Changelog since 5.19

• Fixed a bug that caused BlueMap to no longer be able to load worlds with the old (pre 26.1) format
• Fixed a bug causing some cases of high cpu-usage due to busy-waiting for region-folders to exist
• Fixed a bug where the webserver is not closing active connections when reloading bluemap
• Improved debug-dump with some more information

Full Changelog

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

Highlights / Notes

This version fixes some bugs with the previous release.

Upgrading from 5.19

• Replace the bluemap.jar-file with the new one

Changelog since 5.19

• Fixed a bug that caused BlueMap to no longer be able to load worlds with the old (pre 26.1) format
• Fixed a bug causing some cases of high cpu-usage due to busy-waiting for region-folders to exist
• Fixed a bug where the webserver is not closing active connections when reloading bluemap
• Improved debug-dump with some more information

Full Changelog

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

Highlights / Notes

This version fixes some bugs with the previous release.

Upgrading from 5.19

• Replace the bluemap.jar-file with the new one

Changelog since 5.19

• Fixed a bug that caused BlueMap to no longer be able to load worlds with the old (pre 26.1) format
• Fixed a bug causing some cases of high cpu-usage due to busy-waiting for region-folders to exist
• Fixed a bug where the webserver is not closing active connections when reloading bluemap
• Improved debug-dump with some more information

Full Changelog

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

Highlights / Notes

This version fixes some bugs with the previous release.

Upgrading from 5.19

• Replace the bluemap.jar-file with the new one

Changelog since 5.19

• Fixed a bug that caused BlueMap to no longer be able to load worlds with the old (pre 26.1) format
• Fixed a bug causing some cases of high cpu-usage due to busy-waiting for region-folders to exist
• Fixed a bug where the webserver is not closing active connections when reloading bluemap
• Improved debug-dump with some more information

Full Changelog

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

Highlights / Notes

This version fixes two issues caused by a breaking change in the newest Paper builds for 26.1.1.

Upgrading from 5.18

• Replace the bluemap.jar-file with the new one

Changelog since 5.18

• Fixed BlueMap generating the wrong world-paths in the default map-configs on the latest paper builds
• Fixed BlueMap not displaying player-markers on the latest paper builds
• Fixed worldfolder resolve logic in the spigot implementation to better support the newest paper builds and hybrids

Full Changelog

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

Highlights / Notes

This version fixes two issues caused by a breaking change in the newest Paper builds for 26.1.1.

Upgrading from 5.18

• Replace the bluemap.jar-file with the new one

Changelog since 5.18

• Fixed BlueMap generating the wrong world-paths in the default map-configs on the latest paper builds
• Fixed BlueMap not displaying player-markers on the latest paper builds
• Fixed worldfolder resolve logic in the spigot implementation to better support the newest paper builds and hybrids

Full Changelog

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

Highlights / Notes

This version fixes two issues caused by a breaking change in the newest Paper builds for 26.1.1.

Upgrading from 5.18

• Replace the bluemap.jar-file with the new one

Changelog since 5.18

• Fixed BlueMap generating the wrong world-paths in the default map-configs on the latest paper builds
• Fixed BlueMap not displaying player-markers on the latest paper builds
• Fixed worldfolder resolve logic in the spigot implementation to better support the newest paper builds and hybrids

Full Changelog

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

Highlights / Notes

This version fixes two issues caused by a breaking change in the newest Paper builds for 26.1.1.

Upgrading from 5.18

• Replace the bluemap.jar-file with the new one

Changelog since 5.18

• Fixed BlueMap generating the wrong world-paths in the default map-configs on the latest paper builds
• Fixed BlueMap not displaying player-markers on the latest paper builds
• Fixed worldfolder resolve logic in the spigot implementation to better support the newest paper builds and hybrids

Full Changelog

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

Highlights / Notes

This version fixes two issues caused by a breaking change in the newest Paper builds for 26.1.1.

Upgrading from 5.18

• Replace the bluemap.jar-file with the new one

Changelog since 5.18

• Fixed BlueMap generating the wrong world-paths in the default map-configs on the latest paper builds
• Fixed BlueMap not displaying player-markers on the latest paper builds
• Fixed worldfolder resolve logic in the spigot implementation to better support the newest paper builds and hybrids

Full Changelog

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

Highlights / Notes

This version fixes two issues caused by a breaking change in the newest Paper builds for 26.1.1.

Upgrading from 5.18

• Replace the bluemap.jar-file with the new one

Changelog since 5.18

• Fixed BlueMap generating the wrong world-paths in the default map-configs on the latest paper builds
• Fixed BlueMap not displaying player-markers on the latest paper builds
• Fixed worldfolder resolve logic in the spigot implementation to better support the newest paper builds and hybrids

Full Changelog

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

Highlights / Notes

Added implementation for forge 26.1 and two small fixes.

Upgrading from 5.17 (or 5.16)

• Make sure you are using Java 25
• Replace the bluemap.jar-file with the new one

Changelog since 5.17

• (Re)Added forge implementation for minecraft 26.1
• Fixed textures of banners and copper-golems
• Fixed dockerfile not using the correct java version

Full Changelog

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

Highlights / Notes

Added implementation for forge 26.1 and two small fixes.

Upgrading from 5.17 (or 5.16)

• Make sure you are using Java 25
• Replace the bluemap.jar-file with the new one

Changelog since 5.17

• (Re)Added forge implementation for minecraft 26.1
• Fixed textures of banners and copper-golems
• Fixed dockerfile not using the correct java version

Full Changelog

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

Highlights / Notes

Added implementation for forge 26.1 and two small fixes.

Upgrading from 5.17 (or 5.16)

• Make sure you are using Java 25
• Replace the bluemap.jar-file with the new one

Changelog since 5.17

• (Re)Added forge implementation for minecraft 26.1
• Fixed textures of banners and copper-golems
• Fixed dockerfile not using the correct java version

Full Changelog

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

Highlights / Notes

Added implementation for forge 26.1 and two small fixes.

Upgrading from 5.17 (or 5.16)

• Make sure you are using Java 25
• Replace the bluemap.jar-file with the new one

Changelog since 5.17

• (Re)Added forge implementation for minecraft 26.1
• Fixed textures of banners and copper-golems
• Fixed dockerfile not using the correct java version

Full Changelog

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

Highlights / Notes

Added implementation for forge 26.1 and two small fixes.

Upgrading from 5.17 (or 5.16)

• Make sure you are using Java 25
• Replace the bluemap.jar-file with the new one

Changelog since 5.17

• (Re)Added forge implementation for minecraft 26.1
• Fixed textures of banners and copper-golems
• Fixed dockerfile not using the correct java version

Full Changelog

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

Highlights / Notes

Added implementation for forge 26.1 and two small fixes.

Upgrading from 5.17 (or 5.16)

• Make sure you are using Java 25
• Replace the bluemap.jar-file with the new one

Changelog since 5.17

• (Re)Added forge implementation for minecraft 26.1
• Fixed textures of banners and copper-golems
• Fixed dockerfile not using the correct java version

Full Changelog

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

Highlights / Notes

Java 25 now required & Minecraft 26.1 support added.

Upgrading from 5.16

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp

Changelog since 5.16

• Switched to Java 25
• Added support for Minecraft 26.1 world format changes
• Switched to virtual-threads based webserver implementation
• Stopped using temporary cache-files for image-writing
• Fixed chunks not rendering if their timestamp is 0
• Fixed a rare race-condition which could cause a server-crash
• Fixed large textures with CUSTOM format freezing bluemaps loading

Full Changelog

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

Highlights / Notes

Java 25 now required & Minecraft 26.1 support added.

Upgrading from 5.16

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp

Changelog since 5.16

• Switched to Java 25
• Added support for Minecraft 26.1 world format changes
• Switched to virtual-threads based webserver implementation
• Stopped using temporary cache-files for image-writing
• Fixed chunks not rendering if their timestamp is 0
• Fixed a rare race-condition which could cause a server-crash
• Fixed large textures with CUSTOM format freezing bluemaps loading

Full Changelog

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

Highlights / Notes

Java 25 now required & Minecraft 26.1 support added.

Upgrading from 5.16

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp

Changelog since 5.16

• Switched to Java 25
• Added support for Minecraft 26.1 world format changes
• Switched to virtual-threads based webserver implementation
• Stopped using temporary cache-files for image-writing
• Fixed chunks not rendering if their timestamp is 0
• Fixed a rare race-condition which could cause a server-crash
• Fixed large textures with CUSTOM format freezing bluemaps loading

Full Changelog

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

Highlights / Notes

Java 25 now required & Minecraft 26.1 support added.

Upgrading from 5.16

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp

Changelog since 5.16

• Switched to Java 25
• Added support for Minecraft 26.1 world format changes
• Switched to virtual-threads based webserver implementation
• Stopped using temporary cache-files for image-writing
• Fixed chunks not rendering if their timestamp is 0
• Fixed a rare race-condition which could cause a server-crash
• Fixed large textures with CUSTOM format freezing bluemaps loading

Full Changelog

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

Highlights / Notes

Java 25 now required & Minecraft 26.1 support added.

Upgrading from 5.16

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp

Changelog since 5.16

• Switched to Java 25
• Added support for Minecraft 26.1 world format changes
• Switched to virtual-threads based webserver implementation
• Stopped using temporary cache-files for image-writing
• Fixed chunks not rendering if their timestamp is 0
• Fixed a rare race-condition which could cause a server-crash
• Fixed large textures with CUSTOM format freezing bluemaps loading

Full Changelog

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

Highlights / Notes

A collection of smaller additions, improvements and fixes.

Upgrading from 5.15

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp

Changelog since 5.15

• WebApp: Replaced using number parameter for cache-control with no-cache header (#762, thanks to Macil)
• WebApp: Use unadjustedMovement if supported in free-flight pointer-lock mode (#763, thanks to Macil)
• Added support for "oversized chunks" → large chunks that are stored separately from the region-files (#772)
• Added render-thread-priority config value for setting the java thread priority for render-threads
• Added RenderPasses which allow addons to modify the entire tile-model without being bound to a custom block or entity
• Added logs for more info when watching for map-updates on the CLI
• Added lenient support for non-standard pack.mcmeta format
• Improved exception-handling of API-consumers
• Improved exception-handling when resolving sponge-dimension directories
• Improved troubleshoot command
• Fixed potential deadlock when resolving a configuration-exception
• Fixed world spawn position not correctly read from the level.dat
• Fixed Thread-Names of MapUpdateService-Thread, Webserver and Scheduler
• Fixed player-skin not being removed from the map-storage if the skin-provider returns an empty skin

Full Changelog

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

Highlights / Notes

A collection of smaller additions, improvements and fixes.

Upgrading from 5.15

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp

Changelog since 5.15

• WebApp: Replaced using number parameter for cache-control with no-cache header (#762, thanks to Macil)
• WebApp: Use unadjustedMovement if supported in free-flight pointer-lock mode (#763, thanks to Macil)
• Added support for "oversized chunks" → large chunks that are stored separately from the region-files (#772)
• Added render-thread-priority config value for setting the java thread priority for render-threads
• Added RenderPasses which allow addons to modify the entire tile-model without being bound to a custom block or entity
• Added logs for more info when watching for map-updates on the CLI
• Added lenient support for non-standard pack.mcmeta format
• Improved exception-handling of API-consumers
• Improved exception-handling when resolving sponge-dimension directories
• Improved troubleshoot command
• Fixed potential deadlock when resolving a configuration-exception
• Fixed world spawn position not correctly read from the level.dat
• Fixed Thread-Names of MapUpdateService-Thread, Webserver and Scheduler
• Fixed player-skin not being removed from the map-storage if the skin-provider returns an empty skin

Full Changelog

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

Highlights / Notes

A collection of smaller additions, improvements and fixes.

Upgrading from 5.15

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp

Changelog since 5.15

• WebApp: Replaced using number parameter for cache-control with no-cache header (#762, thanks to Macil)
• WebApp: Use unadjustedMovement if supported in free-flight pointer-lock mode (#763, thanks to Macil)
• Added support for "oversized chunks" → large chunks that are stored separately from the region-files (#772)
• Added render-thread-priority config value for setting the java thread priority for render-threads
• Added RenderPasses which allow addons to modify the entire tile-model without being bound to a custom block or entity
• Added logs for more info when watching for map-updates on the CLI
• Added lenient support for non-standard pack.mcmeta format
• Improved exception-handling of API-consumers
• Improved exception-handling when resolving sponge-dimension directories
• Improved troubleshoot command
• Fixed potential deadlock when resolving a configuration-exception
• Fixed world spawn position not correctly read from the level.dat
• Fixed Thread-Names of MapUpdateService-Thread, Webserver and Scheduler
• Fixed player-skin not being removed from the map-storage if the skin-provider returns an empty skin

Full Changelog

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

Highlights / Notes

A collection of smaller additions, improvements and fixes.

Upgrading from 5.15

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp

Changelog since 5.15

• WebApp: Replaced using number parameter for cache-control with no-cache header (#762, thanks to Macil)
• WebApp: Use unadjustedMovement if supported in free-flight pointer-lock mode (#763, thanks to Macil)
• Added support for "oversized chunks" → large chunks that are stored separately from the region-files (#772)
• Added render-thread-priority config value for setting the java thread priority for render-threads
• Added RenderPasses which allow addons to modify the entire tile-model without being bound to a custom block or entity
• Added logs for more info when watching for map-updates on the CLI
• Added lenient support for non-standard pack.mcmeta format
• Improved exception-handling of API-consumers
• Improved exception-handling when resolving sponge-dimension directories
• Improved troubleshoot command
• Fixed potential deadlock when resolving a configuration-exception
• Fixed world spawn position not correctly read from the level.dat
• Fixed Thread-Names of MapUpdateService-Thread, Webserver and Scheduler
• Fixed player-skin not being removed from the map-storage if the skin-provider returns an empty skin

Full Changelog

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

Highlights / Notes

A collection of smaller additions, improvements and fixes.

Upgrading from 5.15

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp

Changelog since 5.15

• WebApp: Replaced using number parameter for cache-control with no-cache header (#762, thanks to Macil)
• WebApp: Use unadjustedMovement if supported in free-flight pointer-lock mode (#763, thanks to Macil)
• Added support for "oversized chunks" → large chunks that are stored separately from the region-files (#772)
• Added render-thread-priority config value for setting the java thread priority for render-threads
• Added RenderPasses which allow addons to modify the entire tile-model without being bound to a custom block or entity
• Added logs for more info when watching for map-updates on the CLI
• Added lenient support for non-standard pack.mcmeta format
• Improved exception-handling of API-consumers
• Improved exception-handling when resolving sponge-dimension directories
• Improved troubleshoot command
• Fixed potential deadlock when resolving a configuration-exception
• Fixed world spawn position not correctly read from the level.dat
• Fixed Thread-Names of MapUpdateService-Thread, Webserver and Scheduler
• Fixed player-skin not being removed from the map-storage if the skin-provider returns an empty skin

Full Changelog

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

Highlights / Notes

A collection of smaller additions, improvements and fixes.

Upgrading from 5.15

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp

Changelog since 5.15

• WebApp: Replaced using number parameter for cache-control with no-cache header (#762, thanks to Macil)
• WebApp: Use unadjustedMovement if supported in free-flight pointer-lock mode (#763, thanks to Macil)
• Added support for "oversized chunks" → large chunks that are stored separately from the region-files (#772)
• Added render-thread-priority config value for setting the java thread priority for render-threads
• Added RenderPasses which allow addons to modify the entire tile-model without being bound to a custom block or entity
• Added logs for more info when watching for map-updates on the CLI
• Added lenient support for non-standard pack.mcmeta format
• Improved exception-handling of API-consumers
• Improved exception-handling when resolving sponge-dimension directories
• Improved troubleshoot command
• Fixed potential deadlock when resolving a configuration-exception
• Fixed world spawn position not correctly read from the level.dat
• Fixed Thread-Names of MapUpdateService-Thread, Webserver and Scheduler
• Fixed player-skin not being removed from the map-storage if the skin-provider returns an empty skin

Full Changelog

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

Highlights / Notes

Hotfix for a few bugs with 1.21.11 support.

Upgrading from 5.14

• Replace the bluemap.jar-file with the new one

Changelog since 5.14

• Updated fabric-permission-api to 0.6.1 for MC 1.21.11 compatibility
• Added a workaround for a paper-bug (in papers experimental version) that throws an exception when a player tries to join
• Fixed Fabric, Forge and NeoForge sometimes throwing an exception when a player tries to join (#761)

Full Changelog

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

Highlights / Notes

Hotfix for a few bugs with 1.21.11 support.

Upgrading from 5.14

• Replace the bluemap.jar-file with the new one

Changelog since 5.14

• Updated fabric-permission-api to 0.6.1 for MC 1.21.11 compatibility
• Added a workaround for a paper-bug (in papers experimental version) that throws an exception when a player tries to join
• Fixed Fabric, Forge and NeoForge sometimes throwing an exception when a player tries to join (#761)

Full Changelog

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

Highlights / Notes

Hotfix for a few bugs with 1.21.11 support.

Upgrading from 5.14

• Replace the bluemap.jar-file with the new one

Changelog since 5.14

• Updated fabric-permission-api to 0.6.1 for MC 1.21.11 compatibility
• Added a workaround for a paper-bug (in papers experimental version) that throws an exception when a player tries to join
• Fixed Fabric, Forge and NeoForge sometimes throwing an exception when a player tries to join (#761)

Full Changelog

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

Highlights / Notes

Hotfix for a few bugs with 1.21.11 support.

Upgrading from 5.14

• Replace the bluemap.jar-file with the new one

Changelog since 5.14

• Updated fabric-permission-api to 0.6.1 for MC 1.21.11 compatibility
• Added a workaround for a paper-bug (in papers experimental version) that throws an exception when a player tries to join
• Fixed Fabric, Forge and NeoForge sometimes throwing an exception when a player tries to join (#761)

Full Changelog

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

Highlights / Notes

Hotfix for a few bugs with 1.21.11 support.

Upgrading from 5.14

• Replace the bluemap.jar-file with the new one

Changelog since 5.14

• Updated fabric-permission-api to 0.6.1 for MC 1.21.11 compatibility
• Added a workaround for a paper-bug (in papers experimental version) that throws an exception when a player tries to join
• Fixed Fabric, Forge and NeoForge sometimes throwing an exception when a player tries to join (#761)

Full Changelog

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

Highlights / Notes

Hotfix for a few bugs with 1.21.11 support.

Upgrading from 5.14

• Replace the bluemap.jar-file with the new one

Changelog since 5.14

• Updated fabric-permission-api to 0.6.1 for MC 1.21.11 compatibility
• Added a workaround for a paper-bug (in papers experimental version) that throws an exception when a player tries to join
• Fixed Fabric, Forge and NeoForge sometimes throwing an exception when a player tries to join (#761)

Full Changelog

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

Highlights / Notes

Initial 1.21.11 support and more improvements and fixes.

Upgrading from 5.13

• Replace the bluemap.jar-file with the new one

Changelog since 5.13

• Updated fabric, forge and neoforge to support 1.21.11 (cli, spigot, paper and sponge implementations work without changes)
• Added support for new model-rotations introduced in 25w46a
• Setting ignore-missing-light-data: true config now also ignores individual missing chunks
• SQL-storages now don't require db-write permission when only reading (webserver only, no rendering)
• Removed / from webserver loggers ip-addresses
• Improved formatting and grammar/spelling in the config-templates (#756, #758, thanks to nightowl286 and TechnicJelle)
• Improved internal cache-management
• Fixed circle and ellipse render-masks ignoring their center-position setting
• Fixed an exception with the webserver handling edge-case (invalid) http-requests
• Fixed cherry-signs not rendering
• Fixed backwards compatibility for old chain-blocks not working
• Fixed black edge-lines sometimes appearing on mushroom-blocks

Full Changelog

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

Highlights / Notes

Initial 1.21.11 support and more improvements and fixes.

Upgrading from 5.13

• Replace the bluemap.jar-file with the new one

Changelog since 5.13

• Updated fabric, forge and neoforge to support 1.21.11 (cli, spigot, paper and sponge implementations work without changes)
• Added support for new model-rotations introduced in 25w46a
• Setting ignore-missing-light-data: true config now also ignores individual missing chunks
• SQL-storages now don't require db-write permission when only reading (webserver only, no rendering)
• Removed / from webserver loggers ip-addresses
• Improved formatting and grammar/spelling in the config-templates (#756, #758, thanks to nightowl286 and TechnicJelle)
• Improved internal cache-management
• Fixed circle and ellipse render-masks ignoring their center-position setting
• Fixed an exception with the webserver handling edge-case (invalid) http-requests
• Fixed cherry-signs not rendering
• Fixed backwards compatibility for old chain-blocks not working
• Fixed black edge-lines sometimes appearing on mushroom-blocks

Full Changelog

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

Highlights / Notes

Initial 1.21.11 support and more improvements and fixes.

Upgrading from 5.13

• Replace the bluemap.jar-file with the new one

Changelog since 5.13

• Updated fabric, forge and neoforge to support 1.21.11 (cli, spigot, paper and sponge implementations work without changes)
• Added support for new model-rotations introduced in 25w46a
• Setting ignore-missing-light-data: true config now also ignores individual missing chunks
• SQL-storages now don't require db-write permission when only reading (webserver only, no rendering)
• Removed / from webserver loggers ip-addresses
• Improved formatting and grammar/spelling in the config-templates (#756, #758, thanks to nightowl286 and TechnicJelle)
• Improved internal cache-management
• Fixed circle and ellipse render-masks ignoring their center-position setting
• Fixed an exception with the webserver handling edge-case (invalid) http-requests
• Fixed cherry-signs not rendering
• Fixed backwards compatibility for old chain-blocks not working
• Fixed black edge-lines sometimes appearing on mushroom-blocks

Full Changelog

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

Highlights / Notes

Initial 1.21.11 support and more improvements and fixes.

Upgrading from 5.13

• Replace the bluemap.jar-file with the new one

Changelog since 5.13

• Updated fabric, forge and neoforge to support 1.21.11 (cli, spigot, paper and sponge implementations work without changes)
• Added support for new model-rotations introduced in 25w46a
• Setting ignore-missing-light-data: true config now also ignores individual missing chunks
• SQL-storages now don't require db-write permission when only reading (webserver only, no rendering)
• Removed / from webserver loggers ip-addresses
• Improved formatting and grammar/spelling in the config-templates (#756, #758, thanks to nightowl286 and TechnicJelle)
• Improved internal cache-management
• Fixed circle and ellipse render-masks ignoring their center-position setting
• Fixed an exception with the webserver handling edge-case (invalid) http-requests
• Fixed cherry-signs not rendering
• Fixed backwards compatibility for old chain-blocks not working
• Fixed black edge-lines sometimes appearing on mushroom-blocks

Full Changelog

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

Highlights / Notes

Initial 1.21.11 support and more improvements and fixes.

Upgrading from 5.13

• Replace the bluemap.jar-file with the new one

Changelog since 5.13

• Updated fabric, forge and neoforge to support 1.21.11 (cli, spigot, paper and sponge implementations work without changes)
• Added support for new model-rotations introduced in 25w46a
• Setting ignore-missing-light-data: true config now also ignores individual missing chunks
• SQL-storages now don't require db-write permission when only reading (webserver only, no rendering)
• Removed / from webserver loggers ip-addresses
• Improved formatting and grammar/spelling in the config-templates (#756, #758, thanks to nightowl286 and TechnicJelle)
• Improved internal cache-management
• Fixed circle and ellipse render-masks ignoring their center-position setting
• Fixed an exception with the webserver handling edge-case (invalid) http-requests
• Fixed cherry-signs not rendering
• Fixed backwards compatibility for old chain-blocks not working
• Fixed black edge-lines sometimes appearing on mushroom-blocks

Full Changelog

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

Highlights / Notes

Initial 1.21.11 support and more improvements and fixes.

Upgrading from 5.13

• Replace the bluemap.jar-file with the new one

Changelog since 5.13

• Updated fabric, forge and neoforge to support 1.21.11 (cli, spigot, paper and sponge implementations work without changes)
• Added support for new model-rotations introduced in 25w46a
• Setting ignore-missing-light-data: true config now also ignores individual missing chunks
• SQL-storages now don't require db-write permission when only reading (webserver only, no rendering)
• Removed / from webserver loggers ip-addresses
• Improved formatting and grammar/spelling in the config-templates (#756, #758, thanks to nightowl286 and TechnicJelle)
• Improved internal cache-management
• Fixed circle and ellipse render-masks ignoring their center-position setting
• Fixed an exception with the webserver handling edge-case (invalid) http-requests
• Fixed cherry-signs not rendering
• Fixed backwards compatibility for old chain-blocks not working
• Fixed black edge-lines sometimes appearing on mushroom-blocks

Full Changelog

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

Highlights / Notes

Copper-chests and coppergolem statues models.
And reverted the integrated webserver changes from 5.12.
(There are some issues with using virtual-threads in combination with a database-storage that could lead to the webserver becoming unresponsive.
This issue is resolved when using Java 24+ but as long as BlueMap still supports Java 21 we revert to the previous webserver implementation)

Upgrading from 5.12

• Replace the bluemap.jar-file with the new one

Changelog since 5.12

• Added models for copper-chests
• Added models for coppergolem statues
• Added models for hanging-signs that are attached=false
• Added models for all pale-oak signs
• Reverted the integrated webserver changes from 5.12
• Fixed a loading error on forge 1.21.9+ (#743)
• Added a cooldown-time when updating the same region-file multiple times in a row
• Also scan the item folder in resourcepacks for block-models (fixes a compatibillity issues with ItemsAdder resourcepacks)
• Fixed and improved several small code-issues

Full Changelog

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

Highlights / Notes

Copper-chests and coppergolem statues models.
And reverted the integrated webserver changes from 5.12.
(There are some issues with using virtual-threads in combination with a database-storage that could lead to the webserver becoming unresponsive.
This issue is resolved when using Java 24+ but as long as BlueMap still supports Java 21 we revert to the previous webserver implementation)

Upgrading from 5.12

• Replace the bluemap.jar-file with the new one

Changelog since 5.12

• Added models for copper-chests
• Added models for coppergolem statues
• Added models for hanging-signs that are attached=false
• Added models for all pale-oak signs
• Reverted the integrated webserver changes from 5.12
• Fixed a loading error on forge 1.21.9+ (#743)
• Added a cooldown-time when updating the same region-file multiple times in a row
• Also scan the item folder in resourcepacks for block-models (fixes a compatibillity issues with ItemsAdder resourcepacks)
• Fixed and improved several small code-issues

Full Changelog

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

Highlights / Notes

Copper-chests and coppergolem statues models.
And reverted the integrated webserver changes from 5.12.
(There are some issues with using virtual-threads in combination with a database-storage that could lead to the webserver becoming unresponsive.
This issue is resolved when using Java 24+ but as long as BlueMap still supports Java 21 we revert to the previous webserver implementation)

Upgrading from 5.12

• Replace the bluemap.jar-file with the new one

Changelog since 5.12

• Added models for copper-chests
• Added models for coppergolem statues
• Added models for hanging-signs that are attached=false
• Added models for all pale-oak signs
• Reverted the integrated webserver changes from 5.12
• Fixed a loading error on forge 1.21.9+ (#743)
• Added a cooldown-time when updating the same region-file multiple times in a row
• Also scan the item folder in resourcepacks for block-models (fixes a compatibillity issues with ItemsAdder resourcepacks)
• Fixed and improved several small code-issues

Full Changelog

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

Highlights / Notes

Copper-chests and coppergolem statues models.
And reverted the integrated webserver changes from 5.12.
(There are some issues with using virtual-threads in combination with a database-storage that could lead to the webserver becoming unresponsive.
This issue is resolved when using Java 24+ but as long as BlueMap still supports Java 21 we revert to the previous webserver implementation)

Upgrading from 5.12

• Replace the bluemap.jar-file with the new one

Changelog since 5.12

• Added models for copper-chests
• Added models for coppergolem statues
• Added models for hanging-signs that are attached=false
• Added models for all pale-oak signs
• Reverted the integrated webserver changes from 5.12
• Fixed a loading error on forge 1.21.9+ (#743)
• Added a cooldown-time when updating the same region-file multiple times in a row
• Also scan the item folder in resourcepacks for block-models (fixes a compatibillity issues with ItemsAdder resourcepacks)
• Fixed and improved several small code-issues

Full Changelog

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

Highlights / Notes

Copper-chests and coppergolem statues models.
And reverted the integrated webserver changes from 5.12.
(There are some issues with using virtual-threads in combination with a database-storage that could lead to the webserver becoming unresponsive.
This issue is resolved when using Java 24+ but as long as BlueMap still supports Java 21 we revert to the previous webserver implementation)

Upgrading from 5.12

• Replace the bluemap.jar-file with the new one

Changelog since 5.12

• Added models for copper-chests
• Added models for coppergolem statues
• Added models for hanging-signs that are attached=false
• Added models for all pale-oak signs
• Reverted the integrated webserver changes from 5.12
• Fixed a loading error on forge 1.21.9+ (#743)
• Added a cooldown-time when updating the same region-file multiple times in a row
• Also scan the item folder in resourcepacks for block-models (fixes a compatibillity issues with ItemsAdder resourcepacks)
• Fixed and improved several small code-issues

Full Changelog

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

Highlights / Notes

Copper-chests and coppergolem statues models.
And reverted the integrated webserver changes from 5.12.
(There are some issues with using virtual-threads in combination with a database-storage that could lead to the webserver becoming unresponsive.
This issue is resolved when using Java 24+ but as long as BlueMap still supports Java 21 we revert to the previous webserver implementation)

Upgrading from 5.12

• Replace the bluemap.jar-file with the new one

Changelog since 5.12

• Added models for copper-chests
• Added models for coppergolem statues
• Added models for hanging-signs that are attached=false
• Added models for all pale-oak signs
• Reverted the integrated webserver changes from 5.12
• Fixed a loading error on forge 1.21.9+ (#743)
• Added a cooldown-time when updating the same region-file multiple times in a row
• Also scan the item folder in resourcepacks for block-models (fixes a compatibillity issues with ItemsAdder resourcepacks)
• Fixed and improved several small code-issues

Full Changelog

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

Highlights / Notes

This is a one-off backport of BlueMap 5.12 for Forge 1.20 - 1.20.4 (including 1.20.1) due to very high demand.

This Version needs Java 21 to run!
Forge and most mod's should be able to run on Java 21 instead of Java 17. If you can't use Java 21, then you need to use BlueMap 5.3 instead.

Upgrading from 5.3

The previous BlueMap version that supported Forge 1.20.x was 5.3, so you are likely upgrading from there.

There have been a ton of changes and new config values etc., so I really recommend you to do a full clean installation of BlueMap:
- Stop the server
- Make a backup
- Delete your current ./mods/bluemap-x-yz.jar
- Delete the ./config/bluemap
- Delete the ./bluemap directory
- Put the new bluemap-5.12-mc1.20-6-forge.jar in the ./mods folder
- Start the server
- Reconfigure BlueMap again, using the newly generated configs
You can keep the configs from your backup aside, to help you with the porting
- run /bluemap reload

If you don't want to do a clean installation to keep your currently rendered maps, you need to follow the upgrade-steps from these changelogs:
- https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.5
- https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.11

Changelog

For changelogs please see:
https://github.com/BlueMap-Minecraft/BlueMap/releases

Highlights / Notes

Full 1.21.9 support, rework of the integrated webserver and more bugfixes and improvements!

Upgrading from 5.11

• Replace the bluemap.jar-file with the new one

Changelog since 5.11

• Updated fabric-implementation to 1.21.9
• Rework of the integrated webserver from NIO to using Virtual-Threads, improving performance and maintainability
• Added remapping chain -> iron_chain for RP version 67 for improved backwards-compatibility
• Added support for block-properties in the block-colors config
• Added support for addon dependencies and soft-dependencies (#730)
• Pushed BlueMapAPI to 2.7.6
• Improved logging for region/chunk loading errors
• Fixed paper reading the wrong minecraft version id when not on a release version (Snapshots,Pre-Releases,RCs)
• Fixed element default UV calculation, fixing the appearance of the cauldron and cactus-flowerpot
• Fixed melon- and pumpkin-stems not being colored correctly (#734)
• Fixed inside-out cubes not working, fixing the appearance of all spawner-blocks
• Fixed wrong tile coordinates being displayed in /bluemap debug map ... command
• Fixed inheritance of ambient-occlusion property from parent block-model (thanks to Uiniel, #729)
• Fixed webserver incorrectly handling absolute form of HTTP "path" (#737)
• Fixed legacy config error not showing the problematic config file

Full Changelog

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

Highlights / Notes

Full 1.21.9 support, rework of the integrated webserver and more bugfixes and improvements!

Upgrading from 5.11

• Replace the bluemap.jar-file with the new one

Changelog since 5.11

• Updated fabric-implementation to 1.21.9
• Rework of the integrated webserver from NIO to using Virtual-Threads, improving performance and maintainability
• Added remapping chain -> iron_chain for RP version 67 for improved backwards-compatibility
• Added support for block-properties in the block-colors config
• Added support for addon dependencies and soft-dependencies (#730)
• Pushed BlueMapAPI to 2.7.6
• Improved logging for region/chunk loading errors
• Fixed paper reading the wrong minecraft version id when not on a release version (Snapshots,Pre-Releases,RCs)
• Fixed element default UV calculation, fixing the appearance of the cauldron and cactus-flowerpot
• Fixed melon- and pumpkin-stems not being colored correctly (#734)
• Fixed inside-out cubes not working, fixing the appearance of all spawner-blocks
• Fixed wrong tile coordinates being displayed in /bluemap debug map ... command
• Fixed inheritance of ambient-occlusion property from parent block-model (thanks to Uiniel, #729)
• Fixed webserver incorrectly handling absolute form of HTTP "path" (#737)
• Fixed legacy config error not showing the problematic config file

Full Changelog

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

Highlights / Notes

Full 1.21.9 support, rework of the integrated webserver and more bugfixes and improvements!

Upgrading from 5.11

• Replace the bluemap.jar-file with the new one

Changelog since 5.11

• Updated fabric-implementation to 1.21.9
• Rework of the integrated webserver from NIO to using Virtual-Threads, improving performance and maintainability
• Added remapping chain -> iron_chain for RP version 67 for improved backwards-compatibility
• Added support for block-properties in the block-colors config
• Added support for addon dependencies and soft-dependencies (#730)
• Pushed BlueMapAPI to 2.7.6
• Improved logging for region/chunk loading errors
• Fixed paper reading the wrong minecraft version id when not on a release version (Snapshots,Pre-Releases,RCs)
• Fixed element default UV calculation, fixing the appearance of the cauldron and cactus-flowerpot
• Fixed melon- and pumpkin-stems not being colored correctly (#734)
• Fixed inside-out cubes not working, fixing the appearance of all spawner-blocks
• Fixed wrong tile coordinates being displayed in /bluemap debug map ... command
• Fixed inheritance of ambient-occlusion property from parent block-model (thanks to Uiniel, #729)
• Fixed webserver incorrectly handling absolute form of HTTP "path" (#737)
• Fixed legacy config error not showing the problematic config file

Full Changelog

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

Highlights / Notes

Full 1.21.9 support, rework of the integrated webserver and more bugfixes and improvements!

Upgrading from 5.11

• Replace the bluemap.jar-file with the new one

Changelog since 5.11

• Updated fabric-implementation to 1.21.9
• Rework of the integrated webserver from NIO to using Virtual-Threads, improving performance and maintainability
• Added remapping chain -> iron_chain for RP version 67 for improved backwards-compatibility
• Added support for block-properties in the block-colors config
• Added support for addon dependencies and soft-dependencies (#730)
• Pushed BlueMapAPI to 2.7.6
• Improved logging for region/chunk loading errors
• Fixed paper reading the wrong minecraft version id when not on a release version (Snapshots,Pre-Releases,RCs)
• Fixed element default UV calculation, fixing the appearance of the cauldron and cactus-flowerpot
• Fixed melon- and pumpkin-stems not being colored correctly (#734)
• Fixed inside-out cubes not working, fixing the appearance of all spawner-blocks
• Fixed wrong tile coordinates being displayed in /bluemap debug map ... command
• Fixed inheritance of ambient-occlusion property from parent block-model (thanks to Uiniel, #729)
• Fixed webserver incorrectly handling absolute form of HTTP "path" (#737)
• Fixed legacy config error not showing the problematic config file

Full Changelog

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

Highlights / Notes

Full 1.21.9 support, rework of the integrated webserver and more bugfixes and improvements!

Upgrading from 5.11

• Replace the bluemap.jar-file with the new one

Changelog since 5.11

• Updated fabric-implementation to 1.21.9
• Rework of the integrated webserver from NIO to using Virtual-Threads, improving performance and maintainability
• Added remapping chain -> iron_chain for RP version 67 for improved backwards-compatibility
• Added support for block-properties in the block-colors config
• Added support for addon dependencies and soft-dependencies (#730)
• Pushed BlueMapAPI to 2.7.6
• Improved logging for region/chunk loading errors
• Fixed paper reading the wrong minecraft version id when not on a release version (Snapshots,Pre-Releases,RCs)
• Fixed element default UV calculation, fixing the appearance of the cauldron and cactus-flowerpot
• Fixed melon- and pumpkin-stems not being colored correctly (#734)
• Fixed inside-out cubes not working, fixing the appearance of all spawner-blocks
• Fixed wrong tile coordinates being displayed in /bluemap debug map ... command
• Fixed inheritance of ambient-occlusion property from parent block-model (thanks to Uiniel, #729)
• Fixed webserver incorrectly handling absolute form of HTTP "path" (#737)
• Fixed legacy config error not showing the problematic config file

Full Changelog

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

Highlights / Notes

Full 1.21.9 support, rework of the integrated webserver and more bugfixes and improvements!

Upgrading from 5.11

• Replace the bluemap.jar-file with the new one

Changelog since 5.11

• Updated fabric-implementation to 1.21.9
• Rework of the integrated webserver from NIO to using Virtual-Threads, improving performance and maintainability
• Added remapping chain -> iron_chain for RP version 67 for improved backwards-compatibility
• Added support for block-properties in the block-colors config
• Added support for addon dependencies and soft-dependencies (#730)
• Pushed BlueMapAPI to 2.7.6
• Improved logging for region/chunk loading errors
• Fixed paper reading the wrong minecraft version id when not on a release version (Snapshots,Pre-Releases,RCs)
• Fixed element default UV calculation, fixing the appearance of the cauldron and cactus-flowerpot
• Fixed melon- and pumpkin-stems not being colored correctly (#734)
• Fixed inside-out cubes not working, fixing the appearance of all spawner-blocks
• Fixed wrong tile coordinates being displayed in /bluemap debug map ... command
• Fixed inheritance of ambient-occlusion property from parent block-model (thanks to Uiniel, #729)
• Fixed webserver incorrectly handling absolute form of HTTP "path" (#737)
• Fixed legacy config error not showing the problematic config file

Full Changelog

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

Highlights / Notes

With Render-Masks it is now possible to limit your map render
to all kinds of shapes and perfectly control what you want to be visible on the map, and which regions should remain hidden.

Upgrading from 5.10

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp
• You will need to update your map configs!
• Find the section with min-x, max-x, min-z, max-z, min-y and max-y in your map config file, e.g.:
  hocon #min-x: -4000 #max-x: 4000 #min-z: -4000 #max-z: 4000 #min-y: 50 max-y: 90
  and add render-mask: [ { before, and ] } after the section, e.g. like this:
  hocon render-mask: [ { #min-x: -4000 #max-x: 4000 #min-z: -4000 #max-z: 4000 #min-y: 50 max-y: 90 } ]
  -> here is a video-example
• Optionally, you can add the new edge-light-strength: 15 property to your map config as well

Changelog since 5.10

• Added a list of render-masks to the map-configs, replacing the previous min-x, max-z, etc.., properties (#81)
• Added edge-light-strength to the map-configs to control the lighting of map-edges if render-edges is enabled
• Custom dimensions are now ordered last by default
• Improved structure and comments of the default map-configs
• Added support for minor pack-versions introduced in Minecraft Snapshot 25w31a
• Fixed lily_pad's having no tint color (#727)
• Fixed error if biomes water-color has alpha (#715)
• Updated bluemap-api to 2.7.5

Full Changelog

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

Highlights / Notes

With Render-Masks it is now possible to limit your map render
to all kinds of shapes and perfectly control what you want to be visible on the map, and which regions should remain hidden.

Upgrading from 5.10

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp
• You will need to update your map configs!
• Find the section with min-x, max-x, min-z, max-z, min-y and max-y in your map config file, e.g.:
  hocon #min-x: -4000 #max-x: 4000 #min-z: -4000 #max-z: 4000 #min-y: 50 max-y: 90
  and add render-mask: [ { before, and ] } after the section, e.g. like this:
  hocon render-mask: [ { #min-x: -4000 #max-x: 4000 #min-z: -4000 #max-z: 4000 #min-y: 50 max-y: 90 } ]
  -> here is a video-example
• Optionally, you can add the new edge-light-strength: 15 property to your map config as well

Changelog since 5.10

• Added a list of render-masks to the map-configs, replacing the previous min-x, max-z, etc.., properties (#81)
• Added edge-light-strength to the map-configs to control the lighting of map-edges if render-edges is enabled
• Custom dimensions are now ordered last by default
• Improved structure and comments of the default map-configs
• Added support for minor pack-versions introduced in Minecraft Snapshot 25w31a
• Fixed lily_pad's having no tint color (#727)
• Fixed error if biomes water-color has alpha (#715)
• Updated bluemap-api to 2.7.5

Full Changelog

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

Highlights / Notes

With Render-Masks it is now possible to limit your map render
to all kinds of shapes and perfectly control what you want to be visible on the map, and which regions should remain hidden.

Upgrading from 5.10

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp
• You will need to update your map configs!
• Find the section with min-x, max-x, min-z, max-z, min-y and max-y in your map config file, e.g.:
  hocon #min-x: -4000 #max-x: 4000 #min-z: -4000 #max-z: 4000 #min-y: 50 max-y: 90
  and add render-mask: [ { before, and ] } after the section, e.g. like this:
  hocon render-mask: [ { #min-x: -4000 #max-x: 4000 #min-z: -4000 #max-z: 4000 #min-y: 50 max-y: 90 } ]
  -> here is a video-example
• Optionally, you can add the new edge-light-strength: 15 property to your map config as well

Changelog since 5.10

• Added a list of render-masks to the map-configs, replacing the previous min-x, max-z, etc.., properties (#81)
• Added edge-light-strength to the map-configs to control the lighting of map-edges if render-edges is enabled
• Custom dimensions are now ordered last by default
• Improved structure and comments of the default map-configs
• Added support for minor pack-versions introduced in Minecraft Snapshot 25w31a
• Fixed lily_pad's having no tint color (#727)
• Fixed error if biomes water-color has alpha (#715)
• Updated bluemap-api to 2.7.5

Full Changelog

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

Highlights / Notes

With Render-Masks it is now possible to limit your map render
to all kinds of shapes and perfectly control what you want to be visible on the map, and which regions should remain hidden.

Upgrading from 5.10

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp
• You will need to update your map configs!
• Find the section with min-x, max-x, min-z, max-z, min-y and max-y in your map config file, e.g.:
  hocon #min-x: -4000 #max-x: 4000 #min-z: -4000 #max-z: 4000 #min-y: 50 max-y: 90
  and add render-mask: [ { before, and ] } after the section, e.g. like this:
  hocon render-mask: [ { #min-x: -4000 #max-x: 4000 #min-z: -4000 #max-z: 4000 #min-y: 50 max-y: 90 } ]
  -> here is a video-example
• Optionally, you can add the new edge-light-strength: 15 property to your map config as well

Changelog since 5.10

• Added a list of render-masks to the map-configs, replacing the previous min-x, max-z, etc.., properties (#81)
• Added edge-light-strength to the map-configs to control the lighting of map-edges if render-edges is enabled
• Custom dimensions are now ordered last by default
• Improved structure and comments of the default map-configs
• Added support for minor pack-versions introduced in Minecraft Snapshot 25w31a
• Fixed lily_pad's having no tint color (#727)
• Fixed error if biomes water-color has alpha (#715)
• Updated bluemap-api to 2.7.5

Full Changelog

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

Highlights / Notes

With Render-Masks it is now possible to limit your map render
to all kinds of shapes and perfectly control what you want to be visible on the map, and which regions should remain hidden.

Upgrading from 5.10

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp
• You will need to update your map configs!
• Find the section with min-x, max-x, min-z, max-z, min-y and max-y in your map config file, e.g.:
  hocon #min-x: -4000 #max-x: 4000 #min-z: -4000 #max-z: 4000 #min-y: 50 max-y: 90
  and add render-mask: [ { before, and ] } after the section, e.g. like this:
  hocon render-mask: [ { #min-x: -4000 #max-x: 4000 #min-z: -4000 #max-z: 4000 #min-y: 50 max-y: 90 } ]
  -> here is a video-example
• Optionally, you can add the new edge-light-strength: 15 property to your map config as well

Changelog since 5.10

• Added a list of render-masks to the map-configs, replacing the previous min-x, max-z, etc.., properties (#81)
• Added edge-light-strength to the map-configs to control the lighting of map-edges if render-edges is enabled
• Custom dimensions are now ordered last by default
• Improved structure and comments of the default map-configs
• Added support for minor pack-versions introduced in Minecraft Snapshot 25w31a
• Fixed lily_pad's having no tint color (#727)
• Fixed error if biomes water-color has alpha (#715)
• Updated bluemap-api to 2.7.5

Full Changelog

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

Highlights / Notes

With Render-Masks it is now possible to limit your map render
to all kinds of shapes and perfectly control what you want to be visible on the map, and which regions should remain hidden.

Upgrading from 5.10

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp
• You will need to update your map configs!
• Find the section with min-x, max-x, min-z, max-z, min-y and max-y in your map config file, e.g.:
  hocon #min-x: -4000 #max-x: 4000 #min-z: -4000 #max-z: 4000 #min-y: 50 max-y: 90
  and add render-mask: [ { before, and ] } after the section, e.g. like this:
  hocon render-mask: [ { #min-x: -4000 #max-x: 4000 #min-z: -4000 #max-z: 4000 #min-y: 50 max-y: 90 } ]
  -> here is a video-example
• Optionally, you can add the new edge-light-strength: 15 property to your map config as well

Changelog since 5.10

• Added a list of render-masks to the map-configs, replacing the previous min-x, max-z, etc.., properties (#81)
• Added edge-light-strength to the map-configs to control the lighting of map-edges if render-edges is enabled
• Custom dimensions are now ordered last by default
• Improved structure and comments of the default map-configs
• Added support for minor pack-versions introduced in Minecraft Snapshot 25w31a
• Fixed lily_pad's having no tint color (#727)
• Fixed error if biomes water-color has alpha (#715)
• Updated bluemap-api to 2.7.5

Full Changelog

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

Highlights / Notes

Resource-pack and -loading improvements,.. and some bugfixes.

Upgrading from 5.9

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp

Changelog since 5.9

• Added support for resourcepack-atlases (#720)
• Improved support for bluemap-addons loading their own resources (#720)
• The tint for custom liquids can now be defined in the blockColors.json in a resourcepack
• Updated NL translation (#713, thanks to TechnicJelle)
• Updated FI translation (#714, thanks to Chicken)
• Fixed some textures of the newer minecraft-version did not calculate the correct color for the lowres layer
• Fixed a bug where players would stop updating on paper after dying (#719)
• Fixed copying coordinates not working if the webapp is not in a secure context (not https or localhost)
• Fixed a bug with copying the region-file coordinates

Full Changelog

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

Highlights / Notes

Resource-pack and -loading improvements,.. and some bugfixes.

Upgrading from 5.9

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp

Changelog since 5.9

• Added support for resourcepack-atlases (#720)
• Improved support for bluemap-addons loading their own resources (#720)
• The tint for custom liquids can now be defined in the blockColors.json in a resourcepack
• Updated NL translation (#713, thanks to TechnicJelle)
• Updated FI translation (#714, thanks to Chicken)
• Fixed some textures of the newer minecraft-version did not calculate the correct color for the lowres layer
• Fixed a bug where players would stop updating on paper after dying (#719)
• Fixed copying coordinates not working if the webapp is not in a secure context (not https or localhost)
• Fixed a bug with copying the region-file coordinates

Full Changelog

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

Highlights / Notes

Resource-pack and -loading improvements,.. and some bugfixes.

Upgrading from 5.9

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp

Changelog since 5.9

• Added support for resourcepack-atlases (#720)
• Improved support for bluemap-addons loading their own resources (#720)
• The tint for custom liquids can now be defined in the blockColors.json in a resourcepack
• Updated NL translation (#713, thanks to TechnicJelle)
• Updated FI translation (#714, thanks to Chicken)
• Fixed some textures of the newer minecraft-version did not calculate the correct color for the lowres layer
• Fixed a bug where players would stop updating on paper after dying (#719)
• Fixed copying coordinates not working if the webapp is not in a secure context (not https or localhost)
• Fixed a bug with copying the region-file coordinates

Full Changelog

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

Highlights / Notes

Resource-pack and -loading improvements,.. and some bugfixes.

Upgrading from 5.9

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp

Changelog since 5.9

• Added support for resourcepack-atlases (#720)
• Improved support for bluemap-addons loading their own resources (#720)
• The tint for custom liquids can now be defined in the blockColors.json in a resourcepack
• Updated NL translation (#713, thanks to TechnicJelle)
• Updated FI translation (#714, thanks to Chicken)
• Fixed some textures of the newer minecraft-version did not calculate the correct color for the lowres layer
• Fixed a bug where players would stop updating on paper after dying (#719)
• Fixed copying coordinates not working if the webapp is not in a secure context (not https or localhost)
• Fixed a bug with copying the region-file coordinates

Full Changelog

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

Highlights / Notes

Resource-pack and -loading improvements,.. and some bugfixes.

Upgrading from 5.9

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp

Changelog since 5.9

• Added support for resourcepack-atlases (#720)
• Improved support for bluemap-addons loading their own resources (#720)
• The tint for custom liquids can now be defined in the blockColors.json in a resourcepack
• Updated NL translation (#713, thanks to TechnicJelle)
• Updated FI translation (#714, thanks to Chicken)
• Fixed some textures of the newer minecraft-version did not calculate the correct color for the lowres layer
• Fixed a bug where players would stop updating on paper after dying (#719)
• Fixed copying coordinates not working if the webapp is not in a secure context (not https or localhost)
• Fixed a bug with copying the region-file coordinates

Full Changelog

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

Highlights / Notes

Resource-pack and -loading improvements,.. and some bugfixes.

Upgrading from 5.9

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp

Changelog since 5.9

• Added support for resourcepack-atlases (#720)
• Improved support for bluemap-addons loading their own resources (#720)
• The tint for custom liquids can now be defined in the blockColors.json in a resourcepack
• Updated NL translation (#713, thanks to TechnicJelle)
• Updated FI translation (#714, thanks to Chicken)
• Fixed some textures of the newer minecraft-version did not calculate the correct color for the lowres layer
• Fixed a bug where players would stop updating on paper after dying (#719)
• Fixed copying coordinates not working if the webapp is not in a secure context (not https or localhost)
• Fixed a bug with copying the region-file coordinates

Full Changelog

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

Highlights / Notes

Fixes 2 harmless but annoying issues introduced with 5.8
Also check out the changelog from 5.8!

Upgrading from 5.8

• Replace the bluemap.jar-file with the new one

Changelog since 5.8

• Fixed a (harmless) IllegalStateException exception
• Fixed a debug-log i forgot to remove again

Full Changelog

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

Highlights / Notes

Fixes 2 harmless but annoying issues introduced with 5.8
Also check out the changelog from 5.8!

Upgrading from 5.8

• Replace the bluemap.jar-file with the new one

Changelog since 5.8

• Fixed a (harmless) IllegalStateException exception
• Fixed a debug-log i forgot to remove again

Full Changelog

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

Highlights / Notes

Fixes 2 harmless but annoying issues introduced with 5.8
Also check out the changelog from 5.8!

Upgrading from 5.8

• Replace the bluemap.jar-file with the new one

Changelog since 5.8

• Fixed a (harmless) IllegalStateException exception
• Fixed a debug-log i forgot to remove again

Full Changelog

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

Highlights / Notes

Fixes 2 harmless but annoying issues introduced with 5.8
Also check out the changelog from 5.8!

Upgrading from 5.8

• Replace the bluemap.jar-file with the new one

Changelog since 5.8

• Fixed a (harmless) IllegalStateException exception
• Fixed a debug-log i forgot to remove again

Full Changelog

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

Highlights / Notes

Fixes 2 harmless but annoying issues introduced with 5.8
Also check out the changelog from 5.8!

Upgrading from 5.8

• Replace the bluemap.jar-file with the new one

Changelog since 5.8

• Fixed a (harmless) IllegalStateException exception
• Fixed a debug-log i forgot to remove again

Full Changelog

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

Highlights / Notes

Fixes 2 harmless but annoying issues introduced with 5.8
Also check out the changelog from 5.8!

Upgrading from 5.8

• Replace the bluemap.jar-file with the new one

Changelog since 5.8

• Fixed a (harmless) IllegalStateException exception
• Fixed a debug-log i forgot to remove again

Full Changelog

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

Highlights / Notes

Fixes 2 harmless but annoying issues introduced with 5.8
Also check out the changelog from 5.8!

Upgrading from 5.8

• Replace the bluemap.jar-file with the new one

Changelog since 5.8

• Fixed a (harmless) IllegalStateException exception
• Fixed a debug-log i forgot to remove again

Full Changelog

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

Highlights / Notes

Full 1.21.6 support
and some smaller improvements and fixes

Upgrading from 5.7

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp

Changelog since 5.7

• Updated fabric (thanks to Mac898), forge and neoforge to minecraft 1.21.6
• Clear some caches and pools to release heap-space when it is not used for some time
• Added chunk-version to debug command
• Improved error-handling when loading corrupted entity-chunks
• Switched cli to new eta-formatting
• Added --markers option to cli which allows to (only) update markers based ont the map-configs
• Added sourcemap to webapp
• Display error screen on the webapp if webgl2 is not available
• Disabled pretty-printing for pluginState.json to discourage manual editing
• Fixed a compatibility issue with some mods on forge and neoforge
• Fixed player-markers not working if the world got loaded/added after bluemap loaded
• Fixed hanging signs not rendering correctly
• Fixed some face-culling issues
• Fixed storages command not detecting if a map is loaded or not correctly
• Fixed rare NoSuchFileException when rendering
• Fixed api RenderManager#start() not working when config uses the negative format
• Fixed webapp title not updating immediately when switching languages
• Updated vietnamese translation (thanks to songnguxyz)

Full Changelog

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

Highlights / Notes

Full 1.21.6 support
and some smaller improvements and fixes

Upgrading from 5.7

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp

Changelog since 5.7

• Updated fabric (thanks to Mac898), forge and neoforge to minecraft 1.21.6
• Clear some caches and pools to release heap-space when it is not used for some time
• Added chunk-version to debug command
• Improved error-handling when loading corrupted entity-chunks
• Switched cli to new eta-formatting
• Added --markers option to cli which allows to (only) update markers based ont the map-configs
• Added sourcemap to webapp
• Display error screen on the webapp if webgl2 is not available
• Disabled pretty-printing for pluginState.json to discourage manual editing
• Fixed a compatibility issue with some mods on forge and neoforge
• Fixed player-markers not working if the world got loaded/added after bluemap loaded
• Fixed hanging signs not rendering correctly
• Fixed some face-culling issues
• Fixed storages command not detecting if a map is loaded or not correctly
• Fixed rare NoSuchFileException when rendering
• Fixed api RenderManager#start() not working when config uses the negative format
• Fixed webapp title not updating immediately when switching languages
• Updated vietnamese translation (thanks to songnguxyz)

Full Changelog

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

Highlights / Notes

Full 1.21.6 support
and some smaller improvements and fixes

Upgrading from 5.7

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp

Changelog since 5.7

• Updated fabric (thanks to Mac898), forge and neoforge to minecraft 1.21.6
• Clear some caches and pools to release heap-space when it is not used for some time
• Added chunk-version to debug command
• Improved error-handling when loading corrupted entity-chunks
• Switched cli to new eta-formatting
• Added --markers option to cli which allows to (only) update markers based ont the map-configs
• Added sourcemap to webapp
• Display error screen on the webapp if webgl2 is not available
• Disabled pretty-printing for pluginState.json to discourage manual editing
• Fixed a compatibility issue with some mods on forge and neoforge
• Fixed player-markers not working if the world got loaded/added after bluemap loaded
• Fixed hanging signs not rendering correctly
• Fixed some face-culling issues
• Fixed storages command not detecting if a map is loaded or not correctly
• Fixed rare NoSuchFileException when rendering
• Fixed api RenderManager#start() not working when config uses the negative format
• Fixed webapp title not updating immediately when switching languages
• Updated vietnamese translation (thanks to songnguxyz)

Full Changelog

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

Highlights / Notes

Full 1.21.6 support
and some smaller improvements and fixes

Upgrading from 5.7

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp

Changelog since 5.7

• Updated fabric (thanks to Mac898), forge and neoforge to minecraft 1.21.6
• Clear some caches and pools to release heap-space when it is not used for some time
• Added chunk-version to debug command
• Improved error-handling when loading corrupted entity-chunks
• Switched cli to new eta-formatting
• Added --markers option to cli which allows to (only) update markers based ont the map-configs
• Added sourcemap to webapp
• Display error screen on the webapp if webgl2 is not available
• Disabled pretty-printing for pluginState.json to discourage manual editing
• Fixed a compatibility issue with some mods on forge and neoforge
• Fixed player-markers not working if the world got loaded/added after bluemap loaded
• Fixed hanging signs not rendering correctly
• Fixed some face-culling issues
• Fixed storages command not detecting if a map is loaded or not correctly
• Fixed rare NoSuchFileException when rendering
• Fixed api RenderManager#start() not working when config uses the negative format
• Fixed webapp title not updating immediately when switching languages
• Updated vietnamese translation (thanks to songnguxyz)

Full Changelog

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

Highlights / Notes

Full 1.21.6 support
and some smaller improvements and fixes

Upgrading from 5.7

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp

Changelog since 5.7

• Updated fabric (thanks to Mac898), forge and neoforge to minecraft 1.21.6
• Clear some caches and pools to release heap-space when it is not used for some time
• Added chunk-version to debug command
• Improved error-handling when loading corrupted entity-chunks
• Switched cli to new eta-formatting
• Added --markers option to cli which allows to (only) update markers based ont the map-configs
• Added sourcemap to webapp
• Display error screen on the webapp if webgl2 is not available
• Disabled pretty-printing for pluginState.json to discourage manual editing
• Fixed a compatibility issue with some mods on forge and neoforge
• Fixed player-markers not working if the world got loaded/added after bluemap loaded
• Fixed hanging signs not rendering correctly
• Fixed some face-culling issues
• Fixed storages command not detecting if a map is loaded or not correctly
• Fixed rare NoSuchFileException when rendering
• Fixed api RenderManager#start() not working when config uses the negative format
• Fixed webapp title not updating immediately when switching languages
• Updated vietnamese translation (thanks to songnguxyz)

Full Changelog

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

Highlights / Notes

Full 1.21.6 support
and some smaller improvements and fixes

Upgrading from 5.7

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp

Changelog since 5.7

• Updated fabric (thanks to Mac898), forge and neoforge to minecraft 1.21.6
• Clear some caches and pools to release heap-space when it is not used for some time
• Added chunk-version to debug command
• Improved error-handling when loading corrupted entity-chunks
• Switched cli to new eta-formatting
• Added --markers option to cli which allows to (only) update markers based ont the map-configs
• Added sourcemap to webapp
• Display error screen on the webapp if webgl2 is not available
• Disabled pretty-printing for pluginState.json to discourage manual editing
• Fixed a compatibility issue with some mods on forge and neoforge
• Fixed player-markers not working if the world got loaded/added after bluemap loaded
• Fixed hanging signs not rendering correctly
• Fixed some face-culling issues
• Fixed storages command not detecting if a map is loaded or not correctly
• Fixed rare NoSuchFileException when rendering
• Fixed api RenderManager#start() not working when config uses the negative format
• Fixed webapp title not updating immediately when switching languages
• Updated vietnamese translation (thanks to songnguxyz)

Full Changelog

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

Highlights / Notes

Fixed some issues with the previous release.
Make sure you checked out the update-notes of 5.6 as well.

Upgrading from 5.6

• Replace the bluemap.jar-file with the new one

Changelog since 5.6

• Added tint for bushes
• Fixed cows being rendered onto the map as black/purple cubes
• Fixed render-tasks not being scheduled in correct order
• Fixed tint for bamboo-leaves and sugarcane
• Fixed various exceptions triggered by commands / completions
• Limit the size of a single hires-tile to a reasonable amount
  (fixing memory-issues when trying to render an overly complex world)

Full Changelog

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

Highlights / Notes

Fixed some issues with the previous release.
Make sure you checked out the update-notes of 5.6 as well.

Upgrading from 5.6

• Replace the bluemap.jar-file with the new one

Changelog since 5.6

• Added tint for bushes
• Fixed cows being rendered onto the map as black/purple cubes
• Fixed render-tasks not being scheduled in correct order
• Fixed tint for bamboo-leaves and sugarcane
• Fixed various exceptions triggered by commands / completions
• Limit the size of a single hires-tile to a reasonable amount
  (fixing memory-issues when trying to render an overly complex world)

Full Changelog

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

Highlights / Notes

Fixed some issues with the previous release.
Make sure you checked out the update-notes of 5.6 as well.

Upgrading from 5.6

• Replace the bluemap.jar-file with the new one

Changelog since 5.6

• Added tint for bushes
• Fixed cows being rendered onto the map as black/purple cubes
• Fixed render-tasks not being scheduled in correct order
• Fixed tint for bamboo-leaves and sugarcane
• Fixed various exceptions triggered by commands / completions
• Limit the size of a single hires-tile to a reasonable amount
  (fixing memory-issues when trying to render an overly complex world)

Full Changelog

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

Highlights / Notes

Fixed some issues with the previous release.
Make sure you checked out the update-notes of 5.6 as well.

Upgrading from 5.6

• Replace the bluemap.jar-file with the new one

Changelog since 5.6

• Added tint for bushes
• Fixed cows being rendered onto the map as black/purple cubes
• Fixed render-tasks not being scheduled in correct order
• Fixed tint for bamboo-leaves and sugarcane
• Fixed various exceptions triggered by commands / completions
• Limit the size of a single hires-tile to a reasonable amount
  (fixing memory-issues when trying to render an overly complex world)

Full Changelog

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

Highlights / Notes

Fixed some issues with the previous release.
Make sure you checked out the update-notes of 5.6 as well.

Upgrading from 5.6

• Replace the bluemap.jar-file with the new one

Changelog since 5.6

• Added tint for bushes
• Fixed cows being rendered onto the map as black/purple cubes
• Fixed render-tasks not being scheduled in correct order
• Fixed tint for bamboo-leaves and sugarcane
• Fixed various exceptions triggered by commands / completions
• Limit the size of a single hires-tile to a reasonable amount
  (fixing memory-issues when trying to render an overly complex world)

Full Changelog

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

Highlights / Notes

Fixed some issues with the previous release.
Make sure you checked out the update-notes of 5.6 as well.

Upgrading from 5.6

• Replace the bluemap.jar-file with the new one

Changelog since 5.6

• Added tint for bushes
• Fixed cows being rendered onto the map as black/purple cubes
• Fixed render-tasks not being scheduled in correct order
• Fixed tint for bamboo-leaves and sugarcane
• Fixed various exceptions triggered by commands / completions
• Limit the size of a single hires-tile to a reasonable amount
  (fixing memory-issues when trying to render an overly complex world)

Full Changelog

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

Highlights / Notes

Reworked command-system and all commands.
Command responses now show more information, look nicer and are easier to understand.
Also lots of internal improvements.

Upgrading from 5.5

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp
• Update your permissions: https://bluemap.bluecolored.de/wiki/getting-started/Commands.html

Changelog since 5.5

• Reworked command-system and all commands
• Added support for dry_foliage color-map and leaf_litter tint
• Added directional face shading
• Added ability to copy block-coordinates
• The camera now zooms in instead of blocking when tilting further than previously allowed in certain scenarios
• Added support for reading entity-data & ability for addons to render entities
• Reworked block-entity data handling
• The cli now assumes the -r flag if one of -f -u -e is provided
• Added a hidden map-config check-for-removed-regions: true to be able to disable checking for removed regions on map-updates
• Fixed huge worlds/maps taking a long time to create their update tasks
• Fixed minecraft-client jar downloaded file not being deleted after a failed hash-check
• Fixed some storage-data not being buffered correctly (performance)
• Fixed fallback-languages not loading correctly all the time (#632, thanks to NikitaCartes)
• Fixed signs not showing in 1.13.x (#638, thanks to NikitaCartes)
• A ton of smaller fixes and stability improvements

Full Changelog

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

Highlights / Notes

Reworked command-system and all commands.
Command responses now show more information, look nicer and are easier to understand.
Also lots of internal improvements.

Upgrading from 5.5

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp
• Update your permissions: https://bluemap.bluecolored.de/wiki/getting-started/Commands.html

Changelog since 5.5

• Reworked command-system and all commands
• Added support for dry_foliage color-map and leaf_litter tint
• Added directional face shading
• Added ability to copy block-coordinates
• The camera now zooms in instead of blocking when tilting further than previously allowed in certain scenarios
• Added support for reading entity-data & ability for addons to render entities
• Reworked block-entity data handling
• The cli now assumes the -r flag if one of -f -u -e is provided
• Added a hidden map-config check-for-removed-regions: true to be able to disable checking for removed regions on map-updates
• Fixed huge worlds/maps taking a long time to create their update tasks
• Fixed minecraft-client jar downloaded file not being deleted after a failed hash-check
• Fixed some storage-data not being buffered correctly (performance)
• Fixed fallback-languages not loading correctly all the time (#632, thanks to NikitaCartes)
• Fixed signs not showing in 1.13.x (#638, thanks to NikitaCartes)
• A ton of smaller fixes and stability improvements

Full Changelog

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

Highlights / Notes

Reworked command-system and all commands.
Command responses now show more information, look nicer and are easier to understand.
Also lots of internal improvements.

Upgrading from 5.5

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp
• Update your permissions: https://bluemap.bluecolored.de/wiki/getting-started/Commands.html

Changelog since 5.5

• Reworked command-system and all commands
• Added support for dry_foliage color-map and leaf_litter tint
• Added directional face shading
• Added ability to copy block-coordinates
• The camera now zooms in instead of blocking when tilting further than previously allowed in certain scenarios
• Added support for reading entity-data & ability for addons to render entities
• Reworked block-entity data handling
• The cli now assumes the -r flag if one of -f -u -e is provided
• Added a hidden map-config check-for-removed-regions: true to be able to disable checking for removed regions on map-updates
• Fixed huge worlds/maps taking a long time to create their update tasks
• Fixed minecraft-client jar downloaded file not being deleted after a failed hash-check
• Fixed some storage-data not being buffered correctly (performance)
• Fixed fallback-languages not loading correctly all the time (#632, thanks to NikitaCartes)
• Fixed signs not showing in 1.13.x (#638, thanks to NikitaCartes)
• A ton of smaller fixes and stability improvements

Full Changelog

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

Highlights / Notes

Reworked command-system and all commands.
Command responses now show more information, look nicer and are easier to understand.
Also lots of internal improvements.

Upgrading from 5.5

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp
• Update your permissions: https://bluemap.bluecolored.de/wiki/getting-started/Commands.html

Changelog since 5.5

• Reworked command-system and all commands
• Added support for dry_foliage color-map and leaf_litter tint
• Added directional face shading
• Added ability to copy block-coordinates
• The camera now zooms in instead of blocking when tilting further than previously allowed in certain scenarios
• Added support for reading entity-data & ability for addons to render entities
• Reworked block-entity data handling
• The cli now assumes the -r flag if one of -f -u -e is provided
• Added a hidden map-config check-for-removed-regions: true to be able to disable checking for removed regions on map-updates
• Fixed huge worlds/maps taking a long time to create their update tasks
• Fixed minecraft-client jar downloaded file not being deleted after a failed hash-check
• Fixed some storage-data not being buffered correctly (performance)
• Fixed fallback-languages not loading correctly all the time (#632, thanks to NikitaCartes)
• Fixed signs not showing in 1.13.x (#638, thanks to NikitaCartes)
• A ton of smaller fixes and stability improvements

Full Changelog

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

Highlights / Notes

Reworked command-system and all commands.
Command responses now show more information, look nicer and are easier to understand.
Also lots of internal improvements.

Upgrading from 5.5

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp
• Update your permissions: https://bluemap.bluecolored.de/wiki/getting-started/Commands.html

Changelog since 5.5

• Reworked command-system and all commands
• Added support for dry_foliage color-map and leaf_litter tint
• Added directional face shading
• Added ability to copy block-coordinates
• The camera now zooms in instead of blocking when tilting further than previously allowed in certain scenarios
• Added support for reading entity-data & ability for addons to render entities
• Reworked block-entity data handling
• The cli now assumes the -r flag if one of -f -u -e is provided
• Added a hidden map-config check-for-removed-regions: true to be able to disable checking for removed regions on map-updates
• Fixed huge worlds/maps taking a long time to create their update tasks
• Fixed minecraft-client jar downloaded file not being deleted after a failed hash-check
• Fixed some storage-data not being buffered correctly (performance)
• Fixed fallback-languages not loading correctly all the time (#632, thanks to NikitaCartes)
• Fixed signs not showing in 1.13.x (#638, thanks to NikitaCartes)
• A ton of smaller fixes and stability improvements

Full Changelog

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

Highlights / Notes

Reworked command-system and all commands.
Command responses now show more information, look nicer and are easier to understand.
Also lots of internal improvements.

Upgrading from 5.5

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp
• Update your permissions: https://bluemap.bluecolored.de/wiki/getting-started/Commands.html

Changelog since 5.5

• Reworked command-system and all commands
• Added support for dry_foliage color-map and leaf_litter tint
• Added directional face shading
• Added ability to copy block-coordinates
• The camera now zooms in instead of blocking when tilting further than previously allowed in certain scenarios
• Added support for reading entity-data & ability for addons to render entities
• Reworked block-entity data handling
• The cli now assumes the -r flag if one of -f -u -e is provided
• Added a hidden map-config check-for-removed-regions: true to be able to disable checking for removed regions on map-updates
• Fixed huge worlds/maps taking a long time to create their update tasks
• Fixed minecraft-client jar downloaded file not being deleted after a failed hash-check
• Fixed some storage-data not being buffered correctly (performance)
• Fixed fallback-languages not loading correctly all the time (#632, thanks to NikitaCartes)
• Fixed signs not showing in 1.13.x (#638, thanks to NikitaCartes)
• A ton of smaller fixes and stability improvements

Full Changelog

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

Highlights / Notes

2D (flat-only) map support (O.o)
..and a first iteration of support for custom block-renderers. :)

Upgrading from 5.4

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp
• Move all contents (if any) of bluemaps addons folder into bluemaps packs folder and delete the addons folder.
  (Native addons now go into the packs folder alongside resourcepacks)
• In your webapp.conf:
• Remove the enable-free-flight configuration, this config it is no longer used.
• Add the following lines:

# Here you can specify an alternative base url from where all map data is loaded.
# Default is "maps"
#map-data-root: "https://cdn.my-domain.com/mapdata"

# Here you can specify an alternative base url from where all live data is loaded.
# Default is "maps"
#live-data-root: "https://cdn.my-domain.com/livedata"

• In each of your map-configs in the maps folder:
• Replace save-hires-layer with enable-hires (setting has been renamed)
• Add the following lines:

# Defines the initial sky-light-strength the map will be set to when it is opened.
# 0 is no sky-light, 1 is fully lighted.
# You can change this at any time.
# Default is 1
sky-light: 1

# Whether the perspective view will be enabled for this map.
# Changing this to true requires a re-render of the map, only if the hires-layer is enabled and free-flight view is disabled.
# Default is true
enable-perspective-view: true

# Whether the flat (isometric, top-down) view will be enabled for this map.
# Having only flat-view enabled while disabling free-flight and perspective will speed up the render and reduce the maps storage-size.
# Default is true
enable-flat-view: true

# Whether the free-flight view will be enabled for this map.
# Changing this to true requires a re-render of the map, only if the hires-layer is enabled and perspective view is disabled.
# Default is true
enable-free-flight-view: true

Changelog since 5.4

• Added per-map view-settings and optimized flat-view only maps (2d-map support)
• Added loading of nested feature-datapacks
• Added support for pale_oak_leaves (custom tint-color)
• Added ability to configure the map and live data root url's of the webapp
• Added model for the conduit (thanks to TyBraniff)
• Merged addons folder into packs folder (native addons not go into packs instead of addons)
• First iteration of custom block-renderer support
• The webapp now uses the browser-language as default language if available (thanks to NikitaCartes)
• Added -n option to cli allowing to pass a custom path to load resources from (e.g. a servers mods-folder) (thanks to TechnicJelle)
• Fixed/removed the black void/hole that appeared where hires tiles could not be loaded
• Fixed duplicate region render-tasks in the render-queue

Full Changelog

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

Highlights / Notes

2D (flat-only) map support (O.o)
..and a first iteration of support for custom block-renderers. :)

Upgrading from 5.4

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp
• Move all contents (if any) of bluemaps addons folder into bluemaps packs folder and delete the addons folder.
  (Native addons now go into the packs folder alongside resourcepacks)
• In your webapp.conf:
• Remove the enable-free-flight configuration, this config it is no longer used.
• Add the following lines:

# Here you can specify an alternative base url from where all map data is loaded.
# Default is "maps"
#map-data-root: "https://cdn.my-domain.com/mapdata"

# Here you can specify an alternative base url from where all live data is loaded.
# Default is "maps"
#live-data-root: "https://cdn.my-domain.com/livedata"

• In each of your map-configs in the maps folder:
• Replace save-hires-layer with enable-hires (setting has been renamed)
• Add the following lines:

# Defines the initial sky-light-strength the map will be set to when it is opened.
# 0 is no sky-light, 1 is fully lighted.
# You can change this at any time.
# Default is 1
sky-light: 1

# Whether the perspective view will be enabled for this map.
# Changing this to true requires a re-render of the map, only if the hires-layer is enabled and free-flight view is disabled.
# Default is true
enable-perspective-view: true

# Whether the flat (isometric, top-down) view will be enabled for this map.
# Having only flat-view enabled while disabling free-flight and perspective will speed up the render and reduce the maps storage-size.
# Default is true
enable-flat-view: true

# Whether the free-flight view will be enabled for this map.
# Changing this to true requires a re-render of the map, only if the hires-layer is enabled and perspective view is disabled.
# Default is true
enable-free-flight-view: true

Changelog since 5.4

• Added per-map view-settings and optimized flat-view only maps (2d-map support)
• Added loading of nested feature-datapacks
• Added support for pale_oak_leaves (custom tint-color)
• Added ability to configure the map and live data root url's of the webapp
• Added model for the conduit (thanks to TyBraniff)
• Merged addons folder into packs folder (native addons not go into packs instead of addons)
• First iteration of custom block-renderer support
• The webapp now uses the browser-language as default language if available (thanks to NikitaCartes)
• Added -n option to cli allowing to pass a custom path to load resources from (e.g. a servers mods-folder) (thanks to TechnicJelle)
• Fixed/removed the black void/hole that appeared where hires tiles could not be loaded
• Fixed duplicate region render-tasks in the render-queue

Full Changelog

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

Highlights / Notes

2D (flat-only) map support (O.o)
..and a first iteration of support for custom block-renderers. :)

Upgrading from 5.4

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp
• Move all contents (if any) of bluemaps addons folder into bluemaps packs folder and delete the addons folder.
  (Native addons now go into the packs folder alongside resourcepacks)
• In your webapp.conf:
• Remove the enable-free-flight configuration, this config it is no longer used.
• Add the following lines:

# Here you can specify an alternative base url from where all map data is loaded.
# Default is "maps"
#map-data-root: "https://cdn.my-domain.com/mapdata"

# Here you can specify an alternative base url from where all live data is loaded.
# Default is "maps"
#live-data-root: "https://cdn.my-domain.com/livedata"

• In each of your map-configs in the maps folder:
• Replace save-hires-layer with enable-hires (setting has been renamed)
• Add the following lines:

# Defines the initial sky-light-strength the map will be set to when it is opened.
# 0 is no sky-light, 1 is fully lighted.
# You can change this at any time.
# Default is 1
sky-light: 1

# Whether the perspective view will be enabled for this map.
# Changing this to true requires a re-render of the map, only if the hires-layer is enabled and free-flight view is disabled.
# Default is true
enable-perspective-view: true

# Whether the flat (isometric, top-down) view will be enabled for this map.
# Having only flat-view enabled while disabling free-flight and perspective will speed up the render and reduce the maps storage-size.
# Default is true
enable-flat-view: true

# Whether the free-flight view will be enabled for this map.
# Changing this to true requires a re-render of the map, only if the hires-layer is enabled and perspective view is disabled.
# Default is true
enable-free-flight-view: true

Changelog since 5.4

• Added per-map view-settings and optimized flat-view only maps (2d-map support)
• Added loading of nested feature-datapacks
• Added support for pale_oak_leaves (custom tint-color)
• Added ability to configure the map and live data root url's of the webapp
• Added model for the conduit (thanks to TyBraniff)
• Merged addons folder into packs folder (native addons not go into packs instead of addons)
• First iteration of custom block-renderer support
• The webapp now uses the browser-language as default language if available (thanks to NikitaCartes)
• Added -n option to cli allowing to pass a custom path to load resources from (e.g. a servers mods-folder) (thanks to TechnicJelle)
• Fixed/removed the black void/hole that appeared where hires tiles could not be loaded
• Fixed duplicate region render-tasks in the render-queue

Full Changelog

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

Highlights / Notes

2D (flat-only) map support (O.o)
..and a first iteration of support for custom block-renderers. :)

Upgrading from 5.4

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp
• Move all contents (if any) of bluemaps addons folder into bluemaps packs folder and delete the addons folder.
  (Native addons now go into the packs folder alongside resourcepacks)
• In your webapp.conf:
• Remove the enable-free-flight configuration, this config it is no longer used.
• Add the following lines:

# Here you can specify an alternative base url from where all map data is loaded.
# Default is "maps"
#map-data-root: "https://cdn.my-domain.com/mapdata"

# Here you can specify an alternative base url from where all live data is loaded.
# Default is "maps"
#live-data-root: "https://cdn.my-domain.com/livedata"

• In each of your map-configs in the maps folder:
• Replace save-hires-layer with enable-hires (setting has been renamed)
• Add the following lines:

# Defines the initial sky-light-strength the map will be set to when it is opened.
# 0 is no sky-light, 1 is fully lighted.
# You can change this at any time.
# Default is 1
sky-light: 1

# Whether the perspective view will be enabled for this map.
# Changing this to true requires a re-render of the map, only if the hires-layer is enabled and free-flight view is disabled.
# Default is true
enable-perspective-view: true

# Whether the flat (isometric, top-down) view will be enabled for this map.
# Having only flat-view enabled while disabling free-flight and perspective will speed up the render and reduce the maps storage-size.
# Default is true
enable-flat-view: true

# Whether the free-flight view will be enabled for this map.
# Changing this to true requires a re-render of the map, only if the hires-layer is enabled and perspective view is disabled.
# Default is true
enable-free-flight-view: true

Changelog since 5.4

• Added per-map view-settings and optimized flat-view only maps (2d-map support)
• Added loading of nested feature-datapacks
• Added support for pale_oak_leaves (custom tint-color)
• Added ability to configure the map and live data root url's of the webapp
• Added model for the conduit (thanks to TyBraniff)
• Merged addons folder into packs folder (native addons not go into packs instead of addons)
• First iteration of custom block-renderer support
• The webapp now uses the browser-language as default language if available (thanks to NikitaCartes)
• Added -n option to cli allowing to pass a custom path to load resources from (e.g. a servers mods-folder) (thanks to TechnicJelle)
• Fixed/removed the black void/hole that appeared where hires tiles could not be loaded
• Fixed duplicate region render-tasks in the render-queue

Full Changelog

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

Highlights / Notes

2D (flat-only) map support (O.o)
..and a first iteration of support for custom block-renderers. :)

Upgrading from 5.4

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp
• Move all contents (if any) of bluemaps addons folder into bluemaps packs folder and delete the addons folder.
  (Native addons now go into the packs folder alongside resourcepacks)
• In your webapp.conf:
• Remove the enable-free-flight configuration, this config it is no longer used.
• Add the following lines:

# Here you can specify an alternative base url from where all map data is loaded.
# Default is "maps"
#map-data-root: "https://cdn.my-domain.com/mapdata"

# Here you can specify an alternative base url from where all live data is loaded.
# Default is "maps"
#live-data-root: "https://cdn.my-domain.com/livedata"

• In each of your map-configs in the maps folder:
• Replace save-hires-layer with enable-hires (setting has been renamed)
• Add the following lines:

# Defines the initial sky-light-strength the map will be set to when it is opened.
# 0 is no sky-light, 1 is fully lighted.
# You can change this at any time.
# Default is 1
sky-light: 1

# Whether the perspective view will be enabled for this map.
# Changing this to true requires a re-render of the map, only if the hires-layer is enabled and free-flight view is disabled.
# Default is true
enable-perspective-view: true

# Whether the flat (isometric, top-down) view will be enabled for this map.
# Having only flat-view enabled while disabling free-flight and perspective will speed up the render and reduce the maps storage-size.
# Default is true
enable-flat-view: true

# Whether the free-flight view will be enabled for this map.
# Changing this to true requires a re-render of the map, only if the hires-layer is enabled and perspective view is disabled.
# Default is true
enable-free-flight-view: true

Changelog since 5.4

• Added per-map view-settings and optimized flat-view only maps (2d-map support)
• Added loading of nested feature-datapacks
• Added support for pale_oak_leaves (custom tint-color)
• Added ability to configure the map and live data root url's of the webapp
• Added model for the conduit (thanks to TyBraniff)
• Merged addons folder into packs folder (native addons not go into packs instead of addons)
• First iteration of custom block-renderer support
• The webapp now uses the browser-language as default language if available (thanks to NikitaCartes)
• Added -n option to cli allowing to pass a custom path to load resources from (e.g. a servers mods-folder) (thanks to TechnicJelle)
• Fixed/removed the black void/hole that appeared where hires tiles could not be loaded
• Fixed duplicate region render-tasks in the render-queue

Full Changelog

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

Highlights / Notes

2D (flat-only) map support (O.o)
..and a first iteration of support for custom block-renderers. :)

Upgrading from 5.4

• Replace the bluemap.jar-file with the new one
• Delete your <webroot>/index.html to make bluemap update the webapp
• Move all contents (if any) of bluemaps addons folder into bluemaps packs folder and delete the addons folder.
  (Native addons now go into the packs folder alongside resourcepacks)
• In your webapp.conf:
• Remove the enable-free-flight configuration, this config it is no longer used.
• Add the following lines:

# Here you can specify an alternative base url from where all map data is loaded.
# Default is "maps"
#map-data-root: "https://cdn.my-domain.com/mapdata"

# Here you can specify an alternative base url from where all live data is loaded.
# Default is "maps"
#live-data-root: "https://cdn.my-domain.com/livedata"

• In each of your map-configs in the maps folder:
• Replace save-hires-layer with enable-hires (setting has been renamed)
• Add the following lines:

# Defines the initial sky-light-strength the map will be set to when it is opened.
# 0 is no sky-light, 1 is fully lighted.
# You can change this at any time.
# Default is 1
sky-light: 1

# Whether the perspective view will be enabled for this map.
# Changing this to true requires a re-render of the map, only if the hires-layer is enabled and free-flight view is disabled.
# Default is true
enable-perspective-view: true

# Whether the flat (isometric, top-down) view will be enabled for this map.
# Having only flat-view enabled while disabling free-flight and perspective will speed up the render and reduce the maps storage-size.
# Default is true
enable-flat-view: true

# Whether the free-flight view will be enabled for this map.
# Changing this to true requires a re-render of the map, only if the hires-layer is enabled and perspective view is disabled.
# Default is true
enable-free-flight-view: true

Changelog since 5.4

• Added per-map view-settings and optimized flat-view only maps (2d-map support)
• Added loading of nested feature-datapacks
• Added support for pale_oak_leaves (custom tint-color)
• Added ability to configure the map and live data root url's of the webapp
• Added model for the conduit (thanks to TyBraniff)
• Merged addons folder into packs folder (native addons not go into packs instead of addons)
• First iteration of custom block-renderer support
• The webapp now uses the browser-language as default language if available (thanks to NikitaCartes)
• Added -n option to cli allowing to pass a custom path to load resources from (e.g. a servers mods-folder) (thanks to TechnicJelle)
• Fixed/removed the black void/hole that appeared where hires tiles could not be loaded
• Fixed duplicate region render-tasks in the render-queue

Full Changelog

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

Highlights / Notes

Mostly bugfixes.
BlueMap now requires Java 21.

This is the first release after a lot of changes with bluemap's build system.
From now on BlueMap's new releases will target Java 21 and there will be only one version per platform (one forge version, one fabric version, etc.).
If you need BlueMap for an older Minecraft-Version for your platform that is not supported by the latest version,
use a (previous) version of BlueMap that supports the version you need.
This change makes BlueMap easier to maintain and will help with further/future BlueMap development and new features.

Upgrading from 5.3

Just replace the .jar-file :)
Optionally delete your <webroot>/index.html to make bluemap update the webapp.

Changelog since 5.3

• Stopped pre-scanning the full map-state on map-initialization (improves bluemap load time)
• Added support for emissive textures added in Minecraft Snapshot 24w33a
• Added error-logging to the sql.php (Thanks to @ColdeZhang, #595)
• A lot of "under the hood" changes and improvements
• Fixed incompatibility with some forge-mods (#516)
• Fixed corrupted map-state files not self-healing (#588)
• Fixed Exception when loading big chunks (#587)
• Fixed webapp links with only the map-id not working (#589)
• Fixed an issue where exceptions when enabling bluemap-addons where not logged correctly
• Fixed some typos in config-templates

Full Changelog

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

Highlights / Notes

Mostly bugfixes.
BlueMap now requires Java 21.

This is the first release after a lot of changes with bluemap's build system.
From now on BlueMap's new releases will target Java 21 and there will be only one version per platform (one forge version, one fabric version, etc.).
If you need BlueMap for an older Minecraft-Version for your platform that is not supported by the latest version,
use a (previous) version of BlueMap that supports the version you need.
This change makes BlueMap easier to maintain and will help with further/future BlueMap development and new features.

Upgrading from 5.3

Just replace the .jar-file :)
Optionally delete your <webroot>/index.html to make bluemap update the webapp.

Changelog since 5.3

• Stopped pre-scanning the full map-state on map-initialization (improves bluemap load time)
• Added support for emissive textures added in Minecraft Snapshot 24w33a
• Added error-logging to the sql.php (Thanks to @ColdeZhang, #595)
• A lot of "under the hood" changes and improvements
• Fixed incompatibility with some forge-mods (#516)
• Fixed corrupted map-state files not self-healing (#588)
• Fixed Exception when loading big chunks (#587)
• Fixed webapp links with only the map-id not working (#589)
• Fixed an issue where exceptions when enabling bluemap-addons where not logged correctly
• Fixed some typos in config-templates

Full Changelog

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

Highlights / Notes

Mostly bugfixes.
BlueMap now requires Java 21.

This is the first release after a lot of changes with bluemap's build system.
From now on BlueMap's new releases will target Java 21 and there will be only one version per platform (one forge version, one fabric version, etc.).
If you need BlueMap for an older Minecraft-Version for your platform that is not supported by the latest version,
use a (previous) version of BlueMap that supports the version you need.
This change makes BlueMap easier to maintain and will help with further/future BlueMap development and new features.

Upgrading from 5.3

Just replace the .jar-file :)
Optionally delete your <webroot>/index.html to make bluemap update the webapp.

Changelog since 5.3

• Stopped pre-scanning the full map-state on map-initialization (improves bluemap load time)
• Added support for emissive textures added in Minecraft Snapshot 24w33a
• Added error-logging to the sql.php (Thanks to @ColdeZhang, #595)
• A lot of "under the hood" changes and improvements
• Fixed incompatibility with some forge-mods (#516)
• Fixed corrupted map-state files not self-healing (#588)
• Fixed Exception when loading big chunks (#587)
• Fixed webapp links with only the map-id not working (#589)
• Fixed an issue where exceptions when enabling bluemap-addons where not logged correctly
• Fixed some typos in config-templates

Full Changelog

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

Highlights / Notes

Mostly bugfixes.
BlueMap now requires Java 21.

This is the first release after a lot of changes with bluemap's build system.
From now on BlueMap's new releases will target Java 21 and there will be only one version per platform (one forge version, one fabric version, etc.).
If you need BlueMap for an older Minecraft-Version for your platform that is not supported by the latest version,
use a (previous) version of BlueMap that supports the version you need.
This change makes BlueMap easier to maintain and will help with further/future BlueMap development and new features.

Upgrading from 5.3

Just replace the .jar-file :)
Optionally delete your <webroot>/index.html to make bluemap update the webapp.

Changelog since 5.3

• Stopped pre-scanning the full map-state on map-initialization (improves bluemap load time)
• Added support for emissive textures added in Minecraft Snapshot 24w33a
• Added error-logging to the sql.php (Thanks to @ColdeZhang, #595)
• A lot of "under the hood" changes and improvements
• Fixed incompatibility with some forge-mods (#516)
• Fixed corrupted map-state files not self-healing (#588)
• Fixed Exception when loading big chunks (#587)
• Fixed webapp links with only the map-id not working (#589)
• Fixed an issue where exceptions when enabling bluemap-addons where not logged correctly
• Fixed some typos in config-templates

Full Changelog

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

Highlights / Notes

Mostly bugfixes.
BlueMap now requires Java 21.

This is the first release after a lot of changes with bluemap's build system.
From now on BlueMap's new releases will target Java 21 and there will be only one version per platform (one forge version, one fabric version, etc.).
If you need BlueMap for an older Minecraft-Version for your platform that is not supported by the latest version,
use a (previous) version of BlueMap that supports the version you need.
This change makes BlueMap easier to maintain and will help with further/future BlueMap development and new features.

Upgrading from 5.3

Just replace the .jar-file :)
Optionally delete your <webroot>/index.html to make bluemap update the webapp.

Changelog since 5.3

• Stopped pre-scanning the full map-state on map-initialization (improves bluemap load time)
• Added support for emissive textures added in Minecraft Snapshot 24w33a
• Added error-logging to the sql.php (Thanks to @ColdeZhang, #595)
• A lot of "under the hood" changes and improvements
• Fixed incompatibility with some forge-mods (#516)
• Fixed corrupted map-state files not self-healing (#588)
• Fixed Exception when loading big chunks (#587)
• Fixed webapp links with only the map-id not working (#589)
• Fixed an issue where exceptions when enabling bluemap-addons where not logged correctly
• Fixed some typos in config-templates

Full Changelog

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

Highlights / Notes

Mostly bugfixes.
BlueMap now requires Java 21.

This is the first release after a lot of changes with bluemap's build system.
From now on BlueMap's new releases will target Java 21 and there will be only one version per platform (one forge version, one fabric version, etc.).
If you need BlueMap for an older Minecraft-Version for your platform that is not supported by the latest version,
use a (previous) version of BlueMap that supports the version you need.
This change makes BlueMap easier to maintain and will help with further/future BlueMap development and new features.

Upgrading from 5.3

Just replace the .jar-file :)
Optionally delete your <webroot>/index.html to make bluemap update the webapp.

Changelog since 5.3

• Stopped pre-scanning the full map-state on map-initialization (improves bluemap load time)
• Added support for emissive textures added in Minecraft Snapshot 24w33a
• Added error-logging to the sql.php (Thanks to @ColdeZhang, #595)
• A lot of "under the hood" changes and improvements
• Fixed incompatibility with some forge-mods (#516)
• Fixed corrupted map-state files not self-healing (#588)
• Fixed Exception when loading big chunks (#587)
• Fixed webapp links with only the map-id not working (#589)
• Fixed an issue where exceptions when enabling bluemap-addons where not logged correctly
• Fixed some typos in config-templates

Full Changelog

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

Highlights / Notes

Mostly bugfixes.

Upgrading from 5.2

Just replace the .jar-file :)
Optionally delete your <webroot>/index.html to make bluemap update the webapp.

Changelog since 5.2

• Changed lowres-tile saving to be even more robust, reducing the probability of lowres-tiles corrupting even if
  there are temporary issues when trying to save them (e.g. a short db-connection loss)
  This also fixes an occasional tile-save error with databases when bluemap is disabling (or reloading).
• Reloading the webapp (F5) will now automatically trigger a map-refresh (thanks to @MicLieg)
• Fixed an error reading chunks that are larger than a certain threshold
• Fixed an NPE when the region-folder of a dimension isn't present for some time
• Fixed the debug-dump being named dump.json.gz but not being actually compressed -> renamed back to dump.json
• Fixed some leftover debug code spawning a random teststate.json on cli
• Fixed an incompatibility with some fabric/forge mods
• Fixed cli errors when using ctrl+c to stop
• Fixed exception when a player joins the server on fabric-1.20
• Fixed spigot version detection
• Fixed a core.conf typo (thanks to @monke8555)

Full Changelog

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

Highlights / Notes

Mostly bugfixes.

Upgrading from 5.2

Just replace the .jar-file :)
Optionally delete your <webroot>/index.html to make bluemap update the webapp.

Changelog since 5.2

• Changed lowres-tile saving to be even more robust, reducing the probability of lowres-tiles corrupting even if
  there are temporary issues when trying to save them (e.g. a short db-connection loss)
  This also fixes an occasional tile-save error with databases when bluemap is disabling (or reloading).
• Reloading the webapp (F5) will now automatically trigger a map-refresh (thanks to @MicLieg)
• Fixed an error reading chunks that are larger than a certain threshold
• Fixed an NPE when the region-folder of a dimension isn't present for some time
• Fixed the debug-dump being named dump.json.gz but not being actually compressed -> renamed back to dump.json
• Fixed some leftover debug code spawning a random teststate.json on cli
• Fixed an incompatibility with some fabric/forge mods
• Fixed cli errors when using ctrl+c to stop
• Fixed exception when a player joins the server on fabric-1.20
• Fixed spigot version detection
• Fixed a core.conf typo (thanks to @monke8555)

Full Changelog

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

Highlights / Notes

Mostly bugfixes.

Upgrading from 5.2

Just replace the .jar-file :)
Optionally delete your <webroot>/index.html to make bluemap update the webapp.

Changelog since 5.2

• Changed lowres-tile saving to be even more robust, reducing the probability of lowres-tiles corrupting even if
  there are temporary issues when trying to save them (e.g. a short db-connection loss)
  This also fixes an occasional tile-save error with databases when bluemap is disabling (or reloading).
• Reloading the webapp (F5) will now automatically trigger a map-refresh (thanks to @MicLieg)
• Fixed an error reading chunks that are larger than a certain threshold
• Fixed an NPE when the region-folder of a dimension isn't present for some time
• Fixed the debug-dump being named dump.json.gz but not being actually compressed -> renamed back to dump.json
• Fixed some leftover debug code spawning a random teststate.json on cli
• Fixed an incompatibility with some fabric/forge mods
• Fixed cli errors when using ctrl+c to stop
• Fixed exception when a player joins the server on fabric-1.20
• Fixed spigot version detection
• Fixed a core.conf typo (thanks to @monke8555)

Full Changelog

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

Highlights / Notes

Mostly bugfixes.

Upgrading from 5.2

Just replace the .jar-file :)
Optionally delete your <webroot>/index.html to make bluemap update the webapp.

Changelog since 5.2

• Changed lowres-tile saving to be even more robust, reducing the probability of lowres-tiles corrupting even if
  there are temporary issues when trying to save them (e.g. a short db-connection loss)
  This also fixes an occasional tile-save error with databases when bluemap is disabling (or reloading).
• Reloading the webapp (F5) will now automatically trigger a map-refresh (thanks to @MicLieg)
• Fixed an error reading chunks that are larger than a certain threshold
• Fixed an NPE when the region-folder of a dimension isn't present for some time
• Fixed the debug-dump being named dump.json.gz but not being actually compressed -> renamed back to dump.json
• Fixed some leftover debug code spawning a random teststate.json on cli
• Fixed an incompatibility with some fabric/forge mods
• Fixed cli errors when using ctrl+c to stop
• Fixed exception when a player joins the server on fabric-1.20
• Fixed spigot version detection
• Fixed a core.conf typo (thanks to @monke8555)

Full Changelog

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

Highlights / Notes

Mostly bugfixes.

Upgrading from 5.2

Just replace the .jar-file :)
Optionally delete your <webroot>/index.html to make bluemap update the webapp.

Changelog since 5.2

• Changed lowres-tile saving to be even more robust, reducing the probability of lowres-tiles corrupting even if
  there are temporary issues when trying to save them (e.g. a short db-connection loss)
  This also fixes an occasional tile-save error with databases when bluemap is disabling (or reloading).
• Reloading the webapp (F5) will now automatically trigger a map-refresh (thanks to @MicLieg)
• Fixed an error reading chunks that are larger than a certain threshold
• Fixed an NPE when the region-folder of a dimension isn't present for some time
• Fixed the debug-dump being named dump.json.gz but not being actually compressed -> renamed back to dump.json
• Fixed some leftover debug code spawning a random teststate.json on cli
• Fixed an incompatibility with some fabric/forge mods
• Fixed cli errors when using ctrl+c to stop
• Fixed exception when a player joins the server on fabric-1.20
• Fixed spigot version detection
• Fixed a core.conf typo (thanks to @monke8555)

Full Changelog

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

Highlights / Notes

Mostly bugfixes.

Upgrading from 5.2

Just replace the .jar-file :)
Optionally delete your <webroot>/index.html to make bluemap update the webapp.

Changelog since 5.2

• Changed lowres-tile saving to be even more robust, reducing the probability of lowres-tiles corrupting even if
  there are temporary issues when trying to save them (e.g. a short db-connection loss)
  This also fixes an occasional tile-save error with databases when bluemap is disabling (or reloading).
• Reloading the webapp (F5) will now automatically trigger a map-refresh (thanks to @MicLieg)
• Fixed an error reading chunks that are larger than a certain threshold
• Fixed an NPE when the region-folder of a dimension isn't present for some time
• Fixed the debug-dump being named dump.json.gz but not being actually compressed -> renamed back to dump.json
• Fixed some leftover debug code spawning a random teststate.json on cli
• Fixed an incompatibility with some fabric/forge mods
• Fixed cli errors when using ctrl+c to stop
• Fixed exception when a player joins the server on fabric-1.20
• Fixed spigot version detection
• Fixed a core.conf typo (thanks to @monke8555)

Full Changelog

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

Highlights / Notes

Mostly bugfixes.

Upgrading from 5.2

Just replace the .jar-file :)
Optionally delete your <webroot>/index.html to make bluemap update the webapp.

Changelog since 5.2

• Changed lowres-tile saving to be even more robust, reducing the probability of lowres-tiles corrupting even if
  there are temporary issues when trying to save them (e.g. a short db-connection loss)
  This also fixes an occasional tile-save error with databases when bluemap is disabling (or reloading).
• Reloading the webapp (F5) will now automatically trigger a map-refresh (thanks to @MicLieg)
• Fixed an error reading chunks that are larger than a certain threshold
• Fixed an NPE when the region-folder of a dimension isn't present for some time
• Fixed the debug-dump being named dump.json.gz but not being actually compressed -> renamed back to dump.json
• Fixed some leftover debug code spawning a random teststate.json on cli
• Fixed an incompatibility with some fabric/forge mods
• Fixed cli errors when using ctrl+c to stop
• Fixed exception when a player joins the server on fabric-1.20
• Fixed spigot version detection
• Fixed a core.conf typo (thanks to @monke8555)

Full Changelog

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

Highlights / Notes

Mostly bugfixes.

Upgrading from 5.2

Just replace the .jar-file :)
Optionally delete your <webroot>/index.html to make bluemap update the webapp.

Changelog since 5.2

• Changed lowres-tile saving to be even more robust, reducing the probability of lowres-tiles corrupting even if
  there are temporary issues when trying to save them (e.g. a short db-connection loss)
  This also fixes an occasional tile-save error with databases when bluemap is disabling (or reloading).
• Reloading the webapp (F5) will now automatically trigger a map-refresh (thanks to @MicLieg)
• Fixed an error reading chunks that are larger than a certain threshold
• Fixed an NPE when the region-folder of a dimension isn't present for some time
• Fixed the debug-dump being named dump.json.gz but not being actually compressed -> renamed back to dump.json
• Fixed some leftover debug code spawning a random teststate.json on cli
• Fixed an incompatibility with some fabric/forge mods
• Fixed cli errors when using ctrl+c to stop
• Fixed exception when a player joins the server on fabric-1.20
• Fixed spigot version detection
• Fixed a core.conf typo (thanks to @monke8555)

Full Changelog

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

Highlights / Notes

Mostly bugfixes.

Upgrading from 5.2

Just replace the .jar-file :)
Optionally delete your <webroot>/index.html to make bluemap update the webapp.

Changelog since 5.2

• Changed lowres-tile saving to be even more robust, reducing the probability of lowres-tiles corrupting even if
  there are temporary issues when trying to save them (e.g. a short db-connection loss)
  This also fixes an occasional tile-save error with databases when bluemap is disabling (or reloading).
• Reloading the webapp (F5) will now automatically trigger a map-refresh (thanks to @MicLieg)
• Fixed an error reading chunks that are larger than a certain threshold
• Fixed an NPE when the region-folder of a dimension isn't present for some time
• Fixed the debug-dump being named dump.json.gz but not being actually compressed -> renamed back to dump.json
• Fixed some leftover debug code spawning a random teststate.json on cli
• Fixed an incompatibility with some fabric/forge mods
• Fixed cli errors when using ctrl+c to stop
• Fixed exception when a player joins the server on fabric-1.20
• Fixed spigot version detection
• Fixed a core.conf typo (thanks to @monke8555)

Full Changelog

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

Highlights / Notes

Mostly bugfixes.

Upgrading from 5.2

Just replace the .jar-file :)
Optionally delete your <webroot>/index.html to make bluemap update the webapp.

Changelog since 5.2

• Changed lowres-tile saving to be even more robust, reducing the probability of lowres-tiles corrupting even if
  there are temporary issues when trying to save them (e.g. a short db-connection loss)
  This also fixes an occasional tile-save error with databases when bluemap is disabling (or reloading).
• Reloading the webapp (F5) will now automatically trigger a map-refresh (thanks to @MicLieg)
• Fixed an error reading chunks that are larger than a certain threshold
• Fixed an NPE when the region-folder of a dimension isn't present for some time
• Fixed the debug-dump being named dump.json.gz but not being actually compressed -> renamed back to dump.json
• Fixed some leftover debug code spawning a random teststate.json on cli
• Fixed an incompatibility with some fabric/forge mods
• Fixed cli errors when using ctrl+c to stop
• Fixed exception when a player joins the server on fabric-1.20
• Fixed spigot version detection
• Fixed a core.conf typo (thanks to @monke8555)

Full Changelog

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

Highlights / Notes

Mostly bugfixes.

Upgrading from 5.2

Just replace the .jar-file :)
Optionally delete your <webroot>/index.html to make bluemap update the webapp.

Changelog since 5.2

• Changed lowres-tile saving to be even more robust, reducing the probability of lowres-tiles corrupting even if
  there are temporary issues when trying to save them (e.g. a short db-connection loss)
  This also fixes an occasional tile-save error with databases when bluemap is disabling (or reloading).
• Reloading the webapp (F5) will now automatically trigger a map-refresh (thanks to @MicLieg)
• Fixed an error reading chunks that are larger than a certain threshold
• Fixed an NPE when the region-folder of a dimension isn't present for some time
• Fixed the debug-dump being named dump.json.gz but not being actually compressed -> renamed back to dump.json
• Fixed some leftover debug code spawning a random teststate.json on cli
• Fixed an incompatibility with some fabric/forge mods
• Fixed cli errors when using ctrl+c to stop
• Fixed exception when a player joins the server on fabric-1.20
• Fixed spigot version detection
• Fixed a core.conf typo (thanks to @monke8555)

Full Changelog

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

Highlights / Notes

Mostly bugfixes.

Upgrading from 5.2

Just replace the .jar-file :)
Optionally delete your <webroot>/index.html to make bluemap update the webapp.

Changelog since 5.2

• Changed lowres-tile saving to be even more robust, reducing the probability of lowres-tiles corrupting even if
  there are temporary issues when trying to save them (e.g. a short db-connection loss)
  This also fixes an occasional tile-save error with databases when bluemap is disabling (or reloading).
• Reloading the webapp (F5) will now automatically trigger a map-refresh (thanks to @MicLieg)
• Fixed an error reading chunks that are larger than a certain threshold
• Fixed an NPE when the region-folder of a dimension isn't present for some time
• Fixed the debug-dump being named dump.json.gz but not being actually compressed -> renamed back to dump.json
• Fixed some leftover debug code spawning a random teststate.json on cli
• Fixed an incompatibility with some fabric/forge mods
• Fixed cli errors when using ctrl+c to stop
• Fixed exception when a player joins the server on fabric-1.20
• Fixed spigot version detection
• Fixed a core.conf typo (thanks to @monke8555)

Full Changelog

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

Highlights / Notes

Mostly bugfixes.

Upgrading from 5.2

Just replace the .jar-file :)
Optionally delete your <webroot>/index.html to make bluemap update the webapp.

Changelog since 5.2

• Changed lowres-tile saving to be even more robust, reducing the probability of lowres-tiles corrupting even if
  there are temporary issues when trying to save them (e.g. a short db-connection loss)
  This also fixes an occasional tile-save error with databases when bluemap is disabling (or reloading).
• Reloading the webapp (F5) will now automatically trigger a map-refresh (thanks to @MicLieg)
• Fixed an error reading chunks that are larger than a certain threshold
• Fixed an NPE when the region-folder of a dimension isn't present for some time
• Fixed the debug-dump being named dump.json.gz but not being actually compressed -> renamed back to dump.json
• Fixed some leftover debug code spawning a random teststate.json on cli
• Fixed an incompatibility with some fabric/forge mods
• Fixed cli errors when using ctrl+c to stop
• Fixed exception when a player joins the server on fabric-1.20
• Fixed spigot version detection
• Fixed a core.conf typo (thanks to @monke8555)

Full Changelog

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

Highlights / Notes

Mostly bugfixes.

Upgrading from 5.2

Just replace the .jar-file :)
Optionally delete your <webroot>/index.html to make bluemap update the webapp.

Changelog since 5.2

• Changed lowres-tile saving to be even more robust, reducing the probability of lowres-tiles corrupting even if
  there are temporary issues when trying to save them (e.g. a short db-connection loss)
  This also fixes an occasional tile-save error with databases when bluemap is disabling (or reloading).
• Reloading the webapp (F5) will now automatically trigger a map-refresh (thanks to @MicLieg)
• Fixed an error reading chunks that are larger than a certain threshold
• Fixed an NPE when the region-folder of a dimension isn't present for some time
• Fixed the debug-dump being named dump.json.gz but not being actually compressed -> renamed back to dump.json
• Fixed some leftover debug code spawning a random teststate.json on cli
• Fixed an incompatibility with some fabric/forge mods
• Fixed cli errors when using ctrl+c to stop
• Fixed exception when a player joins the server on fabric-1.20
• Fixed spigot version detection
• Fixed a core.conf typo (thanks to @monke8555)

Full Changelog

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

Highlights / Notes

Faster map-data format, animated textures, refactored map-updates and world/dimension-handling,
new map-storage implementation AND BlueMap-native addons! =)

Upgrading from 5.0 or 5.1

You were already using the latest 5.x snapshot/rc?
Then don't have to do anything! Just replace the .jar-file :)

Upgrading from any other version (3.x or 4.x)

A clean re-installation is highly recommended! You WILL need to re-render all your maps.
- Shut down your server
- Make a backup
- Delete your current BlueMap-??-??.jar
- Delete the BlueMap config directory (./plugins/BlueMap or ./config/bluemap, depending on your platform)
- Delete the BlueMap data directory (the ./bluemap folder in your server root)
- Delete any existing BlueMap-databases (All tables on your db starting with bluemap_, only if you were using an sql-storage)
- Follow the usual installation steps

If you are using an external webserver or any other custom setup:
Revisit the wiki-pages and update your configuration accordingly!
Relevant changes:
- The .json.gz files are now .prbm.gz files
- The textures.json is now also compressed (textures.json.gz)
- The sql-tables have changed and the sql.php got updated accordingly

Changelog since 5.1

• Updated sponge to SpongeAPI 11
• Fixed CLI still generating the old resourcpacks folder

Changelog since 3.21 (condensed)

• Switched hires-model format from json to a custom binary format: prbm (slightly modified version of prwm)
• Massive performance improvement when loading map-tiles in the browser
• Slightly smaller on the storage
• Slightly faster to render
• Added animated textures
• Refactored Chunk-Loading and World management
• Added dimension config to the map configs
• Removed world-sky-light config from the map configs
• Full rewrite of the map-updating system
• Chunk change detection is now fully based on chunk-timestamps instead a mix with region-timestamps
• BlueMap will now delete already rendered parts of the map if the world got trimmed or chunks got otherwise removed from the world
• Changing the map-edges is now possible without purging the map
• Added command to force-update only map-tiles on map-edges
• Added debug command for checking map-tile states
• Correctly separated ResourcePacks and DataPacks
• Biomes are now fully DataPack based (internally)
• Renamed resourcepacks folder to packs (still accepting both, resource- and data-packs)
• Removed support for bluemaps biomes.json file in resource/data-packs (use the datapack format to configure custom biomes)
• Full map-storage implementation rewrite
• Add first implementation of a native-addon loader
• Addon devs now have the ability to make their addon loadable by bluemap directly instead of depending on a mod/plugin loader
• A limited version of the API is now also available on the CLI implementation, which can be used with native addons
• Addons can also make use of BlueMapCore and BlueMapCommon for extended functionality
• Native addons are EXPERIMENTAL right now
• Downloading vanilla-resources now considers all available minecraft versions
• Added support for nested resourcepacks (introduced in 1.20.2)
• Added resources for signs, hanging-signs, banners, shulker-chests, bell, mob/player-heads, (decorated-)pots and cake
  (thanks to @TyBraniff, #536)
• Allow texture-variables with missing # in certain situations to align with vanilla behaviour
  (fixes loading of some resourcepacks/mods) (thanks to @glorantq, #525)
• Removed the pretty-printing from the settings.json to discourage editing it manually
• Added -m flag to the cli which allows to specify certain maps that should be rendered
• Added -e flag to the cli which works similar as -f but only forces updating map-tiles on map-edges
• Add option to display chunk-borders on the map (thanks to @TechnicJelle, #542)
• Map-settings now load in parallel to speed up initial page-loading with many maps (thanks to @Salzian, #538)
• Added/Updated serbian, ukraine, russian, finnish, turkish, french and zh_CN translations
• Fixed render-issues with custom world-heights
• Fixed empty block-states having the wrong block-properties
• Fixed lowres-heightmaps not working below y0
• Fixed an error with self-healing when a textures file is corrupted
• Fixed unlisted markers being counted in the marker-set gui
• Fixed sql.php port config not being used
• Fixed grass-sides sometimes not being colored correctly (#492)
• Fixed popup-marker sometimes hiding behind other markers
• Fixed flickering with some animated textures introduced in 4.1
• Fixed webapp menu-title of player-markers not translatable

Full Changelog

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

Highlights / Notes

Faster map-data format, animated textures, refactored map-updates and world/dimension-handling,
new map-storage implementation AND BlueMap-native addons! =)

Upgrading from 5.0 or 5.1

You were already using the latest 5.x snapshot/rc?
Then don't have to do anything! Just replace the .jar-file :)

Upgrading from any other version (3.x or 4.x)

A clean re-installation is highly recommended! You WILL need to re-render all your maps.
- Shut down your server
- Make a backup
- Delete your current BlueMap-??-??.jar
- Delete the BlueMap config directory (./plugins/BlueMap or ./config/bluemap, depending on your platform)
- Delete the BlueMap data directory (the ./bluemap folder in your server root)
- Delete any existing BlueMap-databases (All tables on your db starting with bluemap_, only if you were using an sql-storage)
- Follow the usual installation steps

If you are using an external webserver or any other custom setup:
Revisit the wiki-pages and update your configuration accordingly!
Relevant changes:
- The .json.gz files are now .prbm.gz files
- The textures.json is now also compressed (textures.json.gz)
- The sql-tables have changed and the sql.php got updated accordingly

Changelog since 5.1

• Updated sponge to SpongeAPI 11
• Fixed CLI still generating the old resourcpacks folder

Changelog since 3.21 (condensed)

• Switched hires-model format from json to a custom binary format: prbm (slightly modified version of prwm)
• Massive performance improvement when loading map-tiles in the browser
• Slightly smaller on the storage
• Slightly faster to render
• Added animated textures
• Refactored Chunk-Loading and World management
• Added dimension config to the map configs
• Removed world-sky-light config from the map configs
• Full rewrite of the map-updating system
• Chunk change detection is now fully based on chunk-timestamps instead a mix with region-timestamps
• BlueMap will now delete already rendered parts of the map if the world got trimmed or chunks got otherwise removed from the world
• Changing the map-edges is now possible without purging the map
• Added command to force-update only map-tiles on map-edges
• Added debug command for checking map-tile states
• Correctly separated ResourcePacks and DataPacks
• Biomes are now fully DataPack based (internally)
• Renamed resourcepacks folder to packs (still accepting both, resource- and data-packs)
• Removed support for bluemaps biomes.json file in resource/data-packs (use the datapack format to configure custom biomes)
• Full map-storage implementation rewrite
• Add first implementation of a native-addon loader
• Addon devs now have the ability to make their addon loadable by bluemap directly instead of depending on a mod/plugin loader
• A limited version of the API is now also available on the CLI implementation, which can be used with native addons
• Addons can also make use of BlueMapCore and BlueMapCommon for extended functionality
• Native addons are EXPERIMENTAL right now
• Downloading vanilla-resources now considers all available minecraft versions
• Added support for nested resourcepacks (introduced in 1.20.2)
• Added resources for signs, hanging-signs, banners, shulker-chests, bell, mob/player-heads, (decorated-)pots and cake
  (thanks to @TyBraniff, #536)
• Allow texture-variables with missing # in certain situations to align with vanilla behaviour
  (fixes loading of some resourcepacks/mods) (thanks to @glorantq, #525)
• Removed the pretty-printing from the settings.json to discourage editing it manually
• Added -m flag to the cli which allows to specify certain maps that should be rendered
• Added -e flag to the cli which works similar as -f but only forces updating map-tiles on map-edges
• Add option to display chunk-borders on the map (thanks to @TechnicJelle, #542)
• Map-settings now load in parallel to speed up initial page-loading with many maps (thanks to @Salzian, #538)
• Added/Updated serbian, ukraine, russian, finnish, turkish, french and zh_CN translations
• Fixed render-issues with custom world-heights
• Fixed empty block-states having the wrong block-properties
• Fixed lowres-heightmaps not working below y0
• Fixed an error with self-healing when a textures file is corrupted
• Fixed unlisted markers being counted in the marker-set gui
• Fixed sql.php port config not being used
• Fixed grass-sides sometimes not being colored correctly (#492)
• Fixed popup-marker sometimes hiding behind other markers
• Fixed flickering with some animated textures introduced in 4.1
• Fixed webapp menu-title of player-markers not translatable

Full Changelog

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

Highlights / Notes

Faster map-data format, animated textures, refactored map-updates and world/dimension-handling,
new map-storage implementation AND BlueMap-native addons! =)

Upgrading from 5.0 or 5.1

You were already using the latest 5.x snapshot/rc?
Then don't have to do anything! Just replace the .jar-file :)

Upgrading from any other version (3.x or 4.x)

A clean re-installation is highly recommended! You WILL need to re-render all your maps.
- Shut down your server
- Make a backup
- Delete your current BlueMap-??-??.jar
- Delete the BlueMap config directory (./plugins/BlueMap or ./config/bluemap, depending on your platform)
- Delete the BlueMap data directory (the ./bluemap folder in your server root)
- Delete any existing BlueMap-databases (All tables on your db starting with bluemap_, only if you were using an sql-storage)
- Follow the usual installation steps

If you are using an external webserver or any other custom setup:
Revisit the wiki-pages and update your configuration accordingly!
Relevant changes:
- The .json.gz files are now .prbm.gz files
- The textures.json is now also compressed (textures.json.gz)
- The sql-tables have changed and the sql.php got updated accordingly

Changelog since 5.1

• Updated sponge to SpongeAPI 11
• Fixed CLI still generating the old resourcpacks folder

Changelog since 3.21 (condensed)

• Switched hires-model format from json to a custom binary format: prbm (slightly modified version of prwm)
• Massive performance improvement when loading map-tiles in the browser
• Slightly smaller on the storage
• Slightly faster to render
• Added animated textures
• Refactored Chunk-Loading and World management
• Added dimension config to the map configs
• Removed world-sky-light config from the map configs
• Full rewrite of the map-updating system
• Chunk change detection is now fully based on chunk-timestamps instead a mix with region-timestamps
• BlueMap will now delete already rendered parts of the map if the world got trimmed or chunks got otherwise removed from the world
• Changing the map-edges is now possible without purging the map
• Added command to force-update only map-tiles on map-edges
• Added debug command for checking map-tile states
• Correctly separated ResourcePacks and DataPacks
• Biomes are now fully DataPack based (internally)
• Renamed resourcepacks folder to packs (still accepting both, resource- and data-packs)
• Removed support for bluemaps biomes.json file in resource/data-packs (use the datapack format to configure custom biomes)
• Full map-storage implementation rewrite
• Add first implementation of a native-addon loader
• Addon devs now have the ability to make their addon loadable by bluemap directly instead of depending on a mod/plugin loader
• A limited version of the API is now also available on the CLI implementation, which can be used with native addons
• Addons can also make use of BlueMapCore and BlueMapCommon for extended functionality
• Native addons are EXPERIMENTAL right now
• Downloading vanilla-resources now considers all available minecraft versions
• Added support for nested resourcepacks (introduced in 1.20.2)
• Added resources for signs, hanging-signs, banners, shulker-chests, bell, mob/player-heads, (decorated-)pots and cake
  (thanks to @TyBraniff, #536)
• Allow texture-variables with missing # in certain situations to align with vanilla behaviour
  (fixes loading of some resourcepacks/mods) (thanks to @glorantq, #525)
• Removed the pretty-printing from the settings.json to discourage editing it manually
• Added -m flag to the cli which allows to specify certain maps that should be rendered
• Added -e flag to the cli which works similar as -f but only forces updating map-tiles on map-edges
• Add option to display chunk-borders on the map (thanks to @TechnicJelle, #542)
• Map-settings now load in parallel to speed up initial page-loading with many maps (thanks to @Salzian, #538)
• Added/Updated serbian, ukraine, russian, finnish, turkish, french and zh_CN translations
• Fixed render-issues with custom world-heights
• Fixed empty block-states having the wrong block-properties
• Fixed lowres-heightmaps not working below y0
• Fixed an error with self-healing when a textures file is corrupted
• Fixed unlisted markers being counted in the marker-set gui
• Fixed sql.php port config not being used
• Fixed grass-sides sometimes not being colored correctly (#492)
• Fixed popup-marker sometimes hiding behind other markers
• Fixed flickering with some animated textures introduced in 4.1
• Fixed webapp menu-title of player-markers not translatable

Full Changelog

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

Highlights / Notes

Faster map-data format, animated textures, refactored map-updates and world/dimension-handling,
new map-storage implementation AND BlueMap-native addons! =)

Upgrading from 5.0 or 5.1

You were already using the latest 5.x snapshot/rc?
Then don't have to do anything! Just replace the .jar-file :)

Upgrading from any other version (3.x or 4.x)

A clean re-installation is highly recommended! You WILL need to re-render all your maps.
- Shut down your server
- Make a backup
- Delete your current BlueMap-??-??.jar
- Delete the BlueMap config directory (./plugins/BlueMap or ./config/bluemap, depending on your platform)
- Delete the BlueMap data directory (the ./bluemap folder in your server root)
- Delete any existing BlueMap-databases (All tables on your db starting with bluemap_, only if you were using an sql-storage)
- Follow the usual installation steps

If you are using an external webserver or any other custom setup:
Revisit the wiki-pages and update your configuration accordingly!
Relevant changes:
- The .json.gz files are now .prbm.gz files
- The textures.json is now also compressed (textures.json.gz)
- The sql-tables have changed and the sql.php got updated accordingly

Changelog since 5.1

• Updated sponge to SpongeAPI 11
• Fixed CLI still generating the old resourcpacks folder

Changelog since 3.21 (condensed)

• Switched hires-model format from json to a custom binary format: prbm (slightly modified version of prwm)
• Massive performance improvement when loading map-tiles in the browser
• Slightly smaller on the storage
• Slightly faster to render
• Added animated textures
• Refactored Chunk-Loading and World management
• Added dimension config to the map configs
• Removed world-sky-light config from the map configs
• Full rewrite of the map-updating system
• Chunk change detection is now fully based on chunk-timestamps instead a mix with region-timestamps
• BlueMap will now delete already rendered parts of the map if the world got trimmed or chunks got otherwise removed from the world
• Changing the map-edges is now possible without purging the map
• Added command to force-update only map-tiles on map-edges
• Added debug command for checking map-tile states
• Correctly separated ResourcePacks and DataPacks
• Biomes are now fully DataPack based (internally)
• Renamed resourcepacks folder to packs (still accepting both, resource- and data-packs)
• Removed support for bluemaps biomes.json file in resource/data-packs (use the datapack format to configure custom biomes)
• Full map-storage implementation rewrite
• Add first implementation of a native-addon loader
• Addon devs now have the ability to make their addon loadable by bluemap directly instead of depending on a mod/plugin loader
• A limited version of the API is now also available on the CLI implementation, which can be used with native addons
• Addons can also make use of BlueMapCore and BlueMapCommon for extended functionality
• Native addons are EXPERIMENTAL right now
• Downloading vanilla-resources now considers all available minecraft versions
• Added support for nested resourcepacks (introduced in 1.20.2)
• Added resources for signs, hanging-signs, banners, shulker-chests, bell, mob/player-heads, (decorated-)pots and cake
  (thanks to @TyBraniff, #536)
• Allow texture-variables with missing # in certain situations to align with vanilla behaviour
  (fixes loading of some resourcepacks/mods) (thanks to @glorantq, #525)
• Removed the pretty-printing from the settings.json to discourage editing it manually
• Added -m flag to the cli which allows to specify certain maps that should be rendered
• Added -e flag to the cli which works similar as -f but only forces updating map-tiles on map-edges
• Add option to display chunk-borders on the map (thanks to @TechnicJelle, #542)
• Map-settings now load in parallel to speed up initial page-loading with many maps (thanks to @Salzian, #538)
• Added/Updated serbian, ukraine, russian, finnish, turkish, french and zh_CN translations
• Fixed render-issues with custom world-heights
• Fixed empty block-states having the wrong block-properties
• Fixed lowres-heightmaps not working below y0
• Fixed an error with self-healing when a textures file is corrupted
• Fixed unlisted markers being counted in the marker-set gui
• Fixed sql.php port config not being used
• Fixed grass-sides sometimes not being colored correctly (#492)
• Fixed popup-marker sometimes hiding behind other markers
• Fixed flickering with some animated textures introduced in 4.1
• Fixed webapp menu-title of player-markers not translatable

Full Changelog

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

Highlights / Notes

Faster map-data format, animated textures, refactored map-updates and world/dimension-handling,
new map-storage implementation AND BlueMap-native addons! =)

Upgrading from 5.0 or 5.1

You were already using the latest 5.x snapshot/rc?
Then don't have to do anything! Just replace the .jar-file :)

Upgrading from any other version (3.x or 4.x)

A clean re-installation is highly recommended! You WILL need to re-render all your maps.
- Shut down your server
- Make a backup
- Delete your current BlueMap-??-??.jar
- Delete the BlueMap config directory (./plugins/BlueMap or ./config/bluemap, depending on your platform)
- Delete the BlueMap data directory (the ./bluemap folder in your server root)
- Delete any existing BlueMap-databases (All tables on your db starting with bluemap_, only if you were using an sql-storage)
- Follow the usual installation steps

If you are using an external webserver or any other custom setup:
Revisit the wiki-pages and update your configuration accordingly!
Relevant changes:
- The .json.gz files are now .prbm.gz files
- The textures.json is now also compressed (textures.json.gz)
- The sql-tables have changed and the sql.php got updated accordingly

Changelog since 5.1

• Updated sponge to SpongeAPI 11
• Fixed CLI still generating the old resourcpacks folder

Changelog since 3.21 (condensed)

• Switched hires-model format from json to a custom binary format: prbm (slightly modified version of prwm)
• Massive performance improvement when loading map-tiles in the browser
• Slightly smaller on the storage
• Slightly faster to render
• Added animated textures
• Refactored Chunk-Loading and World management
• Added dimension config to the map configs
• Removed world-sky-light config from the map configs
• Full rewrite of the map-updating system
• Chunk change detection is now fully based on chunk-timestamps instead a mix with region-timestamps
• BlueMap will now delete already rendered parts of the map if the world got trimmed or chunks got otherwise removed from the world
• Changing the map-edges is now possible without purging the map
• Added command to force-update only map-tiles on map-edges
• Added debug command for checking map-tile states
• Correctly separated ResourcePacks and DataPacks
• Biomes are now fully DataPack based (internally)
• Renamed resourcepacks folder to packs (still accepting both, resource- and data-packs)
• Removed support for bluemaps biomes.json file in resource/data-packs (use the datapack format to configure custom biomes)
• Full map-storage implementation rewrite
• Add first implementation of a native-addon loader
• Addon devs now have the ability to make their addon loadable by bluemap directly instead of depending on a mod/plugin loader
• A limited version of the API is now also available on the CLI implementation, which can be used with native addons
• Addons can also make use of BlueMapCore and BlueMapCommon for extended functionality
• Native addons are EXPERIMENTAL right now
• Downloading vanilla-resources now considers all available minecraft versions
• Added support for nested resourcepacks (introduced in 1.20.2)
• Added resources for signs, hanging-signs, banners, shulker-chests, bell, mob/player-heads, (decorated-)pots and cake
  (thanks to @TyBraniff, #536)
• Allow texture-variables with missing # in certain situations to align with vanilla behaviour
  (fixes loading of some resourcepacks/mods) (thanks to @glorantq, #525)
• Removed the pretty-printing from the settings.json to discourage editing it manually
• Added -m flag to the cli which allows to specify certain maps that should be rendered
• Added -e flag to the cli which works similar as -f but only forces updating map-tiles on map-edges
• Add option to display chunk-borders on the map (thanks to @TechnicJelle, #542)
• Map-settings now load in parallel to speed up initial page-loading with many maps (thanks to @Salzian, #538)
• Added/Updated serbian, ukraine, russian, finnish, turkish, french and zh_CN translations
• Fixed render-issues with custom world-heights
• Fixed empty block-states having the wrong block-properties
• Fixed lowres-heightmaps not working below y0
• Fixed an error with self-healing when a textures file is corrupted
• Fixed unlisted markers being counted in the marker-set gui
• Fixed sql.php port config not being used
• Fixed grass-sides sometimes not being colored correctly (#492)
• Fixed popup-marker sometimes hiding behind other markers
• Fixed flickering with some animated textures introduced in 4.1
• Fixed webapp menu-title of player-markers not translatable

Full Changelog

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

Highlights / Notes

Faster map-data format, animated textures, refactored map-updates and world/dimension-handling,
new map-storage implementation AND BlueMap-native addons! =)

Upgrading from 5.0 or 5.1

You were already using the latest 5.x snapshot/rc?
Then don't have to do anything! Just replace the .jar-file :)

Upgrading from any other version (3.x or 4.x)

A clean re-installation is highly recommended! You WILL need to re-render all your maps.
- Shut down your server
- Make a backup
- Delete your current BlueMap-??-??.jar
- Delete the BlueMap config directory (./plugins/BlueMap or ./config/bluemap, depending on your platform)
- Delete the BlueMap data directory (the ./bluemap folder in your server root)
- Delete any existing BlueMap-databases (All tables on your db starting with bluemap_, only if you were using an sql-storage)
- Follow the usual installation steps

If you are using an external webserver or any other custom setup:
Revisit the wiki-pages and update your configuration accordingly!
Relevant changes:
- The .json.gz files are now .prbm.gz files
- The textures.json is now also compressed (textures.json.gz)
- The sql-tables have changed and the sql.php got updated accordingly

Changelog since 5.1

• Updated sponge to SpongeAPI 11
• Fixed CLI still generating the old resourcpacks folder

Changelog since 3.21 (condensed)

• Switched hires-model format from json to a custom binary format: prbm (slightly modified version of prwm)
• Massive performance improvement when loading map-tiles in the browser
• Slightly smaller on the storage
• Slightly faster to render
• Added animated textures
• Refactored Chunk-Loading and World management
• Added dimension config to the map configs
• Removed world-sky-light config from the map configs
• Full rewrite of the map-updating system
• Chunk change detection is now fully based on chunk-timestamps instead a mix with region-timestamps
• BlueMap will now delete already rendered parts of the map if the world got trimmed or chunks got otherwise removed from the world
• Changing the map-edges is now possible without purging the map
• Added command to force-update only map-tiles on map-edges
• Added debug command for checking map-tile states
• Correctly separated ResourcePacks and DataPacks
• Biomes are now fully DataPack based (internally)
• Renamed resourcepacks folder to packs (still accepting both, resource- and data-packs)
• Removed support for bluemaps biomes.json file in resource/data-packs (use the datapack format to configure custom biomes)
• Full map-storage implementation rewrite
• Add first implementation of a native-addon loader
• Addon devs now have the ability to make their addon loadable by bluemap directly instead of depending on a mod/plugin loader
• A limited version of the API is now also available on the CLI implementation, which can be used with native addons
• Addons can also make use of BlueMapCore and BlueMapCommon for extended functionality
• Native addons are EXPERIMENTAL right now
• Downloading vanilla-resources now considers all available minecraft versions
• Added support for nested resourcepacks (introduced in 1.20.2)
• Added resources for signs, hanging-signs, banners, shulker-chests, bell, mob/player-heads, (decorated-)pots and cake
  (thanks to @TyBraniff, #536)
• Allow texture-variables with missing # in certain situations to align with vanilla behaviour
  (fixes loading of some resourcepacks/mods) (thanks to @glorantq, #525)
• Removed the pretty-printing from the settings.json to discourage editing it manually
• Added -m flag to the cli which allows to specify certain maps that should be rendered
• Added -e flag to the cli which works similar as -f but only forces updating map-tiles on map-edges
• Add option to display chunk-borders on the map (thanks to @TechnicJelle, #542)
• Map-settings now load in parallel to speed up initial page-loading with many maps (thanks to @Salzian, #538)
• Added/Updated serbian, ukraine, russian, finnish, turkish, french and zh_CN translations
• Fixed render-issues with custom world-heights
• Fixed empty block-states having the wrong block-properties
• Fixed lowres-heightmaps not working below y0
• Fixed an error with self-healing when a textures file is corrupted
• Fixed unlisted markers being counted in the marker-set gui
• Fixed sql.php port config not being used
• Fixed grass-sides sometimes not being colored correctly (#492)
• Fixed popup-marker sometimes hiding behind other markers
• Fixed flickering with some animated textures introduced in 4.1
• Fixed webapp menu-title of player-markers not translatable

Full Changelog

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

Highlights / Notes

Faster map-data format, animated textures, refactored map-updates and world/dimension-handling,
new map-storage implementation AND BlueMap-native addons! =)

Upgrading from 5.0 or 5.1

You were already using the latest 5.x snapshot/rc?
Then don't have to do anything! Just replace the .jar-file :)

Upgrading from any other version (3.x or 4.x)

A clean re-installation is highly recommended! You WILL need to re-render all your maps.
- Shut down your server
- Make a backup
- Delete your current BlueMap-??-??.jar
- Delete the BlueMap config directory (./plugins/BlueMap or ./config/bluemap, depending on your platform)
- Delete the BlueMap data directory (the ./bluemap folder in your server root)
- Delete any existing BlueMap-databases (All tables on your db starting with bluemap_, only if you were using an sql-storage)
- Follow the usual installation steps

If you are using an external webserver or any other custom setup:
Revisit the wiki-pages and update your configuration accordingly!
Relevant changes:
- The .json.gz files are now .prbm.gz files
- The textures.json is now also compressed (textures.json.gz)
- The sql-tables have changed and the sql.php got updated accordingly

Changelog since 5.1

• Updated sponge to SpongeAPI 11
• Fixed CLI still generating the old resourcpacks folder

Changelog since 3.21 (condensed)

• Switched hires-model format from json to a custom binary format: prbm (slightly modified version of prwm)
• Massive performance improvement when loading map-tiles in the browser
• Slightly smaller on the storage
• Slightly faster to render
• Added animated textures
• Refactored Chunk-Loading and World management
• Added dimension config to the map configs
• Removed world-sky-light config from the map configs
• Full rewrite of the map-updating system
• Chunk change detection is now fully based on chunk-timestamps instead a mix with region-timestamps
• BlueMap will now delete already rendered parts of the map if the world got trimmed or chunks got otherwise removed from the world
• Changing the map-edges is now possible without purging the map
• Added command to force-update only map-tiles on map-edges
• Added debug command for checking map-tile states
• Correctly separated ResourcePacks and DataPacks
• Biomes are now fully DataPack based (internally)
• Renamed resourcepacks folder to packs (still accepting both, resource- and data-packs)
• Removed support for bluemaps biomes.json file in resource/data-packs (use the datapack format to configure custom biomes)
• Full map-storage implementation rewrite
• Add first implementation of a native-addon loader
• Addon devs now have the ability to make their addon loadable by bluemap directly instead of depending on a mod/plugin loader
• A limited version of the API is now also available on the CLI implementation, which can be used with native addons
• Addons can also make use of BlueMapCore and BlueMapCommon for extended functionality
• Native addons are EXPERIMENTAL right now
• Downloading vanilla-resources now considers all available minecraft versions
• Added support for nested resourcepacks (introduced in 1.20.2)
• Added resources for signs, hanging-signs, banners, shulker-chests, bell, mob/player-heads, (decorated-)pots and cake
  (thanks to @TyBraniff, #536)
• Allow texture-variables with missing # in certain situations to align with vanilla behaviour
  (fixes loading of some resourcepacks/mods) (thanks to @glorantq, #525)
• Removed the pretty-printing from the settings.json to discourage editing it manually
• Added -m flag to the cli which allows to specify certain maps that should be rendered
• Added -e flag to the cli which works similar as -f but only forces updating map-tiles on map-edges
• Add option to display chunk-borders on the map (thanks to @TechnicJelle, #542)
• Map-settings now load in parallel to speed up initial page-loading with many maps (thanks to @Salzian, #538)
• Added/Updated serbian, ukraine, russian, finnish, turkish, french and zh_CN translations
• Fixed render-issues with custom world-heights
• Fixed empty block-states having the wrong block-properties
• Fixed lowres-heightmaps not working below y0
• Fixed an error with self-healing when a textures file is corrupted
• Fixed unlisted markers being counted in the marker-set gui
• Fixed sql.php port config not being used
• Fixed grass-sides sometimes not being colored correctly (#492)
• Fixed popup-marker sometimes hiding behind other markers
• Fixed flickering with some animated textures introduced in 4.1
• Fixed webapp menu-title of player-markers not translatable

Full Changelog

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

Highlights / Notes

Faster map-data format, animated textures, refactored map-updates and world/dimension-handling,
new map-storage implementation AND BlueMap-native addons! =)

Upgrading from 5.0 or 5.1

You were already using the latest 5.x snapshot/rc?
Then don't have to do anything! Just replace the .jar-file :)

Upgrading from any other version (3.x or 4.x)

A clean re-installation is highly recommended! You WILL need to re-render all your maps.
- Shut down your server
- Make a backup
- Delete your current BlueMap-??-??.jar
- Delete the BlueMap config directory (./plugins/BlueMap or ./config/bluemap, depending on your platform)
- Delete the BlueMap data directory (the ./bluemap folder in your server root)
- Delete any existing BlueMap-databases (All tables on your db starting with bluemap_, only if you were using an sql-storage)
- Follow the usual installation steps

If you are using an external webserver or any other custom setup:
Revisit the wiki-pages and update your configuration accordingly!
Relevant changes:
- The .json.gz files are now .prbm.gz files
- The textures.json is now also compressed (textures.json.gz)
- The sql-tables have changed and the sql.php got updated accordingly

Changelog since 5.1

• Updated sponge to SpongeAPI 11
• Fixed CLI still generating the old resourcpacks folder

Changelog since 3.21 (condensed)

• Switched hires-model format from json to a custom binary format: prbm (slightly modified version of prwm)
• Massive performance improvement when loading map-tiles in the browser
• Slightly smaller on the storage
• Slightly faster to render
• Added animated textures
• Refactored Chunk-Loading and World management
• Added dimension config to the map configs
• Removed world-sky-light config from the map configs
• Full rewrite of the map-updating system
• Chunk change detection is now fully based on chunk-timestamps instead a mix with region-timestamps
• BlueMap will now delete already rendered parts of the map if the world got trimmed or chunks got otherwise removed from the world
• Changing the map-edges is now possible without purging the map
• Added command to force-update only map-tiles on map-edges
• Added debug command for checking map-tile states
• Correctly separated ResourcePacks and DataPacks
• Biomes are now fully DataPack based (internally)
• Renamed resourcepacks folder to packs (still accepting both, resource- and data-packs)
• Removed support for bluemaps biomes.json file in resource/data-packs (use the datapack format to configure custom biomes)
• Full map-storage implementation rewrite
• Add first implementation of a native-addon loader
• Addon devs now have the ability to make their addon loadable by bluemap directly instead of depending on a mod/plugin loader
• A limited version of the API is now also available on the CLI implementation, which can be used with native addons
• Addons can also make use of BlueMapCore and BlueMapCommon for extended functionality
• Native addons are EXPERIMENTAL right now
• Downloading vanilla-resources now considers all available minecraft versions
• Added support for nested resourcepacks (introduced in 1.20.2)
• Added resources for signs, hanging-signs, banners, shulker-chests, bell, mob/player-heads, (decorated-)pots and cake
  (thanks to @TyBraniff, #536)
• Allow texture-variables with missing # in certain situations to align with vanilla behaviour
  (fixes loading of some resourcepacks/mods) (thanks to @glorantq, #525)
• Removed the pretty-printing from the settings.json to discourage editing it manually
• Added -m flag to the cli which allows to specify certain maps that should be rendered
• Added -e flag to the cli which works similar as -f but only forces updating map-tiles on map-edges
• Add option to display chunk-borders on the map (thanks to @TechnicJelle, #542)
• Map-settings now load in parallel to speed up initial page-loading with many maps (thanks to @Salzian, #538)
• Added/Updated serbian, ukraine, russian, finnish, turkish, french and zh_CN translations
• Fixed render-issues with custom world-heights
• Fixed empty block-states having the wrong block-properties
• Fixed lowres-heightmaps not working below y0
• Fixed an error with self-healing when a textures file is corrupted
• Fixed unlisted markers being counted in the marker-set gui
• Fixed sql.php port config not being used
• Fixed grass-sides sometimes not being colored correctly (#492)
• Fixed popup-marker sometimes hiding behind other markers
• Fixed flickering with some animated textures introduced in 4.1
• Fixed webapp menu-title of player-markers not translatable

Full Changelog

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

Highlights / Notes

Faster map-data format, animated textures, refactored map-updates and world/dimension-handling,
new map-storage implementation AND BlueMap-native addons! =)

Upgrading from 5.0 or 5.1

You were already using the latest 5.x snapshot/rc?
Then don't have to do anything! Just replace the .jar-file :)

Upgrading from any other version (3.x or 4.x)

A clean re-installation is highly recommended! You WILL need to re-render all your maps.
- Shut down your server
- Make a backup
- Delete your current BlueMap-??-??.jar
- Delete the BlueMap config directory (./plugins/BlueMap or ./config/bluemap, depending on your platform)
- Delete the BlueMap data directory (the ./bluemap folder in your server root)
- Delete any existing BlueMap-databases (All tables on your db starting with bluemap_, only if you were using an sql-storage)
- Follow the usual installation steps

If you are using an external webserver or any other custom setup:
Revisit the wiki-pages and update your configuration accordingly!
Relevant changes:
- The .json.gz files are now .prbm.gz files
- The textures.json is now also compressed (textures.json.gz)
- The sql-tables have changed and the sql.php got updated accordingly

Changelog since 5.1

• Updated sponge to SpongeAPI 11
• Fixed CLI still generating the old resourcpacks folder

Changelog since 3.21 (condensed)

• Switched hires-model format from json to a custom binary format: prbm (slightly modified version of prwm)
• Massive performance improvement when loading map-tiles in the browser
• Slightly smaller on the storage
• Slightly faster to render
• Added animated textures
• Refactored Chunk-Loading and World management
• Added dimension config to the map configs
• Removed world-sky-light config from the map configs
• Full rewrite of the map-updating system
• Chunk change detection is now fully based on chunk-timestamps instead a mix with region-timestamps
• BlueMap will now delete already rendered parts of the map if the world got trimmed or chunks got otherwise removed from the world
• Changing the map-edges is now possible without purging the map
• Added command to force-update only map-tiles on map-edges
• Added debug command for checking map-tile states
• Correctly separated ResourcePacks and DataPacks
• Biomes are now fully DataPack based (internally)
• Renamed resourcepacks folder to packs (still accepting both, resource- and data-packs)
• Removed support for bluemaps biomes.json file in resource/data-packs (use the datapack format to configure custom biomes)
• Full map-storage implementation rewrite
• Add first implementation of a native-addon loader
• Addon devs now have the ability to make their addon loadable by bluemap directly instead of depending on a mod/plugin loader
• A limited version of the API is now also available on the CLI implementation, which can be used with native addons
• Addons can also make use of BlueMapCore and BlueMapCommon for extended functionality
• Native addons are EXPERIMENTAL right now
• Downloading vanilla-resources now considers all available minecraft versions
• Added support for nested resourcepacks (introduced in 1.20.2)
• Added resources for signs, hanging-signs, banners, shulker-chests, bell, mob/player-heads, (decorated-)pots and cake
  (thanks to @TyBraniff, #536)
• Allow texture-variables with missing # in certain situations to align with vanilla behaviour
  (fixes loading of some resourcepacks/mods) (thanks to @glorantq, #525)
• Removed the pretty-printing from the settings.json to discourage editing it manually
• Added -m flag to the cli which allows to specify certain maps that should be rendered
• Added -e flag to the cli which works similar as -f but only forces updating map-tiles on map-edges
• Add option to display chunk-borders on the map (thanks to @TechnicJelle, #542)
• Map-settings now load in parallel to speed up initial page-loading with many maps (thanks to @Salzian, #538)
• Added/Updated serbian, ukraine, russian, finnish, turkish, french and zh_CN translations
• Fixed render-issues with custom world-heights
• Fixed empty block-states having the wrong block-properties
• Fixed lowres-heightmaps not working below y0
• Fixed an error with self-healing when a textures file is corrupted
• Fixed unlisted markers being counted in the marker-set gui
• Fixed sql.php port config not being used
• Fixed grass-sides sometimes not being colored correctly (#492)
• Fixed popup-marker sometimes hiding behind other markers
• Fixed flickering with some animated textures introduced in 4.1
• Fixed webapp menu-title of player-markers not translatable

Full Changelog

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