Version 5.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

Targets:

Java: 25
BlueMapAPI: 2.8.0

File	Target Version
bluemap-5.22-cli.jar	Minecraft 1.13.2 - 26.2
bluemap-5.22-spigot.jar	Spigot/Paper 26.1 - 26.2 (1.20 - 26.2 with Java 25)
bluemap-5.22-paper.jar	Paper/Folia 26.1.1 - 26.2
bluemap-5.22-fabric.jar	Fabric 26.1 - 26.2
bluemap-5.22-forge.jar	Forge 26.1 - 26.2
bluemap-5.22-neoforge.jar	NeoForge 26.1 - 26.2
bluemap-5.22-sponge.jar	SpongeAPI 17 - 19 (with Java 25)

Version 5.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

Targets:

Java: 25
BlueMapAPI: 2.8.0

File	Target Version
bluemap-5.21-cli.jar	Minecraft 1.13.2 - 26.2
bluemap-5.21-spigot.jar	Spigot/Paper 26.1 - 26.2 (1.20 - 26.2 with Java 25)
bluemap-5.21-paper.jar	Paper/Folia 26.1.1 - 26.2
bluemap-5.21-fabric.jar	Fabric 26.1 - 26.2
bluemap-5.21-forge.jar	Forge 26.1 - 26.2
bluemap-5.21-neoforge.jar	NeoForge 26.1 - 26.2
bluemap-5.21-sponge.jar	SpongeAPI 17 - 19 (with Java 25)

Version 5.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

Targets:

Java: 25
BlueMapAPI: 2.7.8

File	Target Version
bluemap-5.20-cli.jar	Minecraft 1.13.2 - 26.1.2
bluemap-5.20-spigot.jar	Spigot 26.1 - 26.1.2 (1.20 - 26.1.1 with Java 25)
bluemap-5.20-paper.jar	Paper/Folia 26.1.1 - 26.1.2
bluemap-5.20-fabric.jar	Fabric 26.1 - 26.1.2
bluemap-5.20-forge.jar	Forge 26.1 - 26.1.2
bluemap-5.20-neoforge.jar	NeoForge 26.1 - 26.1.2
bluemap-5.20-sponge.jar	SpongeAPI 17 - 19 (with Java 25)

Version 5.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

Targets:

Java: 25
BlueMapAPI: 2.7.8

File	Target Version
bluemap-5.19-cli.jar	Minecraft 1.13.2 - 26.1.1
bluemap-5.19-spigot.jar	Spigot/Paper 26.1 - 26.1.1 (1.20 - 26.1.1 with Java 25)
bluemap-5.19-paper.jar	Paper/Folia 26.1.1
bluemap-5.19-fabric.jar	Fabric 26.1 - 26.1.1
bluemap-5.19-forge.jar	Forge 26.1 - 26.1.1
bluemap-5.19-neoforge.jar	NeoForge 26.1 - 26.1.1
bluemap-5.19-sponge.jar	SpongeAPI 17 - 19 (with Java 25)

Version 5.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

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

Targets:

Java: 25
BlueMapAPI: 2.7.7

File	Target Version
bluemap-5.18-cli.jar	Minecraft 1.13.2 - 26.1
bluemap-5.18-spigot.jar	Spigot/Paper 26.1 (1.20 - 26.1 with Java 25)
bluemap-5.18-paper.jar	Paper/Folia 26.1 (1.21.5 - 26.1 with Java 25)
bluemap-5.18-fabric.jar	Fabric 26.1
bluemap-5.18-forge.jar	Forge 26.1
bluemap-5.18-neoforge.jar	NeoForge 26.1
bluemap-5.18-sponge.jar	SpongeAPI 17 - 18 (with Java 25)

Version 5.17

Highlights / Notes

Java 25 now required & Minecraft 26.1 support added.

(Note, that for this release there is no forge version included. As soon as forge for 26.1 is available, there will be a another release which then will also have a forge-build.)

Upgrading from 5.16

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

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

Targets:

Java: 25
BlueMapAPI: 2.7.7

File	Target Version
bluemap-5.17-cli.jar	Minecraft 1.13.2 - 26.1
bluemap-5.17-spigot.jar	Spigot/Paper 26.1 (1.20 - 26.1 with Java 25)
bluemap-5.17-paper.jar	Paper/Folia 26.1 (1.21.5 - 26.1 with Java 25)
bluemap-5.17-fabric.jar	Fabric 26.1
bluemap-5.17-forge.jar	Forge 26.1
bluemap-5.17-neoforge.jar	NeoForge 26.1
bluemap-5.17-sponge.jar	SpongeAPI 17 - 18 (with Java 25)

Version 5.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: v5.15...v5.16

Targets:

Java: 21
BlueMapAPI: 2.7.7

File	Target Version
bluemap-5.16-cli.jar	CLI for Minecraft 1.13.2 - 1.21.11
bluemap-5.16-spigot.jar	Spigot/Paper 1.20 - 1.21.11
bluemap-5.16-paper.jar	Paper/Folia 1.21.5 - 1.21.11
bluemap-5.16-fabric.jar	Fabric 1.21.11
bluemap-5.16-forge.jar	Forge 1.21.11
bluemap-5.16-neoforge.jar	NeoForge 1.21.11
bluemap-5.16-sponge.jar	SpongeAPI 11 - 18

Version 5.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)

Targets:

Java: 21
BlueMapAPI: 2.7.7

File	Target Version
bluemap-5.15-cli.jar	CLI for Minecraft 1.13.2 - 1.21.11
bluemap-5.15-spigot.jar	Spigot/Paper 1.20 - 1.21.11
bluemap-5.15-paper.jar	Paper/Folia 1.21.5 - 1.21.11
bluemap-5.15-fabric.jar	Fabric 1.21.11
bluemap-5.15-forge.jar	Forge 1.21.11
bluemap-5.15-neoforge.jar	NeoForge 1.21.11
bluemap-5.15-sponge.jar	SpongeAPI 11 - 18

Version 5.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

Targets:

Java: 21
BlueMapAPI: 2.7.7

File	Target Version
bluemap-5.14-cli.jar	CLI for Minecraft 1.13.2 - 1.21.11
bluemap-5.14-spigot.jar	Spigot/Paper 1.20 - 1.21.11
bluemap-5.14-paper.jar	Paper/Folia 1.20.6 - 1.21.11
bluemap-5.14-fabric.jar	Fabric 1.21.11
bluemap-5.14-forge.jar	Forge 1.21.11
bluemap-5.14-neoforge.jar	NeoForge 1.21.11
bluemap-5.14-sponge.jar	SpongeAPI 11 - 18

Version 5.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

Targets:

Java: 21
BlueMapAPI: 2.7.6

File	Target Version
bluemap-5.13-cli.jar	CLI for Minecraft 1.13.2 - 1.21.10
bluemap-5.13-spigot.jar	Spigot/Paper 1.20 - 1.21.10
bluemap-5.13-paper.jar	Paper/Folia 1.20.6 - 1.21.10
bluemap-5.13-fabric.jar	Fabric 1.21.9 - 1.21.10
bluemap-5.13-forge.jar	Forge 1.21.6 - 1.21.10
bluemap-5.13-neoforge.jar	NeoForge 1.21.6 - 1.21.10
bluemap-5.13-sponge.jar	SpongeAPI 11 - 17