PathGuide

插件

· 作者 Erotoro

适用于原版 SMP 服务器的地标导航:无需传送,指南针、动作栏和您的双脚。Paper Folia 1.21 至 26.1.2

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

最新 1.0.0 · 26.1.2 · Folia / Paper

一键开服(送7天)

? PathGuide

原版+ 生存服的地标导航 | Paper · Folia · 1.21–26.1.2


你的指南针知道方向。你只需要行走。

PathGuide 是一款适用于 Paper、Spigot 和 Folia 服务器的轻量级地标导航插件。玩家可以创建命名的航点,互相分享,并使用指南针和操作栏进行导航——没有传送,没有小地图,也没有捷径。

无需客户端模组。无重型依赖。只需放入 jar 包即可运行。


✨ 为什么选择 PathGuide?

大多数航点插件会给予玩家一个传送按钮并称之为导航。PathGuide 并非如此。它是为原版+ SMP 服务器构建的,在这些服务器中,距离是游戏的一部分,探索具有意义。

唯一一款围绕“抵达过程本身很重要”这一理念构建的地标插件。


? 核心功能

指南针 + 操作栏引导 指南针指向你的目标。操作栏显示方向和距离,每刻更新。无需 HUD 模组,无需客户端要求——纯粹的原版机制发挥实际作用。

通过告示牌创建地标 在第一行放置带有 [Landmark] 的告示牌,第二行输入名称。完成。该位置即注册为地标。破坏告示牌——地标即被移除。感觉就像世界本身就是界面。

公共与私有地标 公共地标对服务器上的每位玩家可见且可导航。私有地标仅属于其创建者。两者存在于同一系统中,并在每种可见性层级内严格执行名称唯一性。

一条命令分享地标 /path share <name> <player> 向目标玩家发送聊天中的可点击消息。单击即可开始导航。无需坐标,无需复制粘贴,无需外部工具。

导航至坐标 /path goto <x> <z> 开始对原始坐标进行指南针导航,而无需创建地标。适用于一次性目的地。到达检测基于水平面——忽略 Y 坐标。

导航回你的最后死亡地点 /path death 将你指回死亡的位置。无需墓碑插件,无需灵魂宝石——只有指南针和对发生在那里的事情的回忆。

分页地标列表 /path list 显示所有可访问的地标,带有悬停卡片和一键导航。每个条目均可交互。


⚖️ 平衡性与哲学

PathGuide 有四个不可配置的硬性约束:

禁止传送 该插件永远不会移动玩家。永远不。导航在玩家步行到达时结束。

无经济系统 创建、分享和导航到地标的行为免费。无插件货币,无成本系统。

无小地图 PathGuide 不渲染任何地图或覆盖层。操作栏中的方向和距离就是全部的视觉界面。

无 GUI 所有交互都通过命令、聊天和告示牌进行。无库存屏幕,无箱子菜单。

这些是产品决策,而非缺失的功能。


? 导航生命周期

玩家运行 /path find <name>(或 /path goto, /path death)
    │
    ├─ 权限检查
    ├─ 地标或目标解析
    ├─ 访问检查(公共 / 自己的私有)
    │
    ├─ 导航会话开始
    │       ├─ 指南针目标更新
    │       └─ 操作栏:方向箭头 + 以方块为单位的距离
    │
    ├─ 每刻实时更新:
    │       ├─ 世界和目标验证
    │       ├─ 距离 + 方向重新计算
    │       └─ 操作栏重新渲染
    │
    └─ 会话在以下情况下自动结束:
            ├─ 在配置半径内到达
            ├─ 手动执行 /path stop
            ├─ 导航期间地标被删除
            ├─ 玩家登出
            └─ 世界切换(如果已配置)

⚙️ 配置

config.yml — 点击展开
general:
  locale: en                        # en · ru · ua
  chat-prefix-enabled: true
  update-notifications-enabled: true

storage:
  type: SQLITE                      # 仅支持 SQLITE(MySQL 尚未实现)

landmarks:
  creation:
    sign-registration-enabled: true
    private-landmarks-enabled: true
    command-default-visibility: PRIVATE
    sign-default-visibility: PUBLIC
    max-landmarks-per-player: 100

  naming:
    min-length: 3
    max-length: 32
    max-words: 1                    # 仅限单字名称
    max-word-length: 16
    allowed-characters: "^[a-zA-Z0-9_\\-']+$"

  signs:
    header:
      - "[Landmark]"

  listing:
    page-size: 10
    clickable-list-enabled: true
    hover-details-enabled: true

  markers:
    unregister-on-marker-break: true

  worlds:
    blocked-for-creation: []
    blocked-for-navigation-target: []

navigation:
  compass-enabled: true
  action-bar-enabled: true
  update-interval-ticks: 20
  arrival-radius: 6.0
  stop-on-world-change: true

? 命令与权限

命令 权限 默认值 描述
/path find <name> pathguide.find everyone 开始导航至地标
/path stop pathguide.find everyone 取消当前活动导航
/path list [page] pathguide.list everyone 浏览可访问的地标
/path info <name> pathguide.info everyone 查看地标详情
/path goto <x> <z> pathguide.goto op 导航至坐标
/path death pathguide.death op 导航至上一次死亡位置
/path create <name> pathguide.create op 创建地标
/path remove <name> pathguide.remove.own op 移除自己的地标
/path rename <old> <new> pathguide.rename.own op 重命名自己的地标
/path privacy <name> <public|private> pathguide.privacy.own op 更改地标可见性
/path share <name> <player> pathguide.share op 向玩家发送导航链接
/pathadmin reload pathguide.admin op 热重载所有服务
/pathadmin remove <name> pathguide.admin op 管理员移除任意地标
/pathadmin inspect <name> pathguide.admin op 检查地标所有权
/pathadmin updates pathguide.admin.update op 检查插件更新

别名: /pg · /guide · /paths · /landmarks → 均指向 /path


? 本地化

内置翻译:English、Russian、Ukrainian

语言文件位于 plugins/PathGuide/lang/,可自由编辑。在 config.yml 的 general.locale 下切换语言。


? 完美适用于

  • Vanilla+ SMP 服务器 — 尊重生存体验的导航功能
  • 探索型服务器 — 距离保持真实,发现需靠努力获得
  • 角色扮演(RP)服务器 — 命名地标构建生动的地理风貌
  • Folia 服务器 — 开箱即用,完全支持区域线程兼容性
  • 任何希望提升生活质量而不破坏沉浸感的服务器

? 要求

  • 服务端: Paper、Spigot 或 Folia
  • Java: 21+(运行 26.1.x 的服务端需 Java 25+)
  • Minecraft: 1.21 – 26.1.2

为现代服务器打造。通过 112 项单元测试。零传送。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源