Skip to main content

Exclude a private area from a BlueMap render and verify existing tiles

Applies to: BlueMap; match the linked maintainer documentation to your installed platform and release.
Documentation checked .

A render mask controls which part of a world BlueMap renders. It is useful for limiting a public map’s scope, but it is not authentication. Already downloaded images and third-party copies cannot be recalled by changing a mask, so plan privacy before publishing sensitive builds.

Work through the change

  1. Record the map ID and the exact horizontal and vertical bounds of the area that should remain public. Back up the map configuration and inspect existing render-mask rules for combined or overlapping shapes.
  2. Read the official mask reference for your BlueMap release. Construct the intended allowed or excluded shape using its documented combination rules, checking boundary coordinates instead of guessing from a zoomed-out map.
  3. Apply the changed map configuration through the supported method. Monitor rendering and removal of tiles outside the new limits, allowing the resulting update work to finish before testing the public page.
  4. Inspect the boundary from several zoom levels and a fresh browser. If edges remain incorrect, review the documented fix-edges control for that map rather than purging every world’s rendered data.

Check the result

The served map should display only the intended footprint after updates complete, with no unexpected cut through a neighbouring public build. Check both low-detail and close-up views. A render mask changes content generation and should not be described as a substitute for access controls on a private map.

Inspect a known coordinate just outside the mask as a negative test. Checking only the public centre proves visibility there but says little about the intended exclusion boundary.

Recover or stop safely

Restore the previous mask configuration if the public area is wrong, then monitor the correction job. Keep private map access restricted while investigating. Do not assume that restoring the old configuration removes previously cached public copies; review web caching and any external storage separately.

For the broader setup, read Set up a BlueMap web map and control rendering load. Check the installed plugin version before applying syntax from the official BlueMap documentation.

No comments to display