Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for BunkPitch

A Paper plugin that adds a toggleable "Nether Portals" layer to BlueMap

Report BlueMapPortalMarkers?

Release
0.4.0

BunkPitch released BlueMapPortalMarkers version 0.4.0 on Today 9:21 PM

[0.4.0] - 2026-06-02

Added

  • Per-world filtering (discovery.worlds.mode = blacklist|whitelist, discovery.worlds.list): restrict portal detection to (or exclude) specific worlds — useful for skipping creative/minigame worlds. Gates all four detection paths and the startup sweep; defaults (blacklist + empty list) track every world, so existing setups are unaffected. Applied live by /bmportals reload. Existing portals in a newly-filtered world stay until /bmportals purge <world>.
  • Marker presentation tuning: markers.min-distance / markers.max-distance (camera-distance visibility range; 0 = always visible), markers.sorting (layer-list order), and markers.label-template (per-marker label with {world}/{x}/{y}/{z} placeholders; empty = default "Nether Portal"). All applied live by /bmportals reload.
  • Background sweeping (discovery.background-sweep.*): an opt-in repeating task that re-sweeps world spawns and a rotating window of online players, so portals in areas players roam into are picked up without a restart. Disabled by default; interval-seconds (min 30) and max-players-per-pass are configurable, and the schedule is re-applied live by /bmportals reload.
  • BlueMap web-app addons (webapp/my-custom-style.css, webapp/my-custom-script.js) and a README section that make the in-popup "Go to linked portal" deep-link actually clickable — BlueMap otherwise leaves links in marker-detail HTML unclickable (inherited pointer-events: none) and suppresses their navigation. The script also works around a BlueMap bug where the popup's "click-away" listener throws after a deep-link switches maps.

Information

Published onJune 6, 2026
Downloads0

Platforms

Paper Paper (1.21, 26.1-26.1.2)

Dependencies

Paper Paper
Edit Plugin Dependencies: Paper