BlueMapPortalMarkers

[0.3.0] - 2026-05-31

The first feature release since launch — admin tooling, dimension linking, metrics, and a real CI/test pipeline.

Added

• /bmportals admin commands (permission bmportals.admin, default OP) for managing the marker layer live, without a restart or hand-editing portals.json:
  • reload — re-read config.yml and apply it on the fly (marker appearance, sweep radius, chunk-scan toggle, debug, linking). Settings that still need a restart (storage.file) are reported.
  • sweep [radius] / sweep me [radius] / sweep <player> [radius] / sweep <x> [y] <z> — force a portal scan. Coordinate sweeps are full-height, so altitude can't cause a miss.
  • stats — total and per-world portal counts.
  • purge [world] — drop stored portals and their markers for one world or all (useful after removing portals with WorldEdit, which doesn't fire a break event).
• Overworld ↔ Nether portal linking: each portal popup shows its predicted counterpart (vanilla 8:1 rule) and, when a matching portal is already known, a clickable BlueMap deep-link to it. Configurable via linking.enabled and linking.search-tolerance.
• Anonymous usage metrics via bStats (metrics.enabled).
• Startup update notifier that checks GitHub Releases and logs a single line when a newer version exists (update-check.enabled); runs off-thread and fails silently when offline.

Changed

• Most configuration options are now hot-reloadable with /bmportals reload instead of requiring a server restart (exception: storage.file).
• The build now shades and relocates bStats into the plugin jar via the Shadow plugin; ./gradlew shadowJar (run by build) produces the distributable.

Internal

• Added a JUnit 5 test suite covering the core domain logic, including the portals.json v0.1→v0.2 migration path.
• Added GitHub Actions CI that builds and tests on every push/PR and publishes the jar to a GitHub Release on v* tags.