Version 2.2 (Snapshot)

Highlights / Notes

Small fixes and improvements

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

Upgrading from 2.1

Just replace your BlueMap.jar

Changelog since 2.1

• Improve world-id handling
• Improve version-detection on Forge and Fabric
• Fix fabric-1.19 using the wrong resources
• Fix forge commands not working on mohist and arclight

Targets:

BlueMapAPI: 2.1.0

File	Target Version
BlueMap-2.2-cli.jar	CLI for Minecraft 1.13.2 - 1.19.1
BlueMap-2.2-sponge-8.0.0.jar	Sponge 8.0.0
BlueMap-2.2-sponge-9.0.0.jar	Sponge 9.0.0
BlueMap-2.2-spigot.jar	Spigot/Paper 1.13.2 - 1.19.1
BlueMap-2.2-fabric-1.19.jar	Fabric 1.19 - 1.19.1
BlueMap-2.2-fabric-1.18.jar	Fabric 1.18 - 1.18
BlueMap-2.2-fabric-1.17.jar	Fabric 1.17 - 1.17.1
BlueMap-2.2-forge-1.19.1.jar	Forge 1.19.1 (1.19.1-42.0.1)
BlueMap-2.2-forge-1.19.jar	Forge 1.19 (1.19-41.0.16)
BlueMap-2.2-forge-1.18.1.jar	Forge 1.18.1 (1.18.1-39.0.58)
BlueMap-2.2-forge-1.17.1.jar	Forge 1.17.1 (1.17.1-37.0.109)

Version 2.1 (Snapshot)

Highlights / Notes

• Added the possibillity to register external or static maps, so the internal webserver finds them
• Forge 1.19.1 Support

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

Upgrading from 2.0

Just replace your BlueMap.jar

Changelog since 2.0

• Add a way to register externally rendered or static maps without a world
• Added support for forge 1.19.1
• The API can now find worlds from a world-key in form of a String (thanks to @pop4959)

Targets:

BlueMapAPI: 2.0.0

File	Target Version
BlueMap-2.1-cli.jar	CLI for Minecraft 1.13.2 - 1.19.1
BlueMap-2.1-sponge-8.0.0.jar	Sponge 8.0.0
BlueMap-2.1-sponge-9.0.0.jar	Sponge 9.0.0
BlueMap-2.1-spigot.jar	Spigot/Paper 1.13.2 - 1.19.1
BlueMap-2.1-fabric-1.19.jar	Fabric 1.19 - 1.19.1
BlueMap-2.1-fabric-1.18.jar	Fabric 1.18 - 1.18
BlueMap-2.1-fabric-1.17.jar	Fabric 1.17 - 1.17.1
BlueMap-2.1-forge-1.19.1.jar	Forge 1.19.1 (1.19.1-42.0.1)
BlueMap-2.1-forge-1.19.jar	Forge 1.19 (1.19-41.0.16)
BlueMap-2.1-forge-1.18.1.jar	Forge 1.18.1 (1.18.1-39.0.58)
BlueMap-2.1-forge-1.17.1.jar	Forge 1.17.1 (1.17.1-37.0.109)

Version 2.0 (Snapshot)

Highlights / Notes

• SQL-Support
• Server-Network support
• improved API
• improved resource-loading (loading mods etc.)
• better configs

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

Upgrading from 1.7.3

There were a lot of breaking changes in this Update!
You will need to to a clean installation, and reconfigure BlueMap!

