Release notes from BlueMap

Version 5.16

2026-02-13T13:38:40Z

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

2025-12-17T17:21:55Z

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

2025-12-10T11:06:17Z

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

2025-10-22T12:08:41Z

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

Version 5.12

2025-10-08T15:13:12Z

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

Targets:

Java: 21
BlueMapAPI: 2.7.6

File	Target Version
bluemap-5.12-cli.jar	CLI for Minecraft 1.13.2 - 1.21.10
bluemap-5.12-spigot.jar	Spigot/Paper 1.20 - 1.21.10
bluemap-5.12-paper.jar	Paper/Folia 1.20.6 - 1.21.10
bluemap-5.12-fabric.jar	Fabric 1.21.9 - 1.21.10
bluemap-5.12-forge.jar	Forge 1.21.6 - 1.21.10
bluemap-5.12-mc1.20-6-forge.jar	Forge 1.20 - 1.20.4 (with Java 21)
bluemap-5.12-neoforge.jar	NeoForge 1.21.6 - 1.21.10
bluemap-5.12-sponge.jar	SpongeAPI 11 - 17

Version 5.11

2025-08-06T13:09:52Z

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.:
```
#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:
```
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
  
  smaller.mp4
- 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

Targets:

Java: 21
BlueMapAPI: 2.7.5

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

Version 5.10

2025-07-23T19:21:14Z

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

Targets:

Java: 21
BlueMapAPI: 2.7.4

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

Version 5.9

2025-07-17T14:33:56Z

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

Targets:

Java: 21
BlueMapAPI: 2.7.4

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

Version 5.8

2025-06-22T16:45:42Z

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)

Targets:

Java: 21
BlueMapAPI: 2.7.4

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

Version 5.7

2025-11-10T10:21:12Z

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)

Targets:

Java: 21
BlueMapAPI: 2.7.4

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