Wayfinder Trails+

Wayfinder Trails+ 是一个轻量级的 Fabric 导航模组，其核心设计理念非常简单：绝不迷失你走过的路。

放置一个寻路信标，使用共振定位器将其链接，Wayfinder Trails+ 就会在你旅行时开始记录你的路线。当你准备好返回时，使用定位器即可显示一条沿着你实际走过路径的踪迹，引导你返回，而不是简单地指向你起始位置的直线方向。

这使得 Wayfinder Trails+ 在以下场景中尤为实用：

• 大型洞穴系统
• 矿洞和废弃矿井
• 长途探索
• 茂密的森林
• 山路
• 下界探险
• 结构和遗迹
• 任何“返回路线比直线距离更重要”的旅程

尽管该模组最初是作为洞穴导航系统开发的，但 Wayfinder Trails+ 在任何地方都能发挥作用。

工作原理

基本的游戏循环很简单：

1. 制作并放置一个寻路信标。
2. 对信标使用共振定位器来链接它。
3. 开始探索。
4. Wayfinder+ 会记录你从该信标出发的旅行路线。
5. 当你想返回时，使用已链接的定位器。
6. 一条可见的踪迹会沿着你记录的路径出现，并引导你返回。
7. 当你沿着路线前进时，身后已完成的返回踪迹部分会消失。
8. 一旦你到达信标，路线即完成并清除，以便开始新的旅程。

与普通的指南针不同，Wayfinder+ 不仅仅是指向一个坐标。它会记住你实际走过的路线，这在墙壁、悬崖、洞穴、隧道、峡谷、传送门或其他障碍物使得直线方向毫无用处时，会更有用得多。

共振定位器

共振定位器是与你的活动路线进行交互的主要工具。

它存储了与其链接的信标信息，并允许你在不打开复杂菜单的情况下控制导航。

当前的操控方式围绕简单的路线管理设计：

• 右键点击： 手持已链接的定位器时，切换返回引导
• 潜行 + 右键点击： 手持已链接的定位器时，暂停或恢复记录
• B 键： 暂停或恢复记录
• G 键： 切换返回引导

已链接的定位器会识别它所属的信标和路线，防止路线操作误伤无关的导航数据。

每位玩家一条活动路线

Wayfinder Trails+ 有意设计为同时只能进行一段活动旅程。

玩家可以拥有或放置多个信标，但同一时间，每位玩家只能有一条信标路线被活动链接和记录。

这保证了导航的可预测性，并防止多条路线同时记录相同的移动。

当你完成或有意识地清除一条路线后，另一个信标便成为你新的活动寻路器。

记录的路线

Wayfinder Trails+ 使用服务端路线图来记录你的旅程，而不是简单地保存数百个原始的粒子位置。

系统会追踪你走过的路径，并利用这些信息来计算返回信标的路线。

路线系统设计用于处理：

• 转弯
• 分支隧道
• 海拔变化
• 折返
• 路线交叉口
• 长途旅程
• 反复经过路线区域

踪迹本身只是这些已保存导航数据的可视化表示。

返回引导

当启用返回引导时，Wayfinder Trails+ 会计算从你当前位置返回到已记录旅程的路线。

模组不是一次性在世界中铺满整条路径，而是根据你配置的踪迹设置，渲染附近的引导标记。

当你向信标移动时，已完成部分的返回踪迹会被移除。

如果在到达信标前你改变了主意，你可以关闭返回引导并继续你的旅程，而不会丢失路线。

暂停与恢复

路线记录可以在不启动返回旅程的情况下暂停。

当你想要暂时离开主路线去执行以下操作时，这非常有用：

• 挖掘矿脉
• 探索一个小的侧室
• 建造
• 搜索附近地形
• 在建筑周围游荡
• 避免在记录的路径中添加不必要的环线

当你回到路线上时，恢复记录并继续你的旅程。

自定义寻路踪迹

Wayfinder Trails+ 包含专为导航设计的原创踪迹效果，而不是完全依赖原版 Minecraft 粒子。

自定义踪迹样式包括以下效果：

共振

这是 Wayfinder Trails+ 的标志性踪迹。

微小的发光紫/青色风格共振符号会沿着路线脉冲，形成一条清晰、低杂乱的导航路径。

面包屑

一种极简的踪迹，使用微小的动态光点，适合希望屏幕杂乱最少的玩家。

回声之环

动画共振环沿路线扩展并淡出。

每个环在重新开始前会循环播放自己的动画，形成一种脉动的航点效果，而不是一团粒子云。

指南针人字纹

方向标记会直观地指示沿记录路径的哪个方向可以返回信标。

水晶碎片

发光的晶体标记沿路径闪烁。

行进脉冲

