Webapp-Config

Info:
When a “default” is mentioned for any option, it is meant that if the option is commented out or removed, that is what BlueMap will use as a fallback.
This may not be the same as the option that is pre-filled-in.

enabled

With this setting you can disable the creation and updating of all web-app related files

Default is true

webroot

The webroot where the web-application files will be created.
Usually this should be set to the same directory like in the webserver.conf!

Default is "bluemap/web"

update-settings-file

Whether the settings.json of the webapp should be updated/synchronized with the current BlueMap settings.

If this is set to false, BlueMap will only add maps to the settings.json, but never remove unknown ones or update other settings.

Disabling this is for example useful if you are running multiple BlueMap instances on the same webroot and don’t want them to overwrite each others’ maps.

Default is true

use-cookies

If the web-application should use cookies to save the configurations of a user.

Default is true

default-to-flat-view

If the webapp will default to flat-view instead of perspective-view.

Default is false

start-location

The default map and camera-location where a user will start after opening the webapp.

This is in form of the “url-anchor”: Open your map in a browser and look at the url; everything after the # is the value for this setting.

Default is “no anchor” → The camera will start with the topmost map and at that map’s starting point.

min-zoom-distance and max-zoom-distance

The minimum (closest) and maximum (furthest) distance (in blocks) that the camera can be from the ground

resolution-default

The default value of the resolution (settings-menu)

Possible values are: 0.5, 1, 2

Default is 1

hires-slider-max, hires-slider-default, and hires-slider-min

The min, max and default values of the hires render-distance slider (settings-menu)

The values are in blocks.

Default is max:500, default:100, and min:0

lowres-slider-max, lowres-slider-default, and lowres-slider-min

The min, max and default values of the lowres render-distance slider (settings-menu)

The values are in blocks.

Default is max:7000, default:2000, and min:500

map-data-root

Here you can specify an alternative base url from where all map data is loaded.

Default is "maps"

live-data-root

Here you can specify an alternative base url from where all live data is loaded.

Default is "maps"

scripts

Here you can add URLs to custom scripts (js) so they will be loaded by the webapp

You can place them somewhere in BlueMap’s webroot and add the (relative) link here

styles

Here you can add URLs to custom styles (css) so they will be loaded by the webapp

You can place them somewhere in BlueMap’s webroot and add the (relative) link here