Yes, you will need to re-render all your maps if you want to update. Sorry! :(

Steps (assuming the usual bluemap setup):

• stop your server
• make a Backup!!
• delete the entire ./bluemap folder
• delete all of bluemap's config files (./plugins/BlueMap or ./config/bluemap)
• replace your bluemap.jar with the new one from this release
• start your server
• (re-)configure bluemap using the newly generated config-files
• reload bluemap with /bluemap reload

Changelog since 1.7.3

• Added support for storing maps on a MySQL or MariaDB database
• Completely reworked Resource-Loading (Loading a lot of mods with bluemap should be up to 60x as fast now)
• Added option to automatically find and load mods and datapacks from the server-files
• Completely reorganized the config-files
• Reworked internal config-management and config-templates
• Reworked the data-structure of maps -> Server-Network support
• Updated BlueMapAPI to Version 2.0.0
• Added support for Forge 1.19, Fabric 1.19 and SpongeAPI 9.0.0
• Added support for fabric-permissions-api (thanks to NikitaCartes)
• Changed the data-format of Map-Tiles to prepare for future features
• Changed base Java-Version to Java 11
• Reorganized build-scripts
• Fixed the "ClassNotFound: RemovalCause" error (for real now, hopefully)
• Fixed falsely considering regions outside of the defined render-boundaries

Targets:

BlueMapAPI: 2.0.0

File	Target Version
BlueMap-2.0-cli.jar	CLI for Minecraft 1.13.2 - 1.19
BlueMap-2.0-sponge-8.0.0.jar	Sponge 8.0.0
BlueMap-2.0-sponge-9.0.0.jar	Sponge 9.0.0
BlueMap-2.0-spigot.jar	Spigot/Paper 1.13.2 - 1.19.1
BlueMap-2.0-fabric-1.19.jar	Fabric 1.19 - 1.19.1
BlueMap-2.0-fabric-1.18.jar	Fabric 1.18 - 1.18
BlueMap-2.0-fabric-1.17.jar	Fabric 1.17 - 1.17.1
BlueMap-2.0-fabric-1.16.2.jar	Fabric 1.16.2 - 1.16.5
BlueMap-2.0-forge-1.19.jar	Forge 1.19 (1.19-41.0.16)
BlueMap-2.0-forge-1.18.1.jar	Forge 1.18.1 (1.18.1-39.0.58)
BlueMap-2.0-forge-1.17.1.jar	Forge 1.17.1 (1.17.1-37.0.109)
BlueMap-2.0-forge-1.16.2.jar	Forge 1.16.1 - 1.16.5 (1.16.3-34.0.0)

Version 1.7.3

Highlights / Notes

Added Minecraft 1.19 resources.

Upgrading from 1.7.2

Just replace your bluemap.jar.

Changelog since 1.7.2

• Added minecraft 1.19 resources
• Fixed radius-update not working correctly on worlds with high x/z positions
• Fixed an issue due to a change in SpongeAPI 8.0.0

Targets:

BlueMapAPI: v1.7.0

File	Target Version
BlueMap-1.7.3-cli.jar	CLI for Minecraft 1.13.2 - 1.19.1
BlueMap-1.7.3-sponge-8.0.0.jar	Sponge 8.0.0
BlueMap-1.7.3-spigot.jar	Spigot/Paper 1.13.2 - 1.19.1
BlueMap-1.7.3-fabric-1.18.jar	Fabric 1.18 - 1.19.1
BlueMap-1.7.3-fabric-1.17.jar	Fabric 1.17 - 1.17.1
BlueMap-1.7.3-fabric-1.16.4.jar	Fabric 1.16.2 - 1.16.5
BlueMap-1.7.3-forge-1.19.1.jar	Forge 1.19.1
BlueMap-1.7.3-forge-1.19.jar	Forge 1.19
BlueMap-1.7.3-forge-1.18.1.jar	Forge 1.18.1 (1.18.1-39.0.58)
BlueMap-1.7.3-forge-1.17.1.jar	Forge 1.17.1 (1.17.1-37.0.109)
BlueMap-1.7.3-forge-1.16.4.jar	Forge 1.16.1 - 1.16.5 (1.16.3-34.0.0)

Version 1.7.2

Highlights / Notes

Minecraft 1.18, Spigot/Paper,Fabric 1.18 and Forge 1.17 support.

Upgrading from 1.6.3

Just replace your bluemap.jar.

(delete your <webroot>/index.html id you want bluemap to update your web-app)

Changelog since 1.6.3

• Added support for minecraft 1.18 worlds
• Added support for spigot/paper 1.18 versions
• Added support for fabric 1.18 versions
• Added support for forge 1.17 versions
• Some changes to the internal map-storage handling
• Added Swedish language (thanks to Alexsannd)
• Changed preconfigured ambient-light to 0.1
• Changed some config comments
• Fixed biome-colors for biomes with a humidity of 0 (e.g. savanna)

Targets:

BlueMapAPI: v1.7.0

File	Target Version
BlueMap-1.7.2-cli.jar	CLI for Minecraft 1.13.2 - 1.18.2
BlueMap-1.7.2-sponge-8.0.0.jar	Sponge 8.0.0
BlueMap-1.7.2-spigot.jar	Spigot/Paper 1.13.2 - 1.18.2
BlueMap-1.7.2-fabric-1.18.jar	Fabric 1.18 - 1.18.2
BlueMap-1.7.2-fabric-1.17.jar	Fabric 1.17 - 1.17.1
BlueMap-1.7.2-fabric-1.16.4.jar	Fabric 1.16.2 - 1.16.5
BlueMap-1.7.2-forge-1.17.1.jar	Forge 1.17.1 (1.17.1-37.0.109)
BlueMap-1.7.2-forge-1.16.4.jar	Forge 1.16.1 - 1.16.5 (1.16.3-34.0.0)

Version 1.7.1 (Release-Candidate)

Highlights / Notes

Fixed server-crash on fabric 1.18-pre5 when a player joins

This is a RELEASE-CANDIDATE and is not very well tested yet! Use at your own risk.

Upgrading from 1.7.0

Just replace your bluemap.jar

Changelog since 1.7.0

• Fixed server-crash on fabric 1.18-pre5 when a player joins

Targets:

BlueMapAPI: v1.7.0

File	Target Version
BlueMap-1.7.1-cli.jar	CLI for Minecraft 1.13.2 - 1.18-pre5
BlueMap-1.7.1-sponge-8.0.0.jar	Sponge 8.0.0
BlueMap-1.7.1-spigot.jar	Spigot/Paper 1.13.2 - 1.17.1
BlueMap-1.7.1-fabric-1.18.jar	Fabric 1.18-pre5
BlueMap-1.7.1-fabric-1.17.jar	Fabric 1.17 - 1.17.1
BlueMap-1.7.1-fabric-1.16.4.jar	Fabric 1.16.2 - 1.16.5
BlueMap-1.7.1-forge-1.17.1.jar	Forge 1.17.1 (1.17.1-37.0.109)
BlueMap-1.7.1-forge-1.16.4.jar	Forge 1.16.1 - 1.16.5 (1.16.3-34.0.0)

Version 1.7.0 (Release-Candidate)

Highlights / Notes

Minecraft 1.18, Fabric 1.18 and Forge 1.17 support.

This is a RELEASE-CANDIDATE and is not very well tested yet! Use at your own risk.

Upgrading from 1.6.3

Just replace your bluemap.jar

Changelog since 1.6.3

• Added support for minecraft 1.18 worlds
• Added support for fabric 1.18 versions
• Added support for forge 1.17 versions
• Some changes to the internal map-storage handling
• Fixed biome-colors for biomes with a humidity of 0 (e.g. savanna)

Targets:

BlueMapAPI: v1.7.0

File	Target Version
BlueMap-1.7.0-cli.jar	CLI for Minecraft 1.13.2 - 1.18-pre5
BlueMap-1.7.0-sponge-8.0.0.jar	Sponge 8.0.0
BlueMap-1.7.0-spigot.jar	Spigot/Paper 1.13.2 - 1.17.1
BlueMap-1.7.0-fabric-1.18.jar	Fabric 1.18-pre1
BlueMap-1.7.0-fabric-1.17.jar	Fabric 1.17 - 1.17.1
BlueMap-1.7.0-fabric-1.16.4.jar	Fabric 1.16.2 - 1.16.5
BlueMap-1.7.0-forge-1.17.1.jar	Forge 1.17.1 (1.17.1-37.0.109)
BlueMap-1.7.0-forge-1.16.4.jar	Forge 1.16.1 - 1.16.5 (1.16.3-34.0.0)

Version 1.6.3

Highlights / Notes

Full render-engine overhaul for a performance and RAM/Heap/GC improvement.
Dropped Minecraft 1.12.2 support.
Improved the cave-render system.
Pause render based on the amount of online-players.

Upgrading from 1.5.5

Swap your bluemap.jar.

Delete this file: <webroot>/index.html
(./bluemap/web/index.html)

In your render.conf, for EACH map, do the following:

• Add worldSkyLight: 15 to overworld maps, and worldSkyLight: 0 to nether or end maps
• Replace renderCaves: false with removeCavesBelowY: 10000 or removeCavesBelowY: 55
• Replace renderCaves: true with removeCavesBelowY: -10000

(If it helps, these are the changes made to the default config: 4447c31#diff-c0b4406a56b90fbe446939663d5339aa595ae3fbd7e8d3014e1169a2cc054182)

Add this to your plugin.conf:

# The amount of players that is needed to pause BlueMap's render-threads.
# -> If this amount of players or more is online, bluemap will stop rendering map-updates until enough players
#    have logged off again
# Setting this to 0 or -1 will disable this feature -> bluemap will not pause rendering
# Default is -1
playerRenderLimit: -1

Changelog since 1.5.5

• Changed most immutable vectors to mutable ones
• Improved caching and block/chunk access
• Updated BlueMapAPI to 1.7.0
• Removed Minecraft 1.12.2 support
• Added a config option to define the maximum height to remove caves
• Added a config option to use blocklight instead of sunlight to "detect caves"
• Added a config-option to pause render based on the amount of online-players
• Added a thread-dump to /bluemap debug dump
• Added crimson and warped signs
• Redstone now renders differently based on power-level
• Water and Lava now actually use their flow-texture
• Lowres-colors are now closer to the actual hires block-colors
• Fixed markers not being removed when they should without a page-reload
• Fixed marker-outlines not updated correctly if segments were added to the shape
• Fixed worlds added by a resourcepack not able to be detected on spigot
• Tentative fix for the builtin webserver freezing if there are too many concurrent connections
• Updated for Sponge 8.0.0 API changes

Targets:

BlueMapAPI: v1.7.0

File	Target Version
BlueMap-1.6.3-cli.jar	CLI for Minecraft 1.13.2 - 1.17.1
BlueMap-1.6.3-sponge-8.0.0.jar	Sponge 8.0.0
BlueMap-1.6.3-spigot.jar	Spigot/Paper 1.13.2 - 1.17.1
BlueMap-1.6.3-fabric-1.17.jar	Fabric 1.17 - 1.17.1
BlueMap-1.6.3-fabric-1.16.4.jar	Fabric 1.16.2 - 1.16.5
BlueMap-1.6.3-fabric-1.16.1.jar	Fabric 1.16.1
BlueMap-1.6.3-fabric-1.15.2.jar	Fabric 1.15.2
BlueMap-1.6.3-forge-1.16.4.jar	Forge 1.16.1 - 1.16.5 (1.16.3-34.0.0)
BlueMap-1.6.3-forge-1.15.2.jar	Forge 1.15.2 (1.15.2-31.2.0)
BlueMap-1.6.3-forge-1.14.4.jar	Forge 1.14.4 (1.14.4-28.2.0)

Version 1.6.2 (Release-Candidate)

Highlights / Notes

Bugfixes and a config-option to pause render based on the amount of online-players.

This is a RELEASE-CANDIDATE and is not very well tested yet! Use at your own risk.

Upgrading from 1.6.1

Swap your bluemap.jar and delete your <webroot>/index.html, so your webapp gets updated.

Optionally, you can add this to your plugin.conf:

# The amount of players that is needed to pause BlueMap's render-threads.
# -> If this amount of players or more is online, bluemap will stop rendering map-updates until enough players
#    have logged off again
# Setting this to 0 or -1 will disable this feature -> bluemap will not pause rendering
# Default is -1
playerRenderLimit: -1

Changelog since 1.6.1

• Updated BlueMapAPI to 1.7.0
• Added a config-option to pause render based on the amount of online-players
• Added a thread-dump to /bluemap debug dump
• Further performance-improvements
• Fixed some lowres lighting and coloring issues
• Fixed worlds added by a resourcepack not able to be detected on spigot
• Fixed markers not being removed when they should without a page-reload
• Fixed marker-outlines not updated correctly if segments were added to the shape

Targets:

BlueMapAPI: v1.7.0

File	Target Version
BlueMap-1.6.2-cli.jar	CLI for Minecraft 1.13.2 - 1.17.1
BlueMap-1.6.2-sponge-8.0.0.jar	Sponge 8.0.0
BlueMap-1.6.2-spigot.jar	Spigot/Paper 1.13.2 - 1.17.1
BlueMap-1.6.2-fabric-1.17.jar	Fabric 1.17 - 1.17.1
BlueMap-1.6.2-fabric-1.16.4.jar	Fabric 1.16.2 - 1.16.5
BlueMap-1.6.2-fabric-1.16.1.jar	Fabric 1.16.1
BlueMap-1.6.2-fabric-1.15.2.jar	Fabric 1.15.2
BlueMap-1.6.2-forge-1.16.4.jar	Forge 1.16.1 - 1.16.5 (1.16.3-34.0.0)
BlueMap-1.6.2-forge-1.15.2.jar	Forge 1.15.2 (1.15.2-31.2.0)
BlueMap-1.6.2-forge-1.14.4.jar	Forge 1.14.4 (1.14.4-28.2.0)

Version 1.6.1 (Snapshot)

Highlights / Notes

Fixed lots of bugs that got introduced with 1.6.0 and improved the cave-render system.

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

Upgrading from 1.6.0

First, swap your bluemap.jar.

Then, in your render.conf, for EACH map, do the following:

• Add worldSkyLight: 15 to overworld maps, and worldSkyLight: 0 to nether or end maps
• Replace renderCaves: false with removeCavesBelowY: 10000 or removeCavesBelowY: 55
• Replace renderCaves: true with removeCavesBelowY: -10000

(If it helps, these are the changes made to the default config: 4447c31#diff-c0b4406a56b90fbe446939663d5339aa595ae3fbd7e8d3014e1169a2cc054182)

Changelog since 1.6.0

• Added a config option to define the maximum height to remove caves
• Added a config option to use blocklight instead of sunlight to "detect caves"
• Fixed lowres-lighting in nether and end
• Fixed sometimes rendering bright spots on the nether-ceiling or on end-islands
  (needed to add a config value to fix this)
• Added crimson and warped signs
• Tentative fix for the FileNotFoundExceptions
• Tentative fix for the ClassNotFoundErrors
• Tentative fix for the builtin webserver freezing if there are too many concurrent connections
• Updated for Sponge 8.0.0 API changes

Targets:

BlueMapAPI: v1.6.0

File	Target Version
BlueMap-1.6.1-cli.jar	CLI for Minecraft 1.13.2 - 1.17.1
BlueMap-1.6.1-sponge-8.0.0.jar	Sponge 8.0.0
BlueMap-1.6.1-spigot.jar	Spigot/Paper 1.13.2 - 1.17.1
BlueMap-1.6.1-fabric-1.17.jar	Fabric 1.17 - 1.17.1
BlueMap-1.6.1-fabric-1.16.4.jar	Fabric 1.16.2 - 1.16.5
BlueMap-1.6.1-fabric-1.16.1.jar	Fabric 1.16.1
BlueMap-1.6.1-fabric-1.15.2.jar	Fabric 1.15.2
BlueMap-1.6.1-forge-1.16.4.jar	Forge 1.16.1 - 1.16.5 (1.16.3-34.0.0)
BlueMap-1.6.1-forge-1.15.2.jar	Forge 1.15.2 (1.15.2-31.2.0)
BlueMap-1.6.1-forge-1.14.4.jar	Forge 1.14.4 (1.14.4-28.2.0)