Highlights / Notes
Improvements to SQL-storage (especially SQLite performance), general performance improvements and some fixes.
Upgrading from 5.27
- Replace the
bluemap.jar-file with the new one - Delete your
<webroot>/index.htmlto make bluemap update the webapp - (Optional) Update the
additional-headersin yourwebserver.confto the new defaults:additional-headers: { "Cache-Control": "public, max-age=86400, stale-if-error=604800" "CDN-Cache-Control": "max-age=60" }
- (Optional) Add the following lines to your SQL storage-configs (e.g.
storages/sql.conf):# SQL-statements that are executed once on every new connection to the database. # Leaving this commented out means that BlueMap uses sensible defaults for the used sql-dialect. #connection-init-sql: [ # "PRAGMA journal_mode = WAL" # "PRAGMA synchronous = NORMAL" # "PRAGMA busy_timeout = 30000" # "PRAGMA foreign_keys = ON" #] # The prefix that is prepended to the names of all tables BlueMap creates and uses. # Only lowercase letters (a-z), digits (0-9) and underscores (_) are allowed, with a maximum length of 32 characters. # Changing this value on an existing setup will NOT rename existing tables or move data, BlueMap will create new, empty ones instead. # Default is: "bluemap_" #table-prefix: "bluemap_"
Changelog since 5.27
- Added a
table-prefixoption to the SQL-storage config to change the names of the tables BlueMap uses (#457) - Added a
connection-init-sqloption to the SQL-storage config, and BlueMap now uses sensible defaults for each dialect (e.g. WAL-mode for SQLite) - Changed the default webserver
additional-headersto use the standardCDN-Cache-Controlheader instead ofCloudflare-CDN-Cache-Control(thanks to @w00000dy, #870) - Improved map-update performance by caching render-state data and parsing block-states faster
- Improved compatibility with some filesystems
- Fixed some streams not being closed correctly
- Fixed another issue with loading saved render-tasks
- Fixed the time of the last full map-update not being saved, which could cause early full updates after a restart
- Fixed an error when
full-update-intervalis set to 0 or a negative value - Fixed marker colors being displayed in the wrong color-space
Targets:
Java: 25
BlueMapAPI: 2.8.1
| File | Target Version |
|---|---|
| bluemap-5.28-cli.jar | Minecraft 1.13.2 - 26.3 |
| bluemap-5.28-spigot.jar | Spigot 26.1 - 26.3 (1.20 - 26.3 with Java 25) |
| bluemap-5.28-paper.jar | Paper/Folia 26.1.1 - 26.3 |
| bluemap-5.28-fabric.jar | Fabric 26.1 - 26.3 |
| bluemap-5.28-forge.jar | Forge 26.1 - 26.3 |
| bluemap-5.28-neoforge.jar | NeoForge 26.1 - 26.3 |
| bluemap-5.28-sponge.jar | SpongeAPI 17 - 21 (with Java 25) |