FAQ

Another HUD is still running. Stop qbx_hud, qb-hud (or similar), kartik-hud replaces them, including stress. The console warns about this on start.

Publishing only lets players pick it. Pick it in /hud (any style list, marked (custom), or General → HUD Design), press Use on my HUD in the builder, or press Default to give it to everyone.

Also check the widget's Shows in, a speedometer widget only appears in a vehicle, a weapon widget only while armed.

You need the builder ACE (Config.Builder.ace, command by default). See Installation → Admin access. Also check Config.Builder.enabled = true.

In the builder, press Esc until it closes, or use the ✕ at the top right. For cinematic mode, type /cinematic again (or press your cinematic key). Opening /hud also leaves cinematic mode.

Nudge it with Config.Minimap.offset (small values, e.g. 0.002). If you use another resource that moves the minimap, set Config.Minimap.enabled = false.

If your inventory stores ammo itself, call setWeaponAmmoOverride(clip, reserve) whenever the ammo changes, see Client Exports.

Make sure your fuel script is one of the supported ones and starts before kartik-hud.

Check Config.AllowPlayerCustomisation = true, and whether the option is locked in Config.Options.

Players can press Reset HUD at the bottom of /hud. To change what the default is, set it up in /hud as an admin and press Save as default (General → Admin), or edit Config.Options defaults. Delete data/defaults.json to go back to the config defaults.

Add the model to Config.ElectricVehicles (cars the game marks as electric are detected on their own). The battery is the vehicle's fuel level, so it's only right if your fuel script charges EVs through fuel, ox_fuel, lc_fuel and cdn-fuel do. Also check /hud → Electric Cars isn't set to Same as car.

Range is battery × Config.EvRangeKm (480 km by default). Change it in Configuration → Vehicles.

kartik-hud uses its own postal map (Config.Postals.file) unless nearest-postal is running, then its codes and its /postal command are used. To use a different map without nearest-postal, see Configuration → Postals.