定位条三角测量器

定位条三角测量器

使用定位条在启用了定位条的服务器上三角定位玩家位置

杂项

Locator Triangulator(Fabric,Minecraft 1.21.6+)

一个客户端模组,利用定位条(/gamerule locator_bar)功能,通过三角测量来估算其他玩家的位置。

🚀 工作原理

  • 数据拦截: 对于可见玩家,服务器发送的路标数据包中包含的是方位角(以弧度表示的绝对方位角),而非直接坐标。
  • 数据包嗅探: 一个 mixin(ClientPacketListenerMixin)会拦截这些数据包,并为每个玩家在 WaypointStore 中存储一条测量记录。记录内容包括测量时你自己的位置、方位角以及时间戳。较新的测量记录权重更高,而过期的数据会被丢弃。
  • 数学原理: LeastSquaresTriangulator 使用线性最小二乘回归,根据 2 条或更多测量记录(理想情况下从相距较远的位置获取)计算方位线最可能的交点。由于射线残差相对于目标位置是线性的,因此无需迭代或初始猜测。此外还会验证矩阵条件数,并计算均方根(RMS)残差误差。
  • HUD 显示: HUD 会为每个目标显示以下信息:名称、估算的 X/Z 坐标、距离以及残余不确定性(RMS)。下方的一行会提示方位角是否足以进行估算,或者你是否应该横向移动以改善三角测量(增大基线)。如果 Minecraft 对附近玩家发送的是直接或近似区块位置,HUD 将改为显示该信息。一旦客户端获知对应的玩家名称,就会解析玩家 UUID。

🕹️ 控制与命令

按 J 键可开启或关闭玩家追踪显示(可在 选项 → 控制 → 按键绑定 → 杂项 中重新绑定)。HUD 会显示在左上角的专用面板中。

以下游戏内命令可用:

  • /triangulator status – 显示当前追踪状态以及已收集的样本数量。
  • /triangulator clear – 清除所有当前存储的路标和追踪数据。
  • /triangulator forget <id> – 丢弃某个特定目标的追踪数据。
  • /triangulator lizenz – 在聊天中逐页打印 GPLv3 许可证文本;使用 /triangulator lizenz <page> 或可点击的“上一页/下一页”按钮进行翻页。