动画脉冲沿路线部分行进，直观显示朝向信标的方向。

自定义的 Wayfinder Trails+ 粒子使用小簇和错开的动画时间，使得单个光点保持可见，而不会使踪迹变成一堵粒子墙。

传统 / 原版踪迹样式

一小部分有用的原版风格效果可能仍会保留，供喜欢它们的玩家使用。

可见性差或过于嘈杂的粒子类型已被有意移除或减少。

Wayfinder Trails+ 优先考虑：

• 可见性
• 低屏幕杂乱
• 清晰的方向
• 有用的导航

而不是简单地产生尽可能多的粒子。

踪迹自定义

Wayfinder Trails+ 包含可配置的踪迹渲染选项。

根据当前版本，设置可以包括：

• 踪迹样式
• 踪迹节点间距
• 渲染距离
• 最大可见踪迹光点数
• 粒子可见性
• 方向脉冲行为
• 消息和导航反馈

路线本身与视觉踪迹是分开的，因此更改踪迹外观不会改变实际记录的旅程。

信标命名

寻路信标可以保留自定义名称，允许围绕有意义的名称来组织路线，例如：

• 深层矿洞
• 远古城市入口
• 下界要塞
• 要塞
• 村庄
• 基地
• 山口

链接的定位器可以显示信标名称，以便始终清楚当前路线属于哪个位置。

信标状态

与信标互动可以提供其当前导航状态的信息。

这可能包括：

• 信标名称
• 它是否处于活动状态
• 你当前是否有与其链接的路线
• 路线节点数量
• 当前路线状态

路线信息是特定于玩家的。

信标破坏

破坏一个活动的寻路信标会故意结束其关联的导航会话。

当信标被破坏时：

• 其活动路线被清除
• 可见的返回踪迹被清除
• 匹配的在线定位器尽可能解除链接
• 过期的定位器数据无法重新创建已完成的路线

仅仅卸载信标所在的区块或重启服务器，不算作破坏信标。

持久化路线

路线信息保存在服务端。

这允许 Wayfinder Trails+ 在以下情况下保留导航数据：

• 区块卸载
• 玩家登出
• 世界保存
• 服务器重启

客户端不需要永久存储路线本身。服务器保持权威性，并在需要时提供必要的踪迹信息。

多人游戏

Wayfinder Trails+ 按玩家存储路线。

一个玩家记录的路线不会自动成为另一个玩家的路线。

这可以防止私人导航信息被无关玩家看到，并允许不同玩家在同一服务器上独立使用 Wayfinder Trails+。

随着模组的发展，扩展的团队/共享路线功能可能会单独添加。

跨维度导航

Wayfinder Trails+ 正在设计以支持跨越维度的路线，而不会尝试在主世界和下界之间绘制不可能的粒子线。

预期的路线模型将维度变化视为独立路线段之间的过渡。

例如：

主世界

信标
 ↓
记录的路线
 ↓
下界传送门

下界

传送门抵达点
 ↓
记录的下界路线
 ↓
目的地

返回时，下界踪迹会引导玩家回到记录的传送门。跨过传送门返回主世界后，主世界部分的路线会恢复并引导玩家回到信标。

这确保了跨维度导航基于实际旅程，而不是试图将下界和主世界坐标转换为虚假的直线路线。

为长路线而设计

Wayfinder Trails+ 旨在在短途洞穴旅行之外保持实用性。

路线系统分离了：

• 存储的路线信息
• 可见的踪迹标记
• 踪迹渲染距离
• 粒子动画

这允许记录长途旅行，而无需同时渲染每个存储的路线点。

性能保护和路线简化有助于保持长踪迹的可管理性。

服务器权威性

导航和路线状态在服务端维护。

服务器控制：

• 活动信标路线
• 记录的路线图
• 路线状态
• 返回计算
• 持久化
• 信标身份

客户端负责视觉踪迹渲染和交互反馈。

这种分离有助于保证多人游戏行为的可预测性，并防止客户端自行编造路线状态。

支持的版本

Wayfinder Trails+ 针对支持的 Fabric 版本分别构建。

请确保你安装了与你确切 Minecraft 版本匹配的文件。

前置要求

必需：

• Fabric Loader
• Fabric API

如果适用，任何额外的配置库要求应在单独的发布文件中列出。

Wayfinder Trails+ 不是什么

Wayfinder Trails+ 不是：

• 小地图
• 传送模组
• 航点传送系统
• 通过未探索地形的自动寻路
• 探索的替代品

它不会将你传送回家，也不会计算你从未走过地形的理论上最短路线。

相反，它会记住你的旅程，并帮助你重走该路线。

这就是 Wayfinder Trails+ 的核心目的：

去任何你想去的地方。Wayfinder Trails+ 会记住回来的路。