? 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 项单元测试。零传送。
? PathGuide
Landmark Navigation for Vanilla+ SMP | Paper · Folia · 1.21–26.1.2
Your compass knows the way. You just have to walk.
PathGuide is a lightweight landmark navigation plugin for Paper, Spigot, and Folia servers. Players create named waypoints, share them with each other, and navigate using a compass and action bar — no teleports, no minimap, no shortcuts.
No client mods. No heavy dependencies. Just drop the jar and it works.
✨ Why PathGuide?
Most waypoint plugins hand players a teleport button and call it navigation. PathGuide doesn't. It's built for vanilla+ SMP servers where distance is part of the game and exploration means something.
The only landmark plugin built around the idea that getting there matters.
? Core Features
Compass + action bar guidance
The compass points to your target. The action bar shows direction and distance, updated every tick. No HUD mods, no client requirements — pure vanilla mechanics doing real work.
Landmark creation via signs
Place a sign with [Landmark] on the first line and a name on the second. Done. The landmark is registered at that location. Break the sign — the landmark is removed. It feels like the world itself is the interface.
Public and private landmarks
Public landmarks are visible and navigable by every player on the server. Private landmarks belong only to their creator. Both exist in the same system, with strict name uniqueness enforced per visibility tier.
Share a landmark with one command
/path share <name> <player> sends the target player a clickable message in chat. One click starts navigation. No coordinates, no copy-pasting, no external tools.
Navigate to coordinates
/path goto <x> <z> starts compass navigation to raw coordinates without creating a landmark. Useful for one-time destinations. Arrival is detected on the horizontal plane — Y coordinate is ignored.
Navigate to your last death
/path death points you back to where you died. No grave plugins, no soul gems — just a compass and the memory of what happened there.
Paginated landmark list
/path list shows all accessible landmarks with hover cards and one-click navigation. Every entry is interactive.
⚖️ Balance & Philosophy
PathGuide has four hard constraints that are not configurable:
No teleports
The plugin never moves a player. Ever. Navigation ends when the player arrives on foot.
No economy
Creating, sharing, and navigating to landmarks is free. No plugin currency, no cost system.
No minimap
PathGuide does not render any map or overlay. Direction and distance in the action bar is the entire visual interface.
No GUIs
Every interaction happens through commands, chat, and signs. No inventory screens, no chest menus.
These are product decisions, not missing features.
? Navigation Lifecycle
Player runs /path find <name> (or /path goto, /path death)
│
├─ Permission check
├─ Landmark or target resolution
├─ Access check (public / own private)
│
├─ Navigation session starts
│ ├─ Compass target updated
│ └─ Action bar: direction arrow + distance in blocks
│
├─ Live updates every tick:
│ ├─ World and target validation
│ ├─ Distance + direction recalculation
│ └─ Action bar re-render
│
└─ Session ends automatically on:
├─ Arrival within configured radius
├─ Manual /path stop
├─ Landmark deleted while navigating
├─ Player logout
└─ World change (if configured)
⚙️ Configuration
config.yml — click to expand
general:
locale: en # en · ru · ua
chat-prefix-enabled: true
update-notifications-enabled: true
storage:
type: SQLITE # SQLITE only (MySQL not yet implemented)
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 # Single-word names only
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
? Commands & Permissions
| Command |
Permission |
Default |
Description |
/path find <name> |
pathguide.find |
everyone |
Start navigation to a landmark |
/path stop |
pathguide.find |
everyone |
Cancel active navigation |
/path list [page] |
pathguide.list |
everyone |
Browse accessible landmarks |
/path info <name> |
pathguide.info |
everyone |
View landmark details |
/path goto <x> <z> |
pathguide.goto |
op |
Navigate to coordinates |
/path death |
pathguide.death |
op |
Navigate to last death location |
/path create <name> |
pathguide.create |
op |
Create a landmark |
/path remove <name> |
pathguide.remove.own |
op |
Remove own landmark |
/path rename <old> <new> |
pathguide.rename.own |
op |
Rename own landmark |
/path privacy <name> <public|private> |
pathguide.privacy.own |
op |
Change landmark visibility |
/path share <name> <player> |
pathguide.share |
op |
Send navigation link to a player |
/pathadmin reload |
pathguide.admin |
op |
Live reload of all services |
/pathadmin remove <name> |
pathguide.admin |
op |
Admin-remove any landmark |
/pathadmin inspect <name> |
pathguide.admin |
op |
Inspect landmark ownership |
/pathadmin updates |
pathguide.admin.update |
op |
Check for plugin updates |
Aliases: /pg · /guide · /paths · /landmarks → all route to /path
? Localization
Built-in translations: English, Russian, Ukrainian
Language files live in plugins/PathGuide/lang/ and can be freely edited. Switch language in config.yml under general.locale.
? Perfect For
- Vanilla+ SMP servers — navigation that respects the survival experience
- Exploration-focused servers — distance stays real, discovery stays earned
- Roleplay servers — named landmarks build a living geography
- Folia servers — full regional thread compatibility out of the box
- Any server that wants QoL without breaking immersion
? Requirements
- Server: Paper, Spigot, or Folia
- Java: 21+ (Java 25+ for servers running 26.1.x)
- Minecraft: 1.21 – 26.1.2
Built for modern servers. 112 passing unit tests. Zero teleports.
评论 0
登录后参与评分
还没有评论,来抢沙发吧