A clean, zero-dependency compass HUD that just works — and stays out of your resmon.
wg-compass gives your players a smooth, fully customizable directional HUD with heading, location and live waypoint tracking — with no framework lock-in and no external dependencies. Drop it in and go.
✨ Features
- 🧭 Smooth compass strip (N / NE / E …) driven by camera heading, animated client-side
- 🔢 Heading degrees readout (e.g.
045°)
- 🎯 Live waypoint tracking — marker points to your GPS waypoint with real-time distance, pinning to the edge when it's behind you
- 🗺️ Location display — current street + crossing, zone/area name, and nearest postal (ships with 1,600+ codes)
- 🙈 Smart auto-hide — fades out in the pause menu, while dead, and during screen fades
- ⚙️ In-game settings menu — move, scale, recolor and toggle every element live; saved per-player
- ⌨️ Optional keybinds for toggle and settings menu
- 🔌 Exports + events API so other resources can show / hide / toggle it
- 🧩 Framework-agnostic — auto-detects QBox / QBCore / ESX, otherwise runs standalone
- 🪶 Zero dependencies — pure natives + vanilla JS. No ox_lib, no UI framework, no build step
- ⚡ ~0.00ms idle — adaptive loops do nothing while parked
📋 Compatibility
QBox • QBCore • ESX • Standalone — no database required