Speedometer

A sleek, customizable speedometer HUD that displays the current speed, RPM, gear, fuel, and NOS levels. Supports full digital and analog gauges with NUI rendering and animated needle movement.

---

Features

• Digital speed readout with glow effect

• RPM needle and gear display (custom handling for planes)

• Fuel level display

• NOS level & purge status

• Supports engine off state detection and dynamic hiding

• Plane/heli support with altitude logic

• Full styling options for:

  • Needle type, color, length, shadow

  • HUD size, position, background

  • Speed, RPM, fuel, and NOS meters

---

Configuration (in Config.Odometer.speedoConfig)

Config

Layout

• position Sets where the speedometer appears on screen ({ top = '80%', left = '21%' })

• size Outer diameter of the gauge (e.g., 14vh)

---

Visual Style — style

border

Option	Description
width	Thickness of gauge border (e.g., 0.2vh)
color	RGBA color of the border
style	CSS style (e.g., solid, none)

background

Option	Description
color	RGBA fill color behind the gauge
shadow	Shadow effect for background (style, color)

---

Text Display — text

Option	Description
color	RGBA base text color
highlightColor	Alternate color when threshold is triggered
size	Size of the main speed number (1.0vh)

• font Font used for all text (e.g., 'DigitalFont')

---

Digital Speed — digitalSpeed

Option	Description
enable	Enables the digital speed display
size	Font size for the digital value (3vh)
position	Screen offsets { top, left } in %
color	RGBA color of digital text
glow	Glow/shadow style (CSS string)

---

Meters (Needles) — needles

• type Choose needle style variant (1–4)

These decide the specific NUI style of the speedometer

Each meter (speed, rpm, fuel, nos) has its own group of settings:

Key	Description
enable	Enable the meter
size	Size/scale of the meter
position	{x, y} offset of the meter
length	Length of the needle (vh)
width	Width of the needle (vh)
color	RGBA color of needle
shadow	Shadow style and color
digital.back	Color when inactive
digital.nosActive	Color when NOS active

---

NOS Boost Indicator

Option	Description
back	Background color for NOS marker
active	Highlight color when boost is active

---

Highlights

Option	Description
speed	Whether to highlight over-speed threshold
highSpeed	Trigger glow/alternate when exceeding safe speed

---

Markers

Option	Description
color	Default marker tick color
highlightColor	Color for highlighted ticks

---

Integration

• Use with or without the odometer system