BlueMapPortalMarkers
Keeping track of every Nether portal on a busy Minecraft server can quickly become a headache. Scattered coordinates, forgotten gateways, and the constant need to update a separate map are all too familiar. BlueMapPortalMarkers solves this by adding a dynamic, self-updating Nether Portals layer directly to your BlueMap web map. Once installed, portals appear the moment they are lit, get discovered as players explore, and vanish when broken — all without a single command or manual edit.
Why You Need BlueMapPortalMarkers for Minecraft
BlueMap is already a fantastic way to view your world in a browser, but out of the box it does not highlight Nether portals. BlueMapPortalMarkers fills that gap with a dedicated, toggleable layer. Every portal becomes a clickable marker that shows its Overworld and Nether coordinates, and even predicts the linked counterpart using the vanilla 8:1 rule. When both sides of a portal are on the map, a “Go to linked portal” button lets viewers jump straight to the other dimension. This makes navigation intuitive for players and administration effortless for staff.
Key Features
- Live Nether Portals layer – A clean, toggleable overlay in BlueMap’s marker menu. Players can turn the whole layer on or off at will.
- Automatic detection – Portals are picked up four ways: instant detection when a frame is lit or created by nether travel, a startup sweep around spawn and online players, roaming coverage as players explore new chunks, and automatic removal when portal blocks are broken.
- Smart portal linking – Each popup shows the predicted counterpart in the other dimension. If that counterpart is already mapped, a deep-link button flies the viewer straight to it.
- No duplicates – A portal is always shown as exactly one marker, regardless of how many times it is detected or how large the frame is.
- Persistent storage – Discovered portals are saved to disk and reloaded automatically when BlueMap restarts, so you never lose your data.
- Admin commands – Force a full sweep, view per-world portal counts, purge stale markers, and hot-reload settings without restarting the server.
- Highly configurable – Customize the marker icon, label, visibility distance, per-world filtering, background sweeping, and more. Most changes apply live with
/bmportals reload. - Lightweight performance – Detection rides on data Minecraft already tracks, keeping the plugin cheap even on large servers.
How It Works: Automatic Portal Detection
BlueMapPortalMarkers hooks into Paper’s portal detection API, which means it does not need to scan every block constantly. When a player lights a portal or the game creates a new destination portal in the Nether, the plugin instantly adds a marker. On server start, it sweeps a configurable radius around spawn and all online players to catch existing portals. As players wander, the plugin quietly registers portals in newly loaded chunks. If a portal is destroyed, the marker disappears automatically. This layered approach keeps the map accurate without impacting server performance.
How to Install BlueMapPortalMarkers
Getting started is straightforward. First, ensure your server runs Paper 1.21 or newer (specifically Paper build 26.1.2+) with Java 25+ and that BlueMap is already installed and enabled. Then, download BlueMapPortalMarkers from the official GitHub releases page — look for the latest BlueMapPortalMarkers-<version>.jar file. Drop the JAR into your server’s plugins/ folder alongside BlueMap and restart the server. A default configuration file will be generated automatically. Open your BlueMap web map, find the marker menu, and toggle on the Nether Portals layer. That’s it — existing portals near spawn will appear on the first sweep, and the rest will fill in as players explore.
If you use the foxygame.net launcher, BlueMap Portals integration is even simpler: the foxygame.net launcher’s add-on catalog includes BlueMapPortalMarkers for one-click installation and keeps it updated automatically alongside your server.
Configuration and Commands
All settings live in plugins/BlueMapPortalMarkers/config.yml. You can rename the layer, change the marker icon, adjust the startup sweep radius, whitelist or blacklist specific worlds, and enable periodic background sweeping for always-fresh coverage. The deep-link “Go to linked portal” feature requires a one-time BlueMap web-app tweak using two small files that ship with BlueMap; everything else works with zero web setup.
Admin commands are accessed via /bmportals and require the bmportals.admin permission (granted to ops by default). Key commands include:
/bmportals reload– Re-read the config and apply changes live./bmportals sweep [radius]– Scan around every spawn and online player./bmportals sweep me | <player> | <x> <z>– Scan a specific location./bmportals stats– Show total and per-world portal counts./bmportals purge [world]– Clear stored portals, useful after WorldEdit mass removals.
Compatibility and Requirements
BlueMapPortalMarkers is built exclusively for Paper servers running Minecraft 1.21 or later (Paper 26.1.2+). It does not support Spigot or older Paper builds because it relies on the modern portal detection API. The plugin requires Java 25 or higher. Portals in pre-1.14 chunks that have never been loaded may not appear until a player visits those areas, but roaming coverage and background sweeping will eventually catch them. The plugin also ships with anonymous usage statistics via bStats, which can be disabled in the config or server-wide.
Conclusion
BlueMapPortalMarkers transforms how you visualize and manage Nether portals on your Minecraft server. By automating detection, linking, and cleanup, it eliminates the busywork of manual marker editing and gives every player an intuitive navigation tool. Whether you run a small community server or a large network, this plugin keeps your BlueMap accurate and up-to-date with minimal overhead. Download BlueMapPortalMarkers today and give your world map the portal layer it deserves.