BlueMapPortalMarkers

插件

· 作者 BunkPitch

一个 Paper 插件,为 BlueMap 添加了一个可切换的“下界传送门”图层。该图层会随着传送门的点燃、发现与破坏而自动更新,并在服务器重启后持久保存。

0 本站下载 0 关注 更新于 5 个月前

需要前置:BlueMap

最新 0.3.0 · 26.1.2 · Paper

一键开服(送7天)

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

? 快速开始

  1. 下载最新的 BlueMapPortalMarkers-<version>.jar。
  2. 将其放入服务器的 plugins/ 文件夹中,与 BlueMap 放在一起。
  3. 重启服务器。首次运行时会生成配置文件。
  4. 打开 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 上托管。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源