F.A.Q

Common questions, common errors, and their quick fixes.

I changed the blip sprite in config but it does not show on the GPS map

Config sprites control minimap / world blips. The device map needs an image file:

web/build/blips/{spriteNumber}.png

Example: sprite = 999 → you need web/build/blips/999.png. Copy an existing PNG, rename it, swap the art, restart the resource.

See Configuration → NUI map sprites.

Blips look fine on the minimap but broken on the GPS screen

Same fix — add the matching PNG (or GIF) under web/build/blips/. The number in the filename must match the sprite ID you use in config.

Player cannot join a channel

Check in order:

• Is the frequency in config/main.lua channels and is their job listed in jobs?

• Is dutyOnly true and are they off duty?

• Is it a password channel — did they enter the right password?

• Is the frequency reserved in config but they are trying to use it as a custom channel?

GPS closes or my position goes crazy in water

That is waterPunishment:

• wrongCoords — soft: fake coords while in water on a channel

• removeItem — hard: item removed, UI closes

Change it in config/main.lua if it does not fit your server.

Server lags when many people share one frequency

Raise refreshRate, increase updateDistance, set smoothBlips.enabled = false, or let dynamicRefreshRate use higher tier values. See Performance.

Using the item does nothing

• Item name in inventory must match item in config (default gps).

• ox_inventory: client.event = '0r-gps:client:toggleGPS' on the item.

• QB: item must be useable = true.

• Restart 0r-gps after config changes.

Custom map blips are disabled

The channel must have createCustomBlips = true in its settings (config channel or channel created in-game with that option enabled).

Panic button missing

sendPanicSignal must be true for that channel. Cooldown is set in panicBlip.cooldown.