> For the complete documentation index, see [llms.txt](https://docs.0resmon.org/0resmon/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.0resmon.org/0resmon/0resmon-1/0r-resources/0r-gps-v3/faq.md).

# F.A.Q

<details>

<summary>I changed the blip sprite in config but it does not show on the GPS map</summary>

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](/0resmon/0resmon-1/0r-resources/0r-gps-v3/configuration.md#nui-map-sprites-gps-screen).

</details>

<details>

<summary>Blips look fine on the minimap but broken on the GPS screen</summary>

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.

</details>

<details>

<summary>Player cannot join a channel</summary>

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?

</details>

<details>

<summary>GPS closes or my position goes crazy in water</summary>

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.

</details>

<details>

<summary>Server lags when many people share one frequency</summary>

Raise `refreshRate`, increase `updateDistance`, set `smoothBlips.enabled = false`, or let `dynamicRefreshRate` use higher tier values. See [Performance](/0resmon/0resmon-1/0r-resources/0r-gps-v3/configuration.md#performance).

</details>

<details>

<summary>Using the item does nothing</summary>

* 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.

</details>

<details>

<summary>Custom map blips are disabled</summary>

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

</details>

<details>

<summary>Panic button missing</summary>

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

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.0resmon.org/0resmon/0resmon-1/0r-resources/0r-gps-v3/faq.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.