Version 4.1 (Snapshot)

Highlights / Notes

Animated Textures!

!!! This is a SNAPSHOT and is not production-ready! Use at your own risk. !!!

Upgrading from 4.0

• replace your BlueMap.jar
• delete the <webroot>/index.html to update your webapp

Changelog since 4.0

• Added animated textures
• Added more cache-control headers to integrated webserver and sql.php
• Updated ru translation (thanks to @NikitaCartes)
• Fixed NullPointerException ("level.heightmaps" is null) that can occur when loading chunks
• Fixed self-suppression exception that can occur when loading chunks
• Fixed paper-implementation not detecting additional (multiverse) worlds correctly
• Fixed map-hires tiles sometimes not loading in right away when opening a map

Targets:

Java: 11
BlueMapAPI: 2.7.0

File	Target Version
BlueMap-4.1-cli.jar	CLI for Minecraft 1.13.2 - 1.20.4
BlueMap-4.1-spigot.jar	Spigot/Paper 1.13.2 - 1.20.4
BlueMap-4.1-paper.jar	Paper/Folia 1.20.1 - 1.20.4
BlueMap-4.1-fabric-1.20.jar	Fabric 1.20 - 1.20.4
BlueMap-4.1-fabric-1.19.4.jar	Fabric 1.19.4
BlueMap-4.1-fabric-1.18.jar	Fabric 1.18 - 1.18.2
BlueMap-4.1-forge-1.20.jar	Forge 1.20 - 1.20.4
BlueMap-4.1-forge-1.19.4.jar	Forge 1.19.4
BlueMap-4.1-forge-1.18.1.jar	Forge 1.18.1 - 1.18.2
BlueMap-4.1-neoforge-1.20.2.jar	NeoForge 1.20.2 - 1.20.4
BlueMap-4.1-sponge.jar	Sponge 8.2.0

Version 4.0 (Snapshot)

Highlights / Notes

New format for the map-data, resulting in a massive performance improvement when loading map-tiles in the browser!

This is a breaking change. You will need to purge and re-render all your maps when you update to this release!
Also don't forget to update your webapp.

!!! This is a SNAPSHOT and is not production-ready! Use at your own risk. !!!

Upgrading from 3.20

• replace your BlueMap.jar
• delete the <webroot>/index.html to update your webapp
• purge all maps

Changelog since 3.20

• 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
• Refactored Chunk-Loading and World management
  • Added dimension config to the map configs
  • Removed world-sky-light config from the map configs
• Lots of performance improvements
• RAM usage improvements
• Added -m option to the cli which allows to specify certain maps that should be rendered
• Removed the pretty-printing from the settings.json to discourage editing it manually
• Logging improvements (thanks to @TechnicJelle)
• Updated Turkish translation (thanks to @birbkeks)
• Updated French translation (thanks to @Arkyoh)
• Updated zh_CN translation (thanks to @jhqwqmc)
• Updated Vite
• Dropped support for fabric 1.15-1.17
• Dropped support for forge 1.17
• Fixed corrupted cave-detection when rendering worlds with custom heights
• Fixed empty block-states having the wrong block-properties
• Fixed some spelling (thanks to @TechnicJelle)
• Fixed an error with self-healing when a textures file is corrupted
• Fixed unlisted markers being counted in the marker-set gui

Targets:

Java: 11
BlueMapAPI: 2.7.0

File	Target Version
BlueMap-4.0-cli.jar	CLI for Minecraft 1.13.2 - 1.20.4
BlueMap-4.0-spigot.jar	Spigot/Paper 1.13.2 - 1.20.4
BlueMap-4.0-paper.jar	Paper/Folia 1.20.1 - 1.20.4
BlueMap-4.0-fabric-1.20.jar	Fabric 1.20 - 1.20.4
BlueMap-4.0-fabric-1.19.4.jar	Fabric 1.19.4
BlueMap-4.0-fabric-1.18.jar	Fabric 1.18 - 1.18.2
BlueMap-4.0-forge-1.20.jar	Forge 1.20 - 1.20.4
BlueMap-4.0-forge-1.19.4.jar	Forge 1.19.4
BlueMap-4.0-forge-1.18.1.jar	Forge 1.18.1 - 1.18.2
BlueMap-4.0-neoforge-1.20.2.jar	NeoForge 1.20.2 - 1.20.4
BlueMap-4.0-sponge.jar	Sponge 8.2.0

