BetterSpeedHUD

BetterSpeedHUD

一个更好的HUD模组，用于在屏幕上显示你的速度。高度可定制。

BetterSpeedHUD预览查看大图

BetterSpeedHUD

 

一个适用于 **Minecraft Forge 1.20.1/1.21.1** 的速度 HUD 模组：在骑乘载具或使用鞘翅滑翔时，于屏幕右下角显示一个精美的速度抬眼显示（HUD），包含速度、档位和速度条。所有元素均可游戏内自由调整。

一个更好的 HUD 模组，用于在屏幕上显示你的速度。高度可自定义。 @WYH827

功能特性

  • 实时速度显示：基于玩家实际坐标位移测量速度（格/秒 × 72 转换为 公里/小时）。兼容原版载具和模组载具（例如 MrCrayfish 的载具模组）。也支持鞘翅滑翔。
  • 视觉 HUD：左侧显示 D 档位，中央为三位大号速度数字（前导零以灰色显示），右侧显示 km/h，下方为速度条。
  • 可调最大速度（默认 200）：速度条始终显示 速度 / 最大速度 的百分比，超过时以 100% 封顶。
  • 实际速度开关：关闭时，速度达到最大速度后停止增长（指针锁定在表底）；开启时始终显示实际速度，但速度条仍以最大速度的 100% 封顶。
  • 两种字体：Minecraft 默认字体 / 现代位图字体（游戏中一键切换）。
  • 游戏内配置界面（默认按键 H）：
    • 整个 HUD 和各个元素（D、数字、km/h、速度条）均有独立的 位置、大小 和 可见性 控制；
    • 可通过拖拽、方向键、滚轮或快捷键调整；
    • 右上角的“隐藏按钮”按钮可隐藏所有 UI 按钮，以便无遮挡地查看和定位；
    • 一键切换到现代预设 / 恢复默认设置；
    • 最大速度 +/− 按钮。
  • 显示条件：在载具上显示 / 在鞘翅上显示 / 始终显示（启用“始终”时，前两项锁定为开启）。
  • HUD 总开关：可随时完全隐藏 HUD。
  • 安全配置写入：拖拽和调整仅修改内存中的数值；仅在关闭设置界面时写入配置文件，避免频繁的磁盘写入。

安装

  1. 需要 Minecraft 1.20.1 + Forge 47.x（客户端）、Java 17。
  2. 将 BetterSpeedHUD-1.1.jar 放入 .minecraft/mods 文件夹。
  3. 启动游戏，进入世界，骑乘载具或使用鞘翅滑翔即可看到 HUD。

游戏内配置

按 H 键打开设置界面（也可以通过 Mod 菜单的“配置”按钮访问）。

按键控制

按键 功能
1 ~ 5 选择要调整的元素（整体 / 档位 D / 数字 / km/h / 速度条）
方向键 / 鼠标拖拽 移动当前选中的元素
鼠标滚轮 / + - 缩放当前选中的元素
V HUD 总开关
C 切换实际速度
F 切换字体（Minecraft / 现代）
[ ] 减小 / 增大最大速度（Shift + 按键每次调整 25）
Esc / “保存并关闭” 保存配置并关闭

按钮说明

  • 第一行：在载具上显示 / 在鞘翅上显示 / 全局 HUD（始终显示 HUD）
  • 第二行：分别切换 D / 数字 / km/h / 速度条的可见性
  • 第三行：HUD（总开关） / 实际速度 / 最大速度 −10 / 最大速度 +10
  • 第四行：字体 / 切换到现代预设 / 恢复默认设置 / 保存并关闭
  • 右上角：隐藏按钮（隐藏所有 UI 按钮，以便无遮挡地查看和定位）

注意：当实际速度关闭时，速度达到最大速度后停止增长（指针锁定在表底）。开启时，始终显示实际速度。

注意：最大速度是速度条满格时的速度；速度条的填充比例为 速度 / 最大速度。

配置文件

配置文件位于 .minecraft/config/speedhud-client.toml。主要字段：

[hud]
xOffset = 0      # 整体水平偏移（正值 = 向右）
yOffset = 0      # 整体垂直偏移（正值 = 向下）
scale = 1.0      # 整体缩放
enabled = true   # HUD 总开关
showOnVehicle = true  # 在载具上显示
showOnElytra = true   # 在鞘翅上显示
globalHud = false     # 始终显示
maxSpeed = 200        # 最大速度（满格值）
showActualSpeed = false # 显示实际速度
font = "minecraft"    # minecraft / modern

[hud.modules]        # 模块可见性
gear = true
speed = true
unit = true
bar = true

[hud.elements.gear]  # D 档位位置和缩放
x = 16
y = 40
scale = 1.0

[hud.elements.speed] # 速度数字
x = 76
y = 34
scale = 1.0

[hud.elements.unit]  # km/h
x = 176
y = 46
scale = 1.0

[hud.elements.bar]   # 速度条
x = 0
y = 58
scale = 1.0

现代字体

现代字体是一种自定义位图字体（由“得意黑斜体”生成）：

  • 纹理：assets/speedhud/textures/font/modern.png，尺寸 1152×192，每行 18 个字符，每个单元格为 64×192；
  • 字符顺序：0123456789DKM/Hkmh；
  • 字形对齐到单元格底部（第 192 行）；
  • 定义文件：assets/speedhud/font/modern.json（高度 192 / 上升 7）。

要替换字体，请提供符合上述规范的 PNG 文件，并替换 assets/speedhud/textures/font/modern.png。

开源许可证

本项目以 MIT 许可证 发布。详情请参阅 LICENSE.txt。

作者：@WYH827