Xaero导航

总览

本模组为 Xaero的小地图 和 Xaero的世界地图 添加了寻路功能

本模组不支持自动行走 ⚠️

工作原理

• 路线基于真实地形，而非直线距离。 A* 搜索结合了行走、攀爬、游泳、下落、梯子/藤蔓、乘船、跨越1-3格间隙的跳跃、挖掘以及放置方块搭桥。
• 长距离路线分阶段计算。 首先，使用 Xaero 的地图数据绘制一条粗略路线，以便到达玩家当前加载区块之外的地方。然后，一次详细的寻路搜索将玩家的实际位置与那条粗略路线通过精确路径连接起来。 它还支持多层垂直路径——例如，在地狱，不同的通道可能在相同的 XZ 坐标但不同的高度上重叠。
• 仅在需要时重新计算。 行走时偏离路线的小偏差不会触发重绘，因此引导保持稳定而不是闪烁。
• 在危险发生前警告你，而不是事后。 靠近熔岩的路段、可能导致区域被水淹的挖掘、没有安全着陆点的坠落，以及会耗尽氧气的游泳，都会以不同于正常移动的颜色显示。
• 即使没有 Xaero 也能工作。 地图绘制会被禁用，但寻路、游戏内渲染和屏幕上的引导仍然有效。
• 使用鞘翅滑翔时，系统会计算三维飞行路径。 它会规划一条空中折线以避开地形碰撞，并使用独立于行走的偏差检查和重新计算间隔来跟随这条路径。

使用方法

方法	操作
世界地图	右键点击地图上的空白区域 → “Route here”（在此处规划路线）
路径点	右键点击一个路径点 → “Route here”（在此处规划路线）
按键绑定	“Route to block looked at”（看向的方块处规划路线）（默认未绑定）
命令	/xaeronav goto <x> <y> <z>

无论你使用哪种方法，你的目的地都会显示在 Xaero 的地图上，这样你就知道要去哪里，无需沿着路线走到终点。安装了 Xaero 的小地图时，它会注册为一个临时路径点：它会随着小地图旋转而保持直立，离开屏幕后移动到边缘并显示距离读数，并且像其他路径点一样在世界中显示。它永远不会保存到磁盘，当你清除路线时它就会消失。

路线颜色

颜色	含义
绿色	行走
黄色	向上攀爬
蓝色	向下攀爬/走下
深蓝色	游泳
淡青色	乘船
紫色	梯子 / 藤蔓
粉色	跳跃间隙
橙色	挖掘（目标方块会隔墙高亮显示）
青色	放置方块搭桥
红色	⚠ 靠近熔岩
品红色	⚠ 下方是虚空
浅蓝色	⚠ 挖掘会导致水流入
红粉色	⚠ 没有剩余氧气的游泳路段
橙红色	⚠ 会造成伤害的坠落
蓝绿色	通过最后时刻放置水来缓冲的坠落（MLG）
淡橙色	⚠ 在岩浆块上潜行
米白色	未知路线路段的虚线（朝向未探索的目的地）
琥珀色	长距离路线的粗略路径点链
红色图钉	目的地，由 XaeroNav 在未安装 Xaero 的小地图时绘制（在屏幕上任意缩放级别下大小不变）
天蓝色	使用鞘翅滑翔时的空中路径

警告颜色优先于移动类型颜色——危险需要最先被看到。

命令

命令	功能
/xaeronav goto <x> <y> <z>	设置目的地
/xaeronav clear	清除路线
/xaeronav version	打印当前运行的构建版本（在错误报告中包含此信息）

/xaeronav debug ... 包含一些测量命令，它们会在聊天中打印数字，但不会导航到任何地方：mapdata [radiusChunks]（你周围可用的 Xaero 地图数据量）、route 和 corridor（粗略路径点链及其逐段细化）、probe（详细搜索到达了哪里，以及为什么停止）、以及 flight（空中路线）。它们的存在是为了解释出现问题的路线——请将其输出附加到错误报告中。

已知限制 ⚠️

• 搜索仅限于已加载的区块，并受最大扩展节点数限制。对于远处的目标，路径会中途结束，其余部分显示为虚线（其余部分将在你前进时计算）。HUD 也会显示消息“This area is unexplored.”（此区域未探索）。
• 搜索范围受 Minecraft 的渲染距离限制（渲染距离为8时，范围为128格）。服务器未发送的区块无法被读取，并且由于原版协议不包含请求区块的数据包，本模组无法自行获取它们。如果长距离导航中途中断，请增加渲染距离。
• 使用 Xaero 地图数据的长距离路线，如果未安装 Xaero 或你从未访问过该区域，则无法使用（系统将回退到基于已加载区块的即时计算）。
• 滑翔机路线不显示 HUD。它仅在设置了步行目的地时出现。
• 不支持跨维度路线。如果你移动到另一个维度，目的地将被清除。
• 地图集成是通过接入 Xaero 的内部系统实现的。如果新版本的 Xaero 改变了此结构，只有该特定部分会被禁用，并且在进入世界时会发送一次聊天通知，说明哪些功能已被禁用。游戏内渲染和 HUD 将照常运行。
• 地表优先的路线规划在无天空的维度（地狱和末地）中不起作用。

---

MIT (LICENSE)。

移动成本基准参考了 Baritone (LGPL) 中使用的测量数据，但代码本身是独立实现的。