Version 3.20

Highlights / Notes

Fixed bug which corrupts the grass-texture when updating from 1.20.2 (or lower) to 1.20.3 (or higher).

Upgrading from 3.18

(skip Version 3.19)

• replace your BlueMap.jar

Changelog since 3.19

• Fixed texture-gallery not preserving textures that are missing after a resource(pack) change

Targets:

Java: 11
BlueMapAPI: 2.6.2

File	Target Version
BlueMap-3.20-cli.jar	CLI for Minecraft 1.13.2 - 1.20.4
BlueMap-3.20-spigot.jar	Spigot/Paper 1.13.2 - 1.20.4
BlueMap-3.20-paper.jar	Paper/Folia 1.20.1 - 1.20.4
BlueMap-3.20-fabric-1.20.jar	Fabric 1.20 - 1.20.4
BlueMap-3.20-fabric-1.19.4.jar	Fabric 1.19.4
BlueMap-3.20-fabric-1.18.jar	Fabric 1.18 - 1.18.2
BlueMap-3.20-fabric-1.17.jar	Fabric 1.17 - 1.17.1
BlueMap-3.20-fabric-1.16.2.jar	Fabric 1.16.2 - 1.16.5
BlueMap-3.20-fabric-1.15.2.jar	Fabric 1.15.2
BlueMap-3.20-forge-1.20.jar	Forge 1.20 - 1.20.4
BlueMap-3.20-forge-1.19.4.jar	Forge 1.19.4
BlueMap-3.20-forge-1.18.1.jar	Forge 1.18.1 - 1.18.2
BlueMap-3.20-forge-1.17.1.jar	Forge 1.17.1
BlueMap-3.20-neoforge-1.20.2.jar	NeoForge 1.20.2 - 1.20.4
BlueMap-3.20-sponge.jar	Sponge 8.2.0

Version 3.19

Highlights / Notes

Added 1.20.3 and NeoForge support.

Upgrading from 3.18

• replace your BlueMap.jar

Changelog since 3.18

