Hexvane的寻路者

Hexvane 的寻路者

Hexvane 的寻路者是一款游戏内导航模组。你可以创建带有有序航点（waypoints）的路线；玩家启动一条路线后，会看到一条指向下一个航点的粒子轨迹，以及世界地图上的一个指南针标记。当玩家到达某个航点（在其到达半径内）时，粒子轨迹会推进到下一个航点。你可以为每个航点添加到达信息、音效，以及在到达航点或完成整条路线时触发的可选命令。

概述

寻路者允许服务器工作人员或建筑者创建带有多个航点的命名路线。玩家使用 /wayfinder start <路线名> 开始跟随一条路线。粒子轨迹会指示通往当前航点的路径，世界地图上则会显示该航点的标记。当玩家进入航点的到达半径（默认 3 个方块）时，下一个航点就会被激活。可选地，每个航点可以显示弹出消息、播放音效以及执行服务器命令；当玩家抵达最后一个航点时，整条路线也可以执行一个命令。

所有寻路者命令都使用 /wayfinder 或其简写 /wf。在路线和航点名称中使用下划线或破折号（例如 My_First_Route、Starting_Area），以便清楚区分路线名称和其他参数。

快速入门

1. 创建一条路线：/wf create My_First_Route
2. 走到第一个位置并添加航点：/wf addwaypoint My_First_Route Starting_Area
3. 走到下一个位置并添加另一个航点：/wf addwaypoint My_First_Route The_Old_Bridge
4. 可选：设置到达消息：/wf setmessage My_First_Route 2 Cross the bridge and look for the hidden cave entrance.
5. 开始导航：/wf start My_First_Route

一条粒子轨迹会引导你前往航点 1。当你足够接近时，它会推进到航点 2，如果设置了到达消息则会显示，并且粒子轨迹会更新。

路线管理

• /wf create <名称> 创建一条新的空路线。
• /wf delete <名称> 永久删除一条路线。
• /wf list 列出所有路线及其包含的航点数量。
• /wf info <名称> 显示详细的路线信息：航点、位置、半径以及每个航点是否设置了消息。

航点编辑

航点索引从 1 开始（第一个航点是 1，第二个是 2，依此类推）。

• /wf addwaypoint <路线名> [名称] 在你当前位置添加一个航点。如果省略名称，则默认为 "Waypoint N"。
• /wf removewaypoint <路线名> <索引> 移除指定索引的航点。后续航点索引会向前移动。
• /wf setwaypoint <路线名> <索引> 将指定索引的航点移动到你的当前位置。
• /wf setmessage <路线名> <索引> <消息> 设置当玩家到达此航点时显示弹出消息。
• /wf setradius <路线名> <索引> <半径> 设置到达半径，单位为方块（默认 3.0）。玩家必须在此距离内才能触发航点。
• /wf setarrivalcommand <路线名> <索引> [命令] 当玩家到达此航点时执行一个命令。命令以服务器控制台身份运行。在命令中使用 {player} 作为玩家显示名称（例如 give {player} diamond 1）。省略命令以清除它。
• /wf setsound <路线名> <索引> [声音事件ID] 覆盖此航点的到达音效。使用游戏的声音事件 ID。省略可清除并恢复使用默认音效。
• /wf setcompletioncommand <路线名> [命令] 当玩家到达最后一个航点并完成路线时执行一个命令。以控制台身份运行；使用 {player} 作为玩家名称。省略命令以清除它。

导航

• /wf start <路线名> 从航点 1 开始导航一条路线。粒子轨迹和指南针标记会指向当前航点。
• /wf stop 停止你当前的导航。
• /wf skip 跳过到下一个航点，无需步行前往。
• /wf preview <路线名> 在每个航点处生成粒子，以视觉方式检查路线的布局。

导航如何工作

• 一条粒子轨迹从玩家延伸至当前航点（默认最多向前 20 个方块）。
• 世界地图上的一个指南针标记指向激活的航点。
• 当玩家进入航点的到达半径时，下一个航点变为激活状态。此时会播放任何到达音效或执行到达命令。
• 如果航点有消息，会出现一个带有“继续”和“停止导航”选项的弹出窗口。
• 当到达最后一个航点时，如果设置了路线完成命令则会执行，导航结束。

命令执行

到达和完成命令以服务器控制台身份运行，而非玩家身份。玩家无需拥有 OP 权限或特殊权限；只有创建路线并设置命令的人需要使用寻路者模组权限。在存储的命令中，使用占位符 {player}；它会被替换为到达航点或完成路线的玩家的显示名称。例如：要给该玩家一个物品，使用 give {player} diamond 1。命令前的斜杠是可选的。

配置

配置文件保存在插件数据目录中，文件名为 wayfinder_config.json。选项包括：

• defaultParticle：用于轨迹的粒子效果（默认：Wayfinder_Trail）。
• trailSpacing：轨迹粒子之间的间距，单位为方块（默认：2.0）。
• trailMaxDistance：轨迹渲染在玩家前方的最大距离（默认：20.0）。
• defaultArrivalRadius：默认航点触发半径，单位为方块（默认：3.0）。
• visualMode：FLOATING（轨迹在视线水平）或 GROUNDED（轨迹在地形上）。
• tickRate：轨迹更新的频率，以刻为单位（默认：10）。
• showArrivalPopup：是否在到达航点时显示弹出UI（默认：true）。
• allowPlayerDisable：到达弹出窗口是否显示“停止导航”按钮（默认：true）。

数据存储

路线以 JSON 文件形式保存在插件数据目录下的 routes/ 文件夹中。每个文件都以路线名称命名。路线在服务器重启后会持久保存。

文档

有关使用此模组更深入的教程，包括逐步构建路线、修复错误和命令触发器，请参阅 GitHub 上的使用指南。

支持

如有问题、建议或疑问，请加入 Hexvane 的模组 Discord 获取支持。