> 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/integrations.md).

# Integrazioni e adapter

All'avvio la console stampa framework, inventario e salvataggio scelti.

## pma-voice

`pma-voice` è obbligatorio e **non viene mai modificato**: la radio usa solo i suoi export ed eventi (verificato su 7.0.1: `setPlayerRadio`, `getPlayersInRadioChannel`, `addChannelCheck`, `setRadioVolume`, eventi `pma-voice:radioActive` e `pma-voice:setTalkingOnRadio`).

* `setr voice_enableRadioAnim 0` è obbligatorio (vedi [Installazione](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/it/radio/installation.md)): le animazioni le gestisce `ghiaccio_radio`.
* Le frequenze vengono convertite in canali interi: `channel = frequency * 10^decimals + Config.ChannelOffset` (`config_server.lua`). Se altri script usano già canali numerici piccoli di pma-voice, alza `Config.ChannelOffset`.
* Se pma-voice si riavvia, i controlli dei canali lavoro vengono registrati di nuovo in automatico.
* Se il tuo pma-voice ha già un `radioDelay`, metti lui o `Config.Ptt.cooldown` a `0` (vedi [Configurazione](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/it/radio/configuration.md)).
* Altri sistemi voce (SaltyChat, Mumble): implementa le stesse funzioni di `adapters/voice/pmavoice.lua` e `pmavoice_server.lua` e imposta `Config.Voice`. Incluso solo `'pma-voice'`.

## Framework

`Config.Framework = 'auto'` rileva Qbox, QBCore, ESX in quest'ordine, altrimenti standalone. Forzalo con `'esx'`, `'qbcore'`, `'qbox'` o `'standalone'`.

* **ESX Legacy**: lavoro e grado da `job.grade`; morte da `esx:onPlayerDeath` / `esx:onPlayerSpawn`; item usabile con `ESX.RegisterUsableItem`.
* **QBCore / Qbox**: lavoro e grado da `job.grade.level`; supporto al servizio; morte da `PlayerData.metadata.isdead` / `inlaststand`; `metadata.callsign` come nominativo di riserva.
* **Standalone**: nessuno ha un lavoro e non c'è inventario (il requisito dell'item viene ignorato con un avviso). Collega il tuo sistema lavori restituendo `{ name, grade }` da `bridge/server/standalone.lua`.

## Inventari (item radio)

Rilevati in automatico, oppure forzati con `Config.Inventory = 'ox' | 'qb' | 'qs' | 'esx' | 'none'`.

| Inventario                     | Come si usa l'item                                                                                                   |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------- |
| `ox_inventory`                 | `client = { event = 'ghiaccio_radio:client:use' }` nella definizione dell'item                                       |
| `qb-inventory` (anche ps / lj) | `CreateUseableItem` registrato dalla risorsa (`Config.UsableItem`)                                                   |
| `qs-inventory`                 | Non testato (vedi [Installazione](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/it/radio/installation.md)) |
| Inventario ESX                 | `ESX.RegisterUsableItem` registrato dalla risorsa                                                                    |

Gli snippet degli item sono in [Installazione](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/it/radio/installation.md). Il nome dell'item è `Config.Item`.

## Canali lavoro e grado

Si definiscono in `config_server.lua`. Ogni voce:

| Campo       | Significato                                                                                   |
| ----------- | --------------------------------------------------------------------------------------------- |
| `id`        | Testo unico.                                                                                  |
| `label`     | Testo mostrato nella UI.                                                                      |
| `frequency` | Una singola frequenza, oppure la frequenza di ingresso con un clic quando si usa `range`.     |
| `range`     | `{ min, max }`: l'intero intervallo è protetto (senza `frequency` l'ingresso usa `range[1]`). |
| `jobs`      | `{ nomeLavoro = gradoMinimo }`.                                                               |
| `onDuty`    | QBCore/Qbox: `true` = deve essere in servizio (default `Config.JobRequireOnDuty`).            |

```lua
Config.JobChannels = {
    -- frequenza singola; polizia e sceriffo, qualsiasi grado
    { id = 'police', label = 'Polizia', frequency = 1.00, jobs = { police = 0, sheriff = 0 } },
    -- solo grado 3 e superiori
    { id = 'police_cmd', label = 'Comando', frequency = 1.01, jobs = { police = 3 } },
    -- intero intervallo protetto (2.00 - 2.09); il pulsante "Entra" usa 2.05
    { id = 'ems', label = 'EMS', range = { 2.00, 2.09 }, frequency = 2.05, jobs = { ambulance = 0 } },
    -- deve essere in servizio (QBCore/Qbox)
    { id = 'mech', label = 'Meccanici', frequency = 3.00, jobs = { mechanic = 0 }, onDuty = true },
}
```

* Lavoro e grado sono letti dal **server** nel framework.
* L'accesso è imposto con `addChannelCheck` di pma-voice: digitare la frequenza, usare altri script o modificare il client **non** lo aggira. Le frequenze dei canali lavoro non hanno bisogno di essere nascoste.
* La NUI elenca nella scheda lavoro solo i canali che il giocatore può usare.
* Se lavoro o grado cambiano (eventi del framework più una rilettura ogni `Config.JobRecheckSeconds` secondi) il giocatore viene tolto dal canale e la lista si aggiorna.
* Con `range` ogni canale dell'intervallo è protetto (con 2 decimali `2.00-2.09` sono 10 canali; al massimo `Config.MaxChannelsPerRule`).

## Morte e script ambulanza

`Config.Death.mode` decide quando il giocatore è "morto": la radio non trasmette e la UI si chiude (la radio resta connessa).

| `mode`             | Come viene rilevata la morte                                                                                                                                                                                                                                                                                                                                                                      |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `'auto'` (default) | Controllo nativo, state bag, framework (ESX `esx:onPlayerDeath` / `esx:onPlayerSpawn`; QBCore/Qbox `isdead` / `inlaststand`), eventi di morte e rianimazione di `esx_ambulancejob`, `qbx_medical`, `qb-ambulancejob`, più gli export di `qbx_medical` (`IsDead`, `IsLaststand`), `ars_ambulancejob` (`isDead`) e `wasabi_ambulance` (`isPlayerDead`), provati solo se la risorsa è in esecuzione. |
| `'export'`         | `export = { resource = 'nome_risorsa', name = 'exportName' }`: l'export client deve restituire `true` da morti; in caso di errore si usa il controllo nativo.                                                                                                                                                                                                                                     |
| `'event'`          | `events = { death = { 'event:dead' }, revive = { 'event:revive' } }` (eventi client) più il controllo nativo.                                                                                                                                                                                                                                                                                     |
| `'statebag'`       | `statebag = { 'isDead', 'dead' }`: chiavi di `LocalPlayer.state` (true o un numero maggiore di 0) più il controllo nativo.                                                                                                                                                                                                                                                                        |
| `'native'`         | Solo `IsEntityDead`, `IsPedFatallyInjured`, `IsPlayerDead`.                                                                                                                                                                                                                                                                                                                                       |

{% hint style="warning" %}
I nomi degli export di `ars_ambulancejob` e `wasabi_ambulance` non sono verificati su quegli script. Se non rispondono, usa `'export'` o `'statebag'`.
{% endhint %}

* `blockWhenCuffed = true` blocca anche un giocatore ammanettato (state bag `cuffedStatebag`, `PlayerData.metadata.ishandcuffed` su QBCore/Qbox, `IsPedCuffed`).
* Se un evento di morte non è mai seguito da una rianimazione, il flag viene azzerato dopo 5 secondi con il ped vivo e nessun'altra fonte che dica morto. Viene azzerato anche al cambio di personaggio.
* Con la modalità `'event'` e il bridge standalone, uno script di morte "a terra" (ped vivo) che non espone né un export né una state bag viene sbloccato dopo 5 secondi: esponi un export o una state bag e usa la modalità `'export'` / `'statebag'`.

## Torri del segnale

Le torri si impostano in `Config.Signal.towers` (`{ name, coords, radius }`), le zone morte in `Config.Signal.deadZones`. Vedi [Configurazione](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/it/radio/configuration.md#segnale). Le sei torri della config predefinita sono esempi: sostituiscile con quelle della tua mappa.

## Prop radio personalizzato (ghiaccio\_radio\_props)

La risorsa companion `ghiaccio_radio_props` carica in streaming i prop radio personalizzati `ghiaccio_radio_a` e `ghiaccio_radio_b`.

* Avviala **prima** di `ghiaccio_radio`.
* `Config.PropModel = 'ghiaccio_radio_b'` è il default. Se il modello non viene trovato, la radio ripiega su `prop_cs_hand_radio` con un avviso in console (`Config.PropFallbackModel`).
* I prop personalizzati hanno l'origine alla base del corpo; la correzione per modello è in `Config.PropModelOffsets`.
* Un preset può usare un proprio modello con `prop.model`.

### Il tuo prop

1. Esporta il modello come `.ydr` (CodeWalker / Sollumz per Blender) con le sue texture `.ytd`.
2. Copia i file e il `.ytyp` in `ghiaccio_radio/stream/` (tutto ciò che sta in `stream/` viene caricato in streaming in automatico).
3. In `fxmanifest.lua` aggiungi `data_file 'DLC_ITYP_REQUEST' 'stream/tuo_prop.ytyp'`.
4. Imposta `Config.PropModel = 'tuo_prop'` (oppure `prop.model` sui singoli preset).
5. Regola `bone`, `pos` e `rot` dei preset e riavvia. Se il prop non compare, il `.ytyp` o i nomi del modello non corrispondono: aiuta `Config.Debug = true`.

## Altri script

Usa gli export e l'evento `ghiaccio_radio:client:use` descritti in [Comandi, tasti e permessi](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/it/radio/commands-and-permissions.md). Per esempio, scollega un giocatore quando viene arrestato:

```lua
exports.ghiaccio_radio:disconnect(src, true)   -- server
```


---

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