• Added 1.20.3 resources
• Added a NeoForge implementation
• Added PostgreSQL support to the built-in php-script for external webservers (Thanks to @AlbusRex, #486)
• Fixed an issue with calculating the average-color if the image-format is a specific grayscale format
• Fixed the key-size issues on some databases (for real now)

Targets:

Java: 11
BlueMapAPI: 2.6.2

File	Target Version
BlueMap-3.19-cli.jar	CLI for Minecraft 1.13.2 - 1.20.4
BlueMap-3.19-spigot.jar	Spigot/Paper 1.13.2 - 1.20.4
BlueMap-3.19-paper.jar	Paper/Folia 1.20.1 - 1.20.4
BlueMap-3.19-fabric-1.20.jar	Fabric 1.20 - 1.20.4
BlueMap-3.19-fabric-1.19.4.jar	Fabric 1.19.4
BlueMap-3.19-fabric-1.18.jar	Fabric 1.18 - 1.18.2
BlueMap-3.19-fabric-1.17.jar	Fabric 1.17 - 1.17.1
BlueMap-3.19-fabric-1.16.2.jar	Fabric 1.16.2 - 1.16.5
BlueMap-3.19-fabric-1.15.2.jar	Fabric 1.15.2
BlueMap-3.19-forge-1.20.jar	Forge 1.20 - 1.20.4
BlueMap-3.19-forge-1.19.4.jar	Forge 1.19.4
BlueMap-3.19-forge-1.18.1.jar	Forge 1.18.1 - 1.18.2
BlueMap-3.19-forge-1.17.1.jar	Forge 1.17.1
BlueMap-3.19-neoforge-1.20.2.jar	NeoForge 1.20.2 - 1.20.4
BlueMap-3.19-sponge.jar	Sponge 8.2.0

Version 3.18

Highlights / Notes

There is now a configurable void (background) color for each map!

Upgrading from 3.17

• replace your BlueMap.jar
• delete your <webroot>/index.html (usually ./bluemap/web/index.html) to update the webapp

Changelog since 3.17

• added a config to set the void (background) color of a map (Thanks to @TechnicJelle, #477)
• the webapp now slows down the redraw frequency if nothing is changing -> no more high GPU usage while the webapp is open but idle
• migrated some mixins to use FabricAPI instead to improve version-compatibility (Thanks to @NikitaCartes, #481)
• added a fixed collation the mysql table-creation to avoid collation related problems (#488)
• fixed the free-flight-option not being removed form the settings menu if disabled (#482)
• fixed an issue with block-properties not being loaded correctly from resource-packs
• fixed a (harmless) error in the paper-implementation that could occur on certain player-chat messages
• fixed the position-url anchor not being loaded correctly if in free-flight mode (#485)
• fixed an error when a map is purged that has already been fully purged (#490)

Targets:

Java: 11
BlueMapAPI: 2.6.2

File	Target Version
BlueMap-3.18-cli.jar	CLI for Minecraft 1.13.2 - 1.20.2
BlueMap-3.18-spigot.jar	Spigot/Paper 1.13.2 - 1.20.2
BlueMap-3.18-paper.jar	Paper/Folia 1.20.1 - 1.20.2
BlueMap-3.18-fabric-1.20.jar	Fabric 1.20 - 1.20.2
BlueMap-3.18-fabric-1.19.4.jar	Fabric 1.19.4
BlueMap-3.18-fabric-1.18.jar	Fabric 1.18 - 1.18.2
BlueMap-3.18-fabric-1.17.jar	Fabric 1.17 - 1.17.1
BlueMap-3.18-fabric-1.16.2.jar	Fabric 1.16.2 - 1.16.5
BlueMap-3.18-fabric-1.15.2.jar	Fabric 1.15.2
BlueMap-3.18-forge-1.20.jar	Forge 1.20 - 1.20.2
BlueMap-3.18-forge-1.19.4.jar	Forge 1.19.4
BlueMap-3.18-forge-1.18.1.jar	Forge 1.18.1 - 1.18.2
BlueMap-3.18-forge-1.17.1.jar	Forge 1.17.1
BlueMap-3.18-sponge.jar	Sponge 8.2.0

Version 3.17

Highlights / Notes

Full 1.20.2 support and some small tweaks and fixes.

Upgrading from 3.16

• Replace your BlueMap.jar

Changelog since 3.16

• Added fabric 1.20.2 implementation (Thanks to @NikitaCartes)
• Added normal PaperAPI support to Folia-implementation
• Improved console-out on paper/folia implementation (now supports colors)
• Improved webserver binding message when binging to the '0.0.0.0' wildcard (Thanks to @TechnicJelle)
• Updated Traditional Chinese (zh_tw) localization (Thanks to @TWME-TW)
• Updated Gradle Version (Thanks to @NikitaCartes)
• Fix tall non-animated textures getting cut off (Thanks to @YuRaNnNzZZ)

Targets:

Java: 11
BlueMapAPI: 2.6.1

File	Target Version
BlueMap-3.17-cli.jar	CLI for Minecraft 1.13.2 - 1.20.2
BlueMap-3.17-spigot.jar	Spigot/Paper 1.13.2 - 1.20.2
BlueMap-3.17-paper.jar	Paper/Folia 1.20.1 - 1.20.2
BlueMap-3.17-fabric-1.20.2.jar	Fabric 1.20.2
BlueMap-3.17-fabric-1.20.jar	Fabric 1.20 - 1.20.1
BlueMap-3.17-fabric-1.19.4.jar	Fabric 1.19.4
BlueMap-3.17-fabric-1.18.jar	Fabric 1.18 - 1.18.2
BlueMap-3.17-fabric-1.17.jar	Fabric 1.17 - 1.17.1
BlueMap-3.17-fabric-1.16.2.jar	Fabric 1.16.2 - 1.16.5
BlueMap-3.17-fabric-1.15.2.jar	Fabric 1.15.2
BlueMap-3.17-forge-1.20.jar	Forge 1.20 - 1.20.2
BlueMap-3.17-forge-1.19.4.jar	Forge 1.19.4
BlueMap-3.17-forge-1.18.1.jar	Forge 1.18.1 - 1.18.2
BlueMap-3.17-forge-1.17.1.jar	Forge 1.17.1
BlueMap-3.17-sponge-8.0.0.jar	Sponge 8.0.0
BlueMap-3.17-sponge-9.0.0.jar	Sponge 9.0.0

Version 3.16

Highlights / Notes

Fixed a major webapp-bug that got introduced in 3.15.
(-> I added a missing ? somewhere ^-^)

But since you are probably coming from 3.14 or eariler:
We have now support for POSTGRES and SQLITE! :)

Upgrading from 3.15 or 3.14

• Replace your BlueMap.jar
• Delete your <webroot>/index.html (usually ./bluemap/web/index.html) so BlueMap updates the webapp!

Changelog since 3.15

• Fixed a bug that made the webapp unusable with multiple maps when player-markers are disabled

Changelog since 3.14

• Added support for postgres databases (Thanks to @mrsolarius, #443)
• Added support for sqlite storages (#322)
• Added "latest render" times to the /bluemap and /bluemap maps commands
• Added advanced logging-options to core.conf and webserver.conf
• Marker-Sets now remember when you hide/show them
• Added abillity to use the "follow-player" feature in first-person mode
• Expose more JS-Classes on the webapp to make it easier for custom js-scripts to modify the webapp (Thanks to @Chicken, #449)
• Improve Error-Messages when the port is already occupied (Thanks to @TechnicJelle, #440)
• Default config files now generate with forward-slashes as their path/file-separator whenever possible
• The webapp no longer resets the camera when pressing the update-map button
• Added default-to-flat-view option to the webapp.conf
• Added support for c2me-uncompressed chunks
• Added Vietnamese translation (Thanks to @hUwUtao, #448)
• Updated Dutch translation (Thanks to @TechnicJelle, #453)
• Fixed support for 1.13.2 worlds
• Fixed the command-permission for deleting a map from a storage
• Fixed the default plugin.conf having map-update-interval instead of the correct full-update-interval
• Fixed the PlayerSkinProvider not being available to the API when player-markers are disabled
• Fixed some webfiles not being written in the corrrect charset
• Fixed markers not being removed correctly when switching maps (#430)
• Fixed mobile forst-person controls not being displayed (#447)
• Fixed jumping to players in a different world not working
• Fixed scrolling with the mouse on a POI-marker doesn't zoom (#409)
• Fixed webapp keeps moving when the window looses focus while a move-key is pressed (#408)
• Fixed some markers overlapping the webapp-menu when there are more then 100 poi/html markers on the map
• Fixed markers being selectable

Targets:

Java: 11
BlueMapAPI: 2.6.0

File	Target Version
BlueMap-3.16-cli.jar	CLI for Minecraft 1.13.2 - 1.20.2
BlueMap-3.16-sponge-8.0.0.jar	Sponge 8.0.0
BlueMap-3.16-sponge-9.0.0.jar	Sponge 9.0.0
BlueMap-3.16-spigot.jar	Spigot/Paper 1.13.2 - 1.20.2
BlueMap-3.16-folia.jar	Folia 1.19.4 - 1.20.2
BlueMap-3.16-fabric-1.20.jar	Fabric 1.20 - 1.20.1
BlueMap-3.16-fabric-1.19.4.jar	Fabric 1.19.4
BlueMap-3.16-fabric-1.18.jar	Fabric 1.18 - 1.18.2
BlueMap-3.16-fabric-1.17.jar	Fabric 1.17 - 1.17.1
BlueMap-3.16-fabric-1.16.2.jar	Fabric 1.16.2 - 1.16.5
BlueMap-3.16-fabric-1.15.2.jar	Fabric 1.15.2
BlueMap-3.16-forge-1.20.jar	Forge 1.20 - 1.20.2
BlueMap-3.16-forge-1.19.4.jar	Forge 1.19.4
BlueMap-3.16-forge-1.18.1.jar	Forge 1.18.1 - 1.18.2
BlueMap-3.16-forge-1.17.1.jar	Forge 1.17.1
BlueMap-3.16-forge-1.16.5.jar	Forge 1.16.5

Version 3.15

Highlights / Notes

Added support for POSTGRES and SQLITE :)
(And fixed some bugs)

Upgrading from 3.14

• Replace your BlueMap.jar
• Delete your <webroot>/index.html (usually ./bluemap/web/index.html) so BlueMap updates the webapp!

Changelog since 3.14

• Added support for postgres databases (Thanks to @mrsolarius, #443)
• Added support for sqlite storages (#322)
• Added "latest render" times to the /bluemap and /bluemap maps commands
• Added advanced logging-options to core.conf and webserver.conf
• Marker-Sets now remember when you hide/show them
• Added abillity to use the "follow-player" feature in first-person mode
• Expose more JS-Classes on the webapp to make it easier for custom js-scripts to modify the webapp (Thanks to @Chicken, #449)
• Improve Error-Messages when the port is already occupied (Thanks to @TechnicJelle, #440)
• Default config files now generate with forward-slashes as their path/file-separator whenever possible
• The webapp no longer resets the camera when pressing the update-map button
• Added default-to-flat-view option to the webapp.conf
• Added support for c2me-uncompressed chunks
• Added Vietnamese translation (Thanks to @hUwUtao, #448)
• Updated Dutch translation (Thanks to @TechnicJelle, #453)
• Fixed support for 1.13.2 worlds
• Fixed the command-permission for deleting a map from a storage
• Fixed the default plugin.conf having map-update-interval instead of the correct full-update-interval
• Fixed the PlayerSkinProvider not being available to the API when player-markers are disabled
• Fixed some webfiles not being written in the corrrect charset
• Fixed markers not being removed correctly when switching maps (#430)
• Fixed mobile forst-person controls not being displayed (#447)
• Fixed jumping to players in a different world not working
• Fixed scrolling with the mouse on a POI-marker doesn't zoom (#409)
• Fixed webapp keeps moving when the window looses focus while a move-key is pressed (#408)
• Fixed some markers overlapping the webapp-menu when there are more then 100 poi/html markers on the map
• Fixed markers being selectable

Targets:

Java: 11
BlueMapAPI: 2.6.0

File	Target Version
BlueMap-3.15-cli.jar	CLI for Minecraft 1.13.2 - 1.20.1
BlueMap-3.15-sponge-8.0.0.jar	Sponge 8.0.0
BlueMap-3.15-sponge-9.0.0.jar	Sponge 9.0.0
BlueMap-3.15-spigot.jar	Spigot/Paper 1.13.2 - 1.20.1
BlueMap-3.15-folia.jar	Folia 1.19.4 - 1.20.1
BlueMap-3.15-fabric-1.20.jar	Fabric 1.20 - 1.20.1
BlueMap-3.15-fabric-1.19.4.jar	Fabric 1.19.4
BlueMap-3.15-fabric-1.18.jar	Fabric 1.18 - 1.18.2
BlueMap-3.15-fabric-1.17.jar	Fabric 1.17 - 1.17.1
BlueMap-3.15-fabric-1.16.2.jar	Fabric 1.16.2 - 1.16.5
BlueMap-3.15-fabric-1.15.2.jar	Fabric 1.15.2
BlueMap-3.15-forge-1.20.jar	Forge 1.20 - 1.20.1
BlueMap-3.15-forge-1.19.4.jar	Forge 1.19.4
BlueMap-3.15-forge-1.18.1.jar	Forge 1.18.1 - 1.18.2
BlueMap-3.15-forge-1.17.1.jar	Forge 1.17.1
BlueMap-3.15-forge-1.16.5.jar	Forge 1.16.5

Version 3.14

Highlights / Notes

Added Minecraft 1.20 support.

Upgrading from 3.13

• replace your BlueMap.jar

Changelog since 3.13

• Added support for Minecraft 1.20 worlds
• Added fabric 1.20 implementation
• Added forge 1.20 implementation
• Added support for the .linear region-format (thanks to @kugge, #418)
• Added /bluemap storages command which lists all available (configured) storages
• Added /bluemap storages <storage> command which lists all (loaded and unloaded) maps on that storage
• Added /bluemap storages <storage> delete <map> which can be used to delete an unloaded map from a storage (beta)
• Added a -V or --version flag to the cli, which shows the current bluemap-version (thanks to @Chicken, #414)
• Added thai-translation (thanks to @MidnightTale, #412)
• Updated french-translation (thanks to @kugge, #410 & #411)
• Improved threading and moved /bluemap (status-command) execution to a separate thread
• Implement BlueMapAPI version 2.5.1
• Fixed an issue where BlueMap could use outdated/cached chunks to render an update
• Fixed rendering starting before the API is initialized (thanks to @Chicken, #425)
• Fixed an error with player-updates on Folia

Targets:

Java: 11
BlueMapAPI: 2.5.1

File	Target Version
BlueMap-3.14-cli.jar	CLI for Minecraft 1.13.2 - 1.20.1
BlueMap-3.14-sponge-8.0.0.jar	Sponge 8.0.0
BlueMap-3.14-sponge-9.0.0.jar	Sponge 9.0.0
BlueMap-3.14-spigot.jar	Spigot/Paper 1.13.2 - 1.20.1
BlueMap-3.14-folia.jar	Folia 1.19.4 - 1.20.1
BlueMap-3.14-fabric-1.20.jar	Fabric 1.20 - 1.20.1
BlueMap-3.14-fabric-1.19.4.jar	Fabric 1.19.4
BlueMap-3.14-fabric-1.18.jar	Fabric 1.18 - 1.18.2
BlueMap-3.14-fabric-1.17.jar	Fabric 1.17 - 1.17.1
BlueMap-3.14-fabric-1.16.2.jar	Fabric 1.16.2 - 1.16.5
BlueMap-3.14-fabric-1.15.2.jar	Fabric 1.15.2
BlueMap-3.14-forge-1.20.jar	Forge 1.20 - 1.20.1
BlueMap-3.14-forge-1.19.4.jar	Forge 1.19.4
BlueMap-3.14-forge-1.18.1.jar	Forge 1.18.1 - 1.18.2
BlueMap-3.14-forge-1.17.1.jar	Forge 1.17.1
BlueMap-3.14-forge-1.16.5.jar	Forge 1.16.5

Version 3.13

Highlights / Notes

Adding folia support .. (just because we can :p)
And fixing some small things :)

Upgrading from 3.12

• replace your BlueMap.jar
• delete your <webroot>/index.html so bluemap updates your webapp

Changelog since 3.12

• Added folia implementation
• Added forge 1.19.4 implementation
• Fixed error when purging maps on an sql-storage
• Fixed block-tint for cherry-leaves
• Fixed error on loading some resource-packs
• Fixed clicking on blocks doesn't work far away from 0/0
• Fixed a camera issue when the map-ground is below 0

Targets:

Java: 11
BlueMapAPI: 2.5.0

File	Target Version
BlueMap-3.13-cli.jar	CLI for Minecraft 1.13.2 - 1.19.4
BlueMap-3.13-sponge-8.0.0.jar	Sponge 8.0.0
BlueMap-3.13-sponge-9.0.0.jar	Sponge 9.0.0
BlueMap-3.13-spigot.jar	Spigot/Paper 1.13.2 - 1.19.4
BlueMap-3.13-folia.jar	Folia 1.19.4
BlueMap-3.13-fabric-1.19.4.jar	Fabric 1.19.4
BlueMap-3.13-fabric-1.19.3.jar	Fabric 1.19.3
BlueMap-3.13-fabric-1.19.jar	Fabric 1.19 - 1.19.2
BlueMap-3.13-fabric-1.18.jar	Fabric 1.18 - 1.18.2
BlueMap-3.13-fabric-1.17.jar	Fabric 1.17 - 1.17.1
BlueMap-3.13-fabric-1.16.2.jar	Fabric 1.16.2 - 1.16.5
BlueMap-3.13-fabric-1.15.2.jar	Fabric 1.15.2
BlueMap-3.13-forge-1.19.4.jar	Forge 1.19.4
BlueMap-3.13-forge-1.19.3.jar	Forge 1.19.3
BlueMap-3.13-forge-1.19.1.jar	Forge 1.19.1 - 1.19.2
BlueMap-3.13-forge-1.18.1.jar	Forge 1.18.1 - 1.18.2
BlueMap-3.13-forge-1.17.1.jar	Forge 1.17.1
BlueMap-3.13-forge-1.16.5.jar	Forge 1.16.5