> For the complete documentation index, see [llms.txt](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/radio/troubleshooting.md).

# Troubleshooting & FAQ

{% hint style="info" %}
At start the radio prints the chosen framework, inventory and storage in the server console, plus any warning. Read it first.
{% endhint %}

### Two animations at once / pma-voice animation on top of ours

`setr voice_enableRadioAnim 0` is missing. Set it in `server.cfg` before `ensure pma-voice` and restart. The console warns about it.

### The radio prop does not show / a native radio is shown

`ghiaccio_radio_props` is not started, or it is started after `ghiaccio_radio`. Start it before. Without the model the radio falls back to `prop_cs_hand_radio` with a console warning. For your own prop, check the `.ytyp` is registered with `data_file` and the names match (`Config.Debug = true`).

### Prop in hand but no animation

The prop sits on the wrong hand. The `random@arrests` clips move the LEFT hand (bone `60309`), the phone-style clips move the RIGHT hand (bone `28422`). Fix `prop.bone` in the preset.

### Cannot open the radio (item required)

The `radio` item is missing from the inventory or not created. See [Installation](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/radio/installation.md). You can set `Config.RequireItem = false`. Check `Config.Item` and `Config.Inventory`. Without an inventory resource the requirement is ignored with a warning.

### Using the item does nothing

* ox\_inventory: the item needs `client = { event = 'ghiaccio_radio:client:use' }`.
* QBCore / ESX: `Config.UsableItem` must be `true`.
* qs-inventory is not tested.

### The player is disconnected from the radio after losing the item

That is intended: the server checks the item every `Config.ItemCheckSeconds` seconds and on every action.

### I cannot join a job channel

The player's job or grade does not match `jobs` in `Config.JobChannels` (`config_server.lua`), or `onDuty = true` and the player is off duty. Access is checked by the server with `addChannelCheck`. On standalone nobody has a job: return `{ name, grade }` from `bridge/server/standalone.lua`.

### The radio kicks me from a job channel

Your job or grade changed (or the server re-read it, every `Config.JobRecheckSeconds` seconds). That is intended.

### Channels clash with other scripts

Other scripts already use small numeric pma-voice channels. Raise `Config.ChannelOffset` in `config_server.lua`.

### I cannot transmit

* Dead or cuffed: the radio does not transmit (`Config.Death`).
* No signal: below `Config.Signal.minTransmit` bars with `blockTransmit = true`. Move near a tower or set `blockTransmit = false`.
* PTT cooldown: a press within `Config.Ptt.cooldown` ms of the previous one is refused. Release and press again.
* A pma-voice `radioDelay` stacking with the radio cooldown: set one of them to `0`.
* With a weapon in hand the radio still transmits: the problem is not the weapon.

### I am not dead but the radio thinks I am (or the opposite)

Check `Config.Death.mode`. With a custom ambulance script use `'export'` (client export returning `true` when dead), `'event'` or `'statebag'`. With `'event'` and standalone, a downed script that exposes no export or state bag is unblocked after 5 seconds.

### Esc opens the pause menu

Update to 1.1.0: with the UI open Esc only closes the radio.

### "Too many requests"

A network rate limit in `Config.RateLimit` was hit. Wait a few seconds. Rejected requests are logged with `Config.LogRejected`.

### Settings and favorites are not saved

Check the console line about storage. With `oxmysql` started the data goes to the database (tables are created by migrations); otherwise to the server KVP. Data is tied to the Rockstar license, not to the character.

### A custom animation preset is ignored

Presets are validated at start: an invalid one is skipped with a warning naming the preset and the field (`id`, `label`, `dict`, `anim`, `flag`, `blendIn`, `blendOut`, `prop`). Check the server console. A non-existent `dict` is silently ignored in game.

### The radio does not open

Key conflict: use `/radio`. Check `Config.Commands` and that `pma-voice` is started.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/radio/troubleshooting.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
