跳到正文
返回搜尋

BoatHUD

作者 MRUIAW

A racing HUD and driving assistant for boats on LeviLamina clients.

client · 1.0.1

README1.0.1

Bedrock BoatHUD

English Release

基于 LeviLamina 的 Minecraft 基岩版客户端赛船 HUD,参考了 Hibiii/BoatHud 和 BoatHUD Extended 的设计与驾驶体验。

⚠️警告⚠️:**该项目的每一行代码都是由AI进行生成的。**如果你对AI生成的代码有顾虑,请勿使用。这是一个实验AI能否vibe出简单模组+自己寻找+hook内存地址的项目,repo的根目录下有关于AI开发过程的readme,若你不擅长C++却想做一些简单的mod的话,欢迎阅读。

功能

  • 自动识别普通船、运输船的驾驶者;默认使用 Race(竞速) 布局,也可切换 Classic(经典)、Compact(紧凑)。
  • 显示速度、侧滑角、纵向/横向加速度、服务器延迟和 HUD 渲染 FPS。
  • BoatHUD 风格的像素速度条、加速度指示器、转向/油门轨迹,以及可选的左右箭头和前进/后退图标。
  • 游戏内设置界面使用原生鼠标光标;设置即时生效,自动跟随游戏语言显示英文或简体中文。
  • 可选 Hibiii 式镜头辅助:速度越高,视角越偏向实际运动方向,并进行平滑处理。
  • 可选原版 HUD 隐藏、遥测 CSV、检查点时间差和速度差。

镜头辅助、隐藏原版 HUD、遥测和检查点均默认关闭;速度平滑默认开启。无需安装额外资源包。

安装

1.0.1 适用于 Minecraft 基岩版 1.26.51.01、LeviLamina 26.51.x(已测试 26.51.5),且仅支持 Windows x64 客户端。不支持其他游戏/加载器系列或专用服务端。

通过 LeviLauncher 安装(推荐)

下载 LeviLauncher,启动 LeviLauncher 并打开 Bedrinth,在其中搜索“BoatHud”,然后选择与您的游戏版本兼容的版本。新发布的版本可能需要等待索引更新;暂未搜到时可使用下方 lip 或手动安装方法。

通过 lip 安装

安装或更新前完全退出 Minecraft。在 LeviLamina 游戏实例目录中使用 lip:

lip install "github.com/MRUIAW/BedrockBoatHUD#client"

手动安装

从 Releases 下载 BedrockBoatHUD-client-windows-x64.zip,将压缩包中的 BoatHUD 文件夹放进实例的 mods 文件夹。更新时保留原有 config 和 data 文件夹。Release 标题统一为 v<模组版本>-mc<游戏系列>,当前为 v1.0.1-mc26.5x;标题不扩大上述实际兼容范围。仅发布一份重新编译的客户端包。

实际安装目录为 mods/BoatHUD/。安装前退出游戏,将早期版本的 mods/BedrockBoatHUD 移到 mods 目录之外,避免两个模组同时加载;旧配置不自动迁移。

启动游戏并坐上船的驾驶位即可看到 HUD;作为乘客时不显示驾驶 HUD。

操作

按键功能
B开启/关闭 BoatHUD
N按 Race → Classic → Compact 切换布局
C开启/关闭镜头辅助
O打开设置

设置中将鼠标移到一行上,左键切换到下一值,右键切换到上一值。方向键上下选择行,左右调整;回车和空格也可切换。按 O、Esc 或选择“完成”关闭,修改自动保存。“隐藏原版 HUD”仅在菜单内设置,没有独立快捷键。

移动图标读取游戏的移动输入,支持移动键重新绑定和手柄;上述四个模组快捷键为固定键位。

速度条

速度条量程始终按 m/s 计算,与速度数字选择的单位无关。

模式量程颜色分区
水与浮冰(packed,默认)0–40 m/s8 m/s 以下为蓝色,其后为灰白色
混合冰(mixed)0–72 m/s40 m/s 以下为灰白色,其后为蓝色
蓝冰(blue)40–72.7 m/s全蓝色

点亮长度随速度变化,超过上限时闪烁,速度条保持在面板边框内部。Race 的两个加速度读数分别按绝对值选取小数位:小于 10 显示两位小数,大于等于 10 显示一位小数。

配置与语言文件

以下路径均相对于游戏实例目录:

路径用途
mods/BoatHUD/config/config.json配置;首次加载时生成
mods/BoatHUD/lang/en.json英文界面文本
mods/BoatHUD/lang/zh_CN.json简体中文文本(zh-Hans / Minecraft zh_CN)
mods/BoatHUD/data/telemetry/带时间戳的遥测 CSV
mods/BoatHUD/config/checkpoints.csv默认检查点文件

手工修改 JSON 前退出游戏,也可以直接使用设置菜单。速度单位支持 ms、kmh、mph、knots,加速度单位支持 g、mss。高级镜头参数为 cameraAggressiveness(默认 60 m/s)、cameraSmoothing(每 Tick 保留比例 0.45)、cameraMinimumSpeed(0.5 m/s)。配置格式版本 3 与模组发布版本相互独立。

遥测与检查点

驾驶时在设置中开启“遥测 CSV”立即开始记录;关闭该选项或结束驾驶会刷新并关闭文件。导出使用固定单位,不随 HUD 单位改变。CSV 第一行是格式版本注释,第二行是表头,并非 Java 原作的 11 列原样导出格式。导入表格软件时跳过第一行。

检查点文件使用五列:

reference_time_seconds,reference_speed_mps,normal_x,normal_z,plane_offset
0.000,0.000,0.000,1.000,100.000
5.000,40.000,0.000,1.000,200.000

检查点平面为 x * normal_x + z * normal_z = plane_offset,从负侧穿越到正侧才触发。第一点建立圈起点;在 JSON 中开启 circularTrack 可循环检查点序列。检查点需手工准备;功能已实现,但真实赛道验收覆盖还没有 HUD 和相机充分。

详见 遥测使用指南 和 检查点示例。FPS 表示此 HUD 的渲染帧率,不是独立的整游戏性能测试;配置中的玩家名称显示字段为预留项,1.0.1 不绘制玩家名称。

构建与维护

需要 Windows x64、XMake、LLVM/Clang 22、Visual Studio C++ Build Tools 和 Windows SDK。

xmake f -a x64 -m release -p windows --target_type=client -y
xmake -y
pwsh -File scripts/Package-Release.ps1

模组目录输出到 bin/BoatHUD/,校验后的 ZIP 输出到 build/release/。CHANGELOG.md 记录发布变更;AGENTS.md 为后续维护者提供规范、版本升级、相机符号、菜单鼠标及发布流程说明。DEVELOPMENT_STATUS.md 保留开发与验收历史,其中早期方案可能已被后续版本替代。

致谢与许可证

项目代码使用 CC0-1.0。BoatHUD 设计与镜头行为参考上述两个 Java 项目。HUD 通过基岩版原生 UI 图元绘制,发行包没有包含原作的二进制纹理。本项目与 Mojang、Microsoft 及原模组作者没有隶属关系。

安裝 BoatHUD

執行端
  • 用戶端
平台
  • win-x64

在用戶端上,請透過以下方式安裝: LeviLauncher

從 GitHub 下載