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: trueconfig 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
itemfolder 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
./bluemapdirectory - Put the new
bluemap-5.12-mc1.20-6-forge.jarin the./modsfolder - 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


