BetterSpeedHUD

BetterSpeedHUD

A speed HUD mod for **Minecraft Forge 1.20.1/1.21.1**: displays a sleek speed head-up display (HUD) showing speed, gear, and a speed bar at the bottom‑right corner of the screen when riding a vehicle or gliding with an elytra. All elements can be freely adjusted in‑game.

> A Better HUD mod to show your speed on your screen. Highly customizable. @WYH827

Features

• **Real‑time speed display**: measures speed based on the player's actual coordinate displacement (blocks/second × 72 converted to km/h). Compatible with vanilla vehicles and modded vehicles (e.g., MrCrayfish's vehicle mod). Elytra gliding is also supported.
• **Visual HUD**: D gear on the left, three‑digit large speed number in the center (leading zeros shown in grey), km/h on the right, and a speed bar below.
• **Adjustable max speed** (default 200): the speed bar always displays the percentage of speed / max speed, capped at 100% when exceeded.
• **Toggle for actual speed**: when disabled, speed stops increasing once it reaches the max speed (pegs the meter); when enabled, the actual speed is always shown, while the bar still caps at 100% of the max speed.
• **Two fonts**: Minecraft default font / Modern bitmap font (switchable in‑game with one click).
• **In‑game configuration screen** (default key **H**):
• The overall HUD and individual elements (D, digits, km/h, speed bar) each have independent position, size, and visibility controls;
• Adjust via drag‑and‑drop, arrow keys, scroll wheel, or shortcuts;
• A "Hide Buttons" button in the top‑right corner hides all UI buttons for unobstructed viewing and positioning;
• One‑click switch to Modern preset / restore defaults;
• Max speed +/‑ buttons.
• **Display conditions**: show on vehicle / show on elytra / always show (when "always" is enabled, the first two are locked to on).
• **HUD master toggle**: can completely hide the HUD at any time.
• **Safe configuration writing**: dragging and adjustments only modify in‑memory values; the config file is written only when the settings screen is closed, avoiding frequent disk writes.

Installation

1. Requires **Minecraft 1.20.1 + Forge 47.x** (client‑side), Java 17.
2. Place BetterSpeedHUD-1.1.jar into the .minecraft/mods folder.
3. Launch the game, enter a world, and ride a vehicle or glide with an elytra to see the HUD.

In‑Game Configuration

Press **H** to open the settings screen (can also be accessed via the Mod Menu's "Config" button).

Key Controls

Button Descriptions

• First row: Show on vehicle / Show on elytra / Global HUD (always show HUD)
• Second row: Toggle visibility for D / Digits / km/h / Speed bar individually
• Third row: HUD (master toggle) / Actual speed / Max speed ‑10 / Max speed +10
• Fourth row: Font / Switch to Modern preset / Restore defaults / Save & Close
• Top‑right corner: Hide Buttons (hides all UI buttons for unobstructed viewing and positioning)

> Note: When actual speed is disabled, speed stops increasing once it hits the max speed (pegs the meter). When enabled, the actual speed is always shown.
>
> Note: Max speed is the speed at which the bar becomes full; the bar's fill ratio is speed / max speed.

Configuration File

The configuration file is located at .minecraft/config/speedhud-client.toml. Main fields:

[hud]  
xOffset = 0 # Overall horizontal offset (positive = right)  
yOffset = 0 # Overall vertical offset (positive = down)  
scale = 1.0 # Overall scale  
enabled = true # HUD master toggle  
showOnVehicle = true # Show on vehicle  
showOnElytra = true # Show on elytra  
globalHud = false # Always show  
maxSpeed = 200 # Max speed (full bar value)  
showActualSpeed = false # Show actual speed  
font = "minecraft" # minecraft / modern

[hud.modules] # Module visibility  
gear = true  
speed = true  
unit = true  
bar = true

[hud.elements.gear] # D gear position and scale  
x = 16  
y = 40  
scale = 1.0

[hud.elements.speed] # Speed digits  
x = 76  
y = 34  
scale = 1.0

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

[hud.elements.bar] # Speed bar  
x = 0  
y = 58  
scale = 1.0  

Modern Font

The Modern font is a custom bitmap font (generated from Smiley Sans Oblique):

• Texture: assets/speedhud/textures/font/modern.png, 1152×192, with 18 characters per row, each cell 64×192;
• Character order: 0123456789DKM/Hkmh;
• Glyphs are aligned to the bottom of the cell (row 192);
• Definition file: assets/speedhud/font/modern.json (height 192 / ascent 7).

To replace the font, provide a PNG following the above specifications and replace assets/speedhud/textures/font/modern.png.

Open Source License

This project is released under the **MIT License**. See LICENSE.txt for details.

Author: @WYH827