BlueMapPortalMarkers
自动在 BlueMap 网页地图上查看每一个下界传送门。
BlueMapPortalMarkers 为 BlueMap 添加了一个可切换的 Nether Portals 图层,并保持与世界状态同步。传送门在被点亮的瞬间出现,随着玩家探索新区域被发现,并在被破坏时消失。无需记忆命令,无需手动编辑标记,也不需要维护坐标电子表格。
✨ 功能特性
- ? BlueMap 中的实时“Nether Portals”图层。 每个传送门都会成为一个可点击的标记。玩家可以从 BlueMap 的标记菜单中一键开启或关闭整个图层。
- ⚡ 自动检测。 通过四种方式收集传送门信息,并合并为一个清晰的列表:
- 新传送门: 当框架被点亮或通过下界配对创建时,立即显示。
- 现有传送门: 通过在启动时对出生点和在线玩家周围进行扫描来发现。
- 漫游覆盖: 随着玩家探索新的区块,静默地补充发现的传送门。
- 已破坏传送门: 当其方块被破坏时自动移除。
- ? 传送门链接(主世界 ↔ 下界)。 每个弹出窗口会根据原版 8:1 的规则显示另一维度的预测对应传送门。如果该对应传送门已经在地图上存在,会出现一个 “前往链接的传送门” 按钮,直接将视角飞向该位置。
- ? 绝不重复。 无论检测到多少次,每个传送门都只会显示为一个标记,不同尺寸的框架也能正确处理。
- ? 重启后持久化。 已发现的传送门会保存到磁盘,并在 BlueMap 重新加载时自动重绘。
- ?️ 管理员命令。 强制执行扫描、查看各世界的传送门数量、清理过期标记,以及在不重启服务器的情况下热重载配置。
- ?️ 高度可配置。 支持按世界过滤、自定义标记图标和标签、可见距离、可选的背景扫描等,大部分设置可通过
/bmportals reload 实时生效。
- ? 轻量级。 检测机制利用 Minecraft 本身已跟踪的数据,因此在繁忙的服务器上也能保持低开销。
? 要求
|
|
| 服务器 |
Paper 26.1+(Spigot 或旧版 Paper 上不可用检测 API) |
| Java |
25+ 运行时环境 |
| 必需插件 |
安装并启用了 BlueMap |
? 快速开始
- 下载最新的
BlueMapPortalMarkers-<version>.jar。
- 将其放入服务器的
plugins/ 文件夹中,与 BlueMap 放在一起。
- 重启服务器。首次运行时会生成配置文件。
- 打开 BlueMap,在标记菜单中切换 Nether Portals 图层。完成!
出生点附近的现有传送门会在首次扫描时显示;其余的会随着玩家漫游而逐渐出现,或者你可以运行 /bmportals sweep 立即进行扫描。
⚙️ 配置亮点
所有配置均位于 plugins/BlueMapPortalMarkers/config.yml。以下是一些常用选项:
markers.label / markers.icon:重命名图层并为其设置自定义图标。
discovery.sweep-radius:启动扫描在出生点和玩家周围覆盖的范围半径。
discovery.worlds:白名单或黑名单世界(跳过创造模式或小游戏世界)。
linking.enabled:开启或关闭主世界↔下界的预测链接功能。
discovery.background-sweep:选择加入定期重新扫描,以保持数据始终新鲜。
? 可点击的 “前往链接的传送门” 深度链接需要对 BlueMap Web 应用进行一次小调整(修改 BlueMap 附带的两个小文件)。其他所有内容(标记、弹出窗口、预测链接文本)无需任何 Web 设置即可工作。请参阅 README 获取三步指南。
? 命令
所有 /bmportals 子命令都需要 bmportals.admin 权限(默认对 OP 开放)。
| 命令 |
功能 |
/bmportals reload |
重新读取配置并实时应用更改 |
/bmportals sweep [radius] |
扫描所有出生点和在线玩家周围区域 |
/bmportals sweep me | <player> | <x> <z> |
扫描特定位置 |
/bmportals stats |
查看总传送门数量及各世界统计 |
/bmportals purge [world] |
清除存储的传送门数据(例如在使用 WorldEdit 移除后) |
⚠️ 注意事项
- 仅限 Paper 26.1.2+。 没有 Spigot 或旧版 Paper 的回退方案。
- 未触碰过的 1.14 之前版本的区域 中的传送门可能不会立即显示,直到游戏加载这些区块。
- 启动扫描仅覆盖出生点和玩家周围的半径范围,而非整个世界。漫游覆盖和后台扫描会随时间逐步填补剩余部分。
? 隐私保护
通过 bStats 提供匿名聚合使用统计数据(配置中的 metrics.enabled,或可在服务器范围内禁用)。绝不会收集任何个人数据或世界数据。
? 开源
BlueMapPortalMarkers 是遵循 GNU GPL v3.0 许可的自由软件。源代码、问题反馈和版本发布均在 GitHub 上托管。
BlueMapPortalMarkers
See every Nether portal on your BlueMap web map, automatically.
BlueMapPortalMarkers adds a toggleable Nether Portals layer to BlueMap and keeps it in sync with your world. Portals appear the moment they're lit, get discovered as players explore, and disappear when broken. No commands to memorize, no manual marker editing, no spreadsheet of coordinates.
✨ Features
- ? A live "Nether Portals" layer in BlueMap. Every portal becomes a clickable marker. Players toggle the whole layer on or off from BlueMap's marker menu.
- ⚡ Automatic detection. Portals are picked up four ways, all merged into one clean list:
- New portals appear instantly when a frame is lit or created by nether-pairing.
- Existing portals are found by a startup sweep around spawn and online players.
- Roaming coverage quietly fills in portals as players explore new chunks.
- Broken portals are removed automatically when their blocks are destroyed.
- ? Portal linking (Overworld ↔ Nether). Each popup shows the predicted counterpart in the other dimension using the vanilla 8:1 rule, and when that counterpart is already on the map, a "Go to linked portal" button flies the viewer straight to it.
- ? No duplicates, ever. However many times a portal is detected, it shows up as exactly one marker, frames of any size are handled correctly.
- ? Persists across restarts. Discovered portals are saved to disk and re-drawn automatically whenever BlueMap reloads.
- ?️ Admin commands. Force a sweep, view per-world portal counts, purge stale markers, and hot-reload settings without restarting the server.
- ?️ Highly configurable. Per-world filtering, custom marker icon and label, visibility distance, optional background sweeping, and more, most of it applied live with
/bmportals reload.
- ? Lightweight. Detection rides on data Minecraft already tracks, so it stays cheap even on busy servers.
? Requirements
|
|
| Server |
Paper 26.1+ (the detection API isn't available on Spigot or older Paper) |
| Java |
25+ runtime |
| Required plugin |
BlueMap installed and enabled |
? Quick start
- Download the latest
BlueMapPortalMarkers-<version>.jar.
- Drop it into your server's
plugins/ folder, alongside BlueMap.
- Restart the server. A config file is created on first run.
- Open BlueMap and toggle the Nether Portals layer in the marker menu. Done!
Existing portals near spawn show up on the first sweep; the rest appear as players roam, or you can run /bmportals sweep to scan immediately.
⚙️ Configuration highlights
Everything lives in plugins/BlueMapPortalMarkers/config.yml. A few favourites:
markers.label / markers.icon: rename the layer and give it a custom icon.
discovery.sweep-radius: how far the startup sweep reaches around spawn and players.
discovery.worlds: whitelist or blacklist worlds (skip creative or minigame worlds).
linking.enabled: turn the Overworld↔Nether predicted-link section on or off.
discovery.background-sweep: opt-in periodic re-sweeping for always-fresh coverage.
? The clickable "Go to linked portal" deep-link needs a one-time BlueMap web-app tweak (two small files BlueMap ships in the box). Everything else (markers, popups, predicted-link text) works with zero web setup. See the README for the 3-step guide.
? Commands
All /bmportals subcommands require the bmportals.admin permission (ops by default).
| Command |
What it does |
/bmportals reload |
Re-read the config and apply it live |
/bmportals sweep [radius] |
Scan around every spawn + online player |
/bmportals sweep me | <player> | <x> <z> |
Scan a specific spot |
/bmportals stats |
Total and per-world portal counts |
/bmportals purge [world] |
Clear stored portals (e.g. after WorldEdit removals) |
⚠️ Good to know
- Paper 26.1.2+ only. There's no Spigot or older-Paper fallback.
- Portals in never-touched pre-1.14 regions may not appear until those chunks are loaded by the game.
- The startup sweep covers a radius around spawn and players, not the entire world. Roaming coverage and background sweeping fill in the rest over time.
? Privacy
Ships with anonymous, aggregate usage stats via bStats (metrics.enabled in the config, or opt out server-wide). No personal or world data is ever collected.
? Open source
BlueMapPortalMarkers is free software under the GNU GPL v3.0. Source, issues, and releases live on GitHub.
评论 0
登录后参与评分
还没有评论,来抢沙发吧