> 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/it/radio/troubleshooting.md).

# Risoluzione problemi e FAQ

{% hint style="info" %}
All'avvio la radio stampa nella console del server framework, inventario e salvataggio scelti, più eventuali avvisi. Leggila per prima.
{% endhint %}

### Due animazioni insieme / animazione di pma-voice sopra la nostra

Manca `setr voice_enableRadioAnim 0`. Impostalo in `server.cfg` prima di `ensure pma-voice` e riavvia. La console lo segnala.

### Il prop radio non compare / compare una radio nativa

`ghiaccio_radio_props` non è avviato, oppure è avviato dopo `ghiaccio_radio`. Avvialo prima. Senza il modello la radio ripiega su `prop_cs_hand_radio` con un avviso in console. Per un prop tuo, controlla che il `.ytyp` sia registrato con `data_file` e che i nomi corrispondano (`Config.Debug = true`).

### Prop in mano ma nessuna animazione

Il prop è sulla mano sbagliata. Le clip `random@arrests` muovono la mano SINISTRA (osso `60309`), le clip stile telefono muovono la mano DESTRA (osso `28422`). Correggi `prop.bone` nel preset.

### Non riesco ad aprire la radio (item richiesto)

L'item `radio` manca dall'inventario o non è stato creato. Vedi [Installazione](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/it/radio/installation.md). Puoi impostare `Config.RequireItem = false`. Controlla `Config.Item` e `Config.Inventory`. Senza una risorsa inventario il requisito viene ignorato con un avviso.

### Usare l'item non fa nulla

* ox\_inventory: l'item richiede `client = { event = 'ghiaccio_radio:client:use' }`.
* QBCore / ESX: `Config.UsableItem` deve essere `true`.
* qs-inventory non è testato.

### Il giocatore viene scollegato dalla radio dopo aver perso l'item

È voluto: il server controlla l'item ogni `Config.ItemCheckSeconds` secondi e a ogni azione.

### Non riesco a entrare in un canale lavoro

Lavoro o grado del giocatore non corrispondono a `jobs` in `Config.JobChannels` (`config_server.lua`), oppure `onDuty = true` e il giocatore non è in servizio. L'accesso è controllato dal server con `addChannelCheck`. Su standalone nessuno ha un lavoro: restituisci `{ name, grade }` da `bridge/server/standalone.lua`.

### La radio mi toglie da un canale lavoro

Lavoro o grado sono cambiati (oppure il server li ha riletti, ogni `Config.JobRecheckSeconds` secondi). È voluto.

### I canali si scontrano con altri script

Altri script usano già canali numerici piccoli di pma-voice. Alza `Config.ChannelOffset` in `config_server.lua`.

### Non riesco a trasmettere

* Morto o ammanettato: la radio non trasmette (`Config.Death`).
* Senza segnale: sotto `Config.Signal.minTransmit` barre con `blockTransmit = true`. Avvicinati a una torre o imposta `blockTransmit = false`.
* Cooldown del PTT: una pressione entro `Config.Ptt.cooldown` ms dalla precedente viene rifiutata. Rilascia e premi di nuovo.
* Un `radioDelay` di pma-voice che si somma al cooldown della radio: imposta uno dei due a `0`.
* Con un'arma in mano la radio trasmette comunque: il problema non è l'arma.

### Non sono morto ma la radio crede di sì (o il contrario)

Controlla `Config.Death.mode`. Con uno script ambulanza personalizzato usa `'export'` (export client che restituisce `true` da morto), `'event'` o `'statebag'`. Con `'event'` e standalone, uno script "a terra" che non espone né export né state bag viene sbloccato dopo 5 secondi.

### Esc apre il menu di pausa

Aggiorna alla 1.1.0: con la UI aperta Esc chiude soltanto la radio.

### "Too many requests"

È stato raggiunto un rate limit di rete in `Config.RateLimit`. Aspetta qualche secondo. Le richieste rifiutate vengono registrate con `Config.LogRejected`.

### Impostazioni e preferiti non vengono salvati

Controlla la riga della console sul salvataggio. Con `oxmysql` avviato i dati vanno nel database (le tabelle sono create dalle migrazioni); altrimenti nei KVP del server. I dati sono legati alla licenza Rockstar, non al personaggio.

### Un preset di animazione personalizzato viene ignorato

I preset sono validati all'avvio: uno non valido viene saltato con un avviso che indica preset e campo (`id`, `label`, `dict`, `anim`, `flag`, `blendIn`, `blendOut`, `prop`). Controlla la console del server. Un `dict` inesistente viene ignorato in silenzio in gioco.

### La radio non si apre

Conflitto di tasti: usa `/radio`. Controlla `Config.Commands` e che `pma-voice` sia avviato.


---

# 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/it/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.
