BlueMap - A 3d-map of your Minecraft worlds view-able in your browser using three.js (WebGL)

A new version has been released for BlueMap, it is available for download here.


Highlights / Notes

Added implementation for forge 26.1 and two small fixes.

Upgrading from 5.17 (or 5.16)

  • Make sure you are using Java 25
  • Replace the bluemap.jar-file with the new one

Changelog since 5.17

  • (Re)Added forge implementation for minecraft 26.1
  • Fixed textures of banners and copper-golems
  • Fixed dockerfile not using the correct java version

Full Changelog

A new version has been released for BlueMap, it is available for download here.


Highlights / Notes

This version fixes two issues caused by a breaking change in the newest Paper builds for 26.1.1.

Upgrading from 5.18

  • Replace the bluemap.jar-file with the new one

Changelog since 5.18

  • Fixed BlueMap generating the wrong world-paths in the default map-configs on the latest paper builds
  • Fixed BlueMap not displaying player-markers on the latest paper builds
  • Fixed worldfolder resolve logic in the spigot implementation to better support the newest paper builds and hybrids

Full Changelog

A new version has been released for BlueMap, it is available for download here.


Highlights / Notes

This version fixes some bugs with the previous release.

Upgrading from 5.19

  • Replace the bluemap.jar-file with the new one

Changelog since 5.19

  • Fixed a bug that caused BlueMap to no longer be able to load worlds with the old (pre 26.1) format
  • Fixed a bug causing some cases of high cpu-usage due to busy-waiting for region-folders to exist
  • Fixed a bug where the webserver is not closing active connections when reloading bluemap
  • Improved debug-dump with some more information

Full Changelog

A new version has been released for BlueMap, it is available for download here.


Highlights / Notes

  • Minecraft 26.2 support
  • Changes to how map-updates are scheduled. Render-Tasks now persist over restarts/reloads

Upgrading from 5.20

  • Replace the bluemap.jar-file with the new one
  • Move the full-update-interval and the update-cooldown settings from your plugin.conf into your core.conf

This update contains some internal changes which might break some BlueMap-Addons that work with custom block-renderers.
→ Make sure to check if your addons need to be updated.

Changelog since 5.20

  • Updated resource-extensions to account for 26.2 bed and sign changes (-> 26.2 support)
  • BlueMap now keeps track of when it last updated which region-file and uses this information to sort it’s update-tasks.
    This makes sure that no matter how slow the update-process is in comparison to the world-changes,
    BlueMap will always have eventually updated each region-file.
  • BlueMap now saves render-tasks and loads them when it restarts or reloads
  • BlueMap no longer updates all maps each time it loads. Instead, it persists the last full-update time
    and schedules full map-updates based on the full-update-interval config
  • Moved update-cooldown and full-update-interval configs from plugin.conf to core.conf
  • Added /bluemap tasks cancel all command to cancel all render-tasks at once
  • Updated API to 2.8.0
  • Reworked block-color calculation, added a registry for addons and
    the ability to configure custom color-map textures in the blockColors.json
  • Re-enabled support for fabric-pemission-api
  • Skin-Profile requests now use the un-dashed UUID format (aligning with mojang-default)
  • Enhanced debug-dump with registry-information
  • Added version information to the debug-log
  • Fixed an issue with paper not loading custom dimension information correctly
  • Fixed skin-download config doing nothing
  • Fixed potential error when trying to load an entity-chunk with a formatted CustomName

Full Changelog

A new version has been released for BlueMap, it is available for download here.


Highlights / Notes

Fix for a map-breaking bug in 5.21: update directly to this version, skip version 5.21!

Upgrading from 5.20 (and 5.21)

  • Replace the bluemap.jar-file with the new one
  • Move the full-update-interval and the update-cooldown settings from your plugin.conf into your core.conf

This update contains some internal changes which might break some BlueMap-Addons that work with custom block-renderers.
→ Make sure to check if your addons need to be updated.

Changelog since 5.21

  • Fixed an issue causing the textures of maps from previous versions to be corrupted

Full Changelog

A new version has been released for BlueMap, it is available for download here.


Highlights / Notes

The integrated webserver now pushes markers and freshly rendered tile-updates to connected webapps using SSE.
And some more fixes and smaller improvements.

Upgrading from 5.22

  • Replace the bluemap.jar-file with the new one
  • Delete your <webroot>/index.html to make bluemap update the webapp

Optionally:

  • Add the following lines to your webserver.conf:
    # Whether to use Server-Sent Events (SSE) for pushing tile and marker-updates to the connected clients.
    # Default is true
    sse-enabled: true
    
  • Add the following lines to your webapp.conf:
    # This will configure the webapp to request the map-tiles compressed and decompress them manually.
    # Enable this only if you intend to host the webapp statically, with an external webserver without additional configuration.
    # Default is "false"
    #client-decompression: true
    

Changelog since 5.22

  • Use Server-sent events to push updates for map-tiles, players, and markers (optional, thanks to @pR0Ps, #819)
  • Added webapp-option to decompress tiles on the client, making it possible to host the webapp statically (thanks to @fechan, #815)
  • No longer delete the whole map if no region-files exist (map might be configured incorrectly)
  • Try to resolve symlinks when loading resources
  • Added (usually hidden) config for dimension-type to fix paper-api added worlds
  • Removed native linear region format support, use the linear-addon instead
  • Track full-update-interval per-map instead of globally
  • Fixed race-condition when saving lowres-tiles sometimes corrupting them (#821)
  • Fixed live-player-markers config not being respected
  • Fixed worlds with / in dimension key not being detected correctly on paper
  • Fixed tasks sometimes not saving/loading correctly
  • Fixed in-memory region-update-timestamps not resetting on purge

Full Changelog