Skip to content

Releases: BlueMap-Minecraft/BlueMap

Version 2.0 (Snapshot)

02 Aug 20:48
d4f0068

Choose a tag to compare

Pre-release

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

07 Jun 16:19
9685d26

Choose a tag to compare

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

30 Nov 22:22
79b6319

Choose a tag to compare

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)

21 Nov 16:14
0f3f8ee

Choose a tag to compare

Pre-release

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)

20 Nov 15:09
23fcab9

Choose a tag to compare

Pre-release

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

30 Sep 22:13
999c148

Choose a tag to compare

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)

19 Sep 19:47
b797887

Choose a tag to compare

Pre-release

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)

14 Sep 15:17
da67ebc

Choose a tag to compare

Pre-release

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)

Version 1.6.0 (Snapshot)

25 Jul 12:07
e178f93

Choose a tag to compare

Pre-release

Highlights / Notes

Full render-engine overhaul for a performance and RAM/Heap/GC improvement.
Dropped Minecraft 1.12.2 support.

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

Upgrading from 1.5.5

Just swap your bluemap.jar.

Changelog since 1.5.5

  • Changed most immutable vectors to mutable ones
  • Improved caching and block/chunk access
  • 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
  • Removed Minecraft 1.12.2 support

Known issues

  • renderEdges config-option does not work as expected (e.g. the nether ceiling is not rendered)
  • sometimes the lowres-colors have some random bright spots

Targets:

BlueMapAPI: v1.6.0

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

Version 1.5.5

25 Jun 15:01
05f8f60

Choose a tag to compare

Highlights / Notes

  • 1.17 support
  • Rewrite of the render-manager and map-updating: map updates are now directly based on file-changes and should be way more reliable now.
  • Sponge 8 support & more

BlueMap will now render automatically, so you do not need to do /bluemap render ... anymore!
Just use /bluemap to see the render-progress :)

Upgrading from 1.4.2

Swap the bluemap.jar and delete your <webroot>/index.html (usually ./bluemap/web/index.html).

After updating, BlueMap will start to completely re-render all your maps once!
Also every map-users web-app settings will be resetted.

Optionally:

  • configure permission changes: bluemap.resume => bluemap.start and bluemap.pause => bluemap.stop
  • In your plugin.conf, add:
# The interval in minutes in which a full map-update will be triggered.
# This is additionally!! to the normal map-update process (in case that fails to detect any file-changes).
# Default is 1440 (24 hours)
fullUpdateInterval: 1440
  • In your render.conf, add:
# If the free-flight-mode in the web-application is enabled or not.
# Default is true
enableFreeFlight: true

Changelog since 1.4.2

  • 1.17 Support
    • Added 1.17 resources (new blocks etc..)
    • Added support for variable world-heights in Minecraft 1.17
    • Added 1.17 support for fabric
  • Improved map-updating
    • Added file-watchers that detect changes in the world-files and update the maps based on those changes
    • Added a .rstate file to each map (./bluemap/web/data/<map>/.rstate)
    • Removed the ./bluemap/rmstate file
    • Added /bluemap update (Use to make bluemap re-check for updates)
    • Renamed /bluemap render to /bluemap force-update to discourage using it
    • Renamed /bluemap resume to /bluemap start (& permission bluemap.resume => bluemap.start)
    • Renamed /bluemap pause to /bluemap stop (& permission bluemap.pause => bluemap.stop)
    • Stopping and starting the render-threads with /bluemap start//bluemap stop now persists across server-restarts
    • Added the -u/--watch flag to the CLI. When using this flag, instead of terminating after the rendering is done, the cli will continue to watch the world-files and update the map as soon as it detects changes.
    • Rewrite of the render-manager
    • Removed world-save, block-change and chunk-save listeners (no longer needed because of file-watchers)
    • Added /bluemap freeze <map-id> which will stop all automatic updates for a specific map
    • Added /bluemap unfreeze <map-id> to reenable automatic map-updates
    • /bluemap maps now shows if a map is frozen
    • Greatly improved /bluemap purge <map-id>
    • Added /bluemap cancel <task-id> which manually cancels a scheduled task
    • Added a file ./bluemap/pluginState.json (contains the state of render-threads and frozen-maps)
  • Miscellaneous
    • Updated to gradle 7.0.2
    • Update BlueMapAPI to 1.6.0
    • Updated configurate-library to version 4.1.1
    • Updated bStats to version 2.2.1
    • Add support for SpongeAPI 8.0.0 (thanks to pschichtel and Faithcaio)
    • SpongeAPI 7.2.0 is supported again (was 7.3.0)
    • Added /bluemap marker list
    • Add /bluemap debug dump which dumps a lot of verbose information of the current state of bluemap in a file.
    • Added a setting to be able to disable the free-flight-mode of the web-app
    • The webapp-menu now closes when entering fullscreen-mode
    • Most of the files are now atomically saved (greatly reduces the possibility of corrupted files after crashes or when viewing the map during a render)
    • The web-app now saves user-settings in their local-storage instead of using cookies (thanks to C0Nd3Mnd)
    • Fixed a bug where BlueMap was rendering unfinished chunks
    • Fixed a bug that caused the ignoreMissingLightData-setting to be always enabled
    • Language updates (thanks to all translaters: https://github.com/BlueMap-Minecraft/BlueMapVue/graphs/contributors <3)

Targets:

BlueMapAPI: v1.6.0

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