A lightweight, client-side HUD for FiveM servers that shows location-aware information in a compact overlay anchored above the minimap. It requires no database and has no server-side footprint beyond loading the resource.
What it displays#
The HUD renders up to four lines of information that update automatically as the player moves around the map.
- Postal & Road — the nearest postal code followed by the current street name and any cross street, separated by a configurable divider.
- Area & County — the game zone label (e.g. Rockford Hills) and whether the player is in Los Santos County or Blaine County.
- Direction & Time — an 8-way compass heading (N, NE, E … NW) and the in-game clock in 12- or 24-hour format.
- Area of Patrol — an optional line set by other scripts via the export API; hidden when nothing is set.
An optional Near system can also surface a label such as Near Legion Square when the player is within a configurable radius of a named landmark.
Key features#
- Minimal performance impact — location and postal lookups run on separate timers so the postal search (which can be expensive on large datasets) runs less frequently than the street/zone update.
- Ships with OCRP-compatible
data/postals.jsonand supports any postal file format that usescode,x, andyfields. - Fully themeable via
config.lua; font size, padding, border colour, border radius, and background opacity are all adjustable without touching HTML or CSS. - Automatically anchors above the minimap and adjusts when the player changes safe-zone size or screen resolution.
- Exposes exports so other resources can push an Area of Patrol line or arbitrary extra lines into the HUD at runtime.
Requirements#
- A FiveM server running a recent artifact build. No framework dependency — works standalone.