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

# Changelog

## 1.1.0 (2026-11-19)

Miglioramenti a push-to-talk, gestione della morte, animazioni e prop. Aggiornamento consigliato a tutti.

### Push-to-talk e morte

* Nuovo `Config.Ptt.cooldown` (ms, default `750`, `0` = disattivato): anti-spam tra le trasmissioni, come il `radioDelay` del pma-voice di riferimento. La prima pressione è immediata; una pressione entro `cooldown` ms dal rilascio della trasmissione precedente viene rifiutata. `Config.Ptt.notifyBusy` opzionale. Un pma-voice con un proprio `radioDelay` si somma: imposta uno dei due a 0.
* Fix: una pressione rifiutata da morti / ammanettati o senza segnale non lascia più la state bag `radioActive` di pma-voice bloccata a `true`, cosa che poteva simulare una trasmissione al ritorno del segnale.
* Nuovo `Config.Death` (`mode` auto / export / event / statebag / native, export, eventi, chiavi state bag, opzione ammanettato). Morto = nessuna trasmissione, la UI si chiude. Il flag viene azzerato al caricamento / scarico del personaggio e dopo 5 s da vivo senza altre fonti di morte.
* La radio trasmette sempre tranne da morti o ammanettati (`Config.Death.blockWhenCuffed = true`). Con un'arma, la vera causa di "non riesco a parlare con la pistola" era la mancanza di riscontro: click del PTT e un piccolo segno TX (`Config.UI.txIndicator`) ora funzionano anche con la UI chiusa.
* Il flag di morte del bridge ESX segue l'uscita di sicurezza dopo 5 s da vivo e viene azzerato su `esx:playerLoaded`.

### Animazioni e prop

* Il prop personalizzato è il default: `Config.PropModel = 'ghiaccio_radio_b'` (risorsa `ghiaccio_radio_props`, da avviare prima di `ghiaccio_radio`), fallback a `prop_cs_hand_radio` con avviso in console se il modello manca, offset per modello `Config.PropModelOffsets`.
* Nuovo `Config.Anim.whileAiming` (default `true`): l'animazione di conversazione parte anche mentre si mira. `false` = in pausa mentre si mira (anche con il lock-on da controller).
* `Config.Anim.withWeapon = true` di default: i preset con mano destra passano a `default` (mano sinistra); nessuna animazione di attesa con un'arma. Se anche il preset di ripiego usa la mano destra, si usa il primo preset con osso 60309, altrimenti nessun prop.
* Fix ("prop in mano, nessuna animazione"): preset ripristinati 1:1 da Wave RP con la radio sull'osso 60309 (mano sinistra) per i preset `random@arrests` e 28422 con gli offset Wave per Police; radio in mano anche sui preset Ear.
* Nuovo `Config.Debug`: stampa nella console F8 gli eventi TaskPlayAnim, riapplicazione e dizionario mancante.
* Rimosso il creatore di animazioni (in gioco e codici di import): niente `/radioanimcreator`, niente animazioni personalizzate o pubblicate dal server. I giocatori scelgono tra `Config.AnimPresets`; una scelta vecchia che non esiste più ripiega su `Config.Anim.default`. La tabella `ghiaccio_radio_anims` delle vecchie installazioni resta intatta e inutilizzata.
* Nessuna animazione da morti, in ragdoll, in caduta, a nuoto o mentre si sale su un veicolo.

### Interfaccia

* Fix Esc: con la UI aperta (radio e menu animazioni F4) Esc chiude soltanto la UI e non apre più il menu di pausa.
* NUI della radio ridisegnata come un vero portatile: guscio texturizzato, impugnature in gomma, viti e clip da cintura, antenna, manopole zigrinate, LCD ambra retroilluminato con cifre a 7 segmenti, griglia dell'altoparlante, tasti in gomma, LED TX / RX, PTT che si abbassa mentre trasmetti. Il tastierino digita la frequenza (`*` = punto decimale, `#` = cancella, CONN connette).
* Schermo della radio ripristinato al precedente LCD (verde-grigio, frequenza grande, riga TX / segnale / VOL, riga del canale, barra del volume).
* La UI mantiene l'input del gioco (`Config.UI.keepInputWhileOpen`): il PTT di pma-voice funziona e l'animazione parte con la UI aperta. Mentre un campo di testo della NUI ha il focus tutti i controlli sono bloccati.
* Limite dell'etichetta dei preferiti allineato a 16 nella NUI.

### Nuove funzioni

* Pulsante di emergenza (SOS) con cooldown, opzione canale lavoro, blip, suono e avviso al lavoro in servizio (`Config.Emergency`).
* Nominativo impostato nelle Impostazioni, validato dal server, salvato per giocatore, mostrato nella lista membri (`Config.Callsign`), export `getCallsign` / `setCallsign`.
* Nuova cartella `stream/` per prop radio personalizzati (Blender).

### Altro

* Le nuove installazioni non creano più la tabella inutilizzata `ghiaccio_radio_anims`.

### Aggiornare dalla 1.0.0

* Sostituisci la cartella `ghiaccio_radio` e aggiungi `ghiaccio_radio_props`, avviata prima di `ghiaccio_radio`.
* Rivedi il tuo `config.lua`: nuovi `Config.Ptt`, `Config.Death`, `Config.Emergency`, `Config.Callsign`, `Config.Branding`, `Config.PropModel`, `Config.Anim.whileAiming`, `Config.Debug`.

## 1.0.0 (2026-11-15)

Prima release.

* Radio NUI per pma-voice (solo export ed eventi, pma-voice non viene mai modificato): frequenza digitata da tastiera, connessione / disconnessione, accensione, volume.
* Item radio (`ox_inventory`, `qb-inventory`, `qs-inventory`, inventario ESX) controllato dal server; perderlo scollega il giocatore.
* Canali privati per lavoro con grado minimo, imposti dal server con `addChannelCheck` di pma-voice; i cambi di lavoro / grado tolgono il giocatore dal canale.
* Lista membri (nome RP / nominativo, chi sta parlando), preferiti, impostazioni per giocatore salvate in oxmysql (migrazioni) o KVP.
* Segnale da torri configurabili, interni, sottoterra e zone morte; avviso di statico e blocco della trasmissione sotto una soglia. Nessuna batteria.
* Animazioni radio durante la trasmissione (preset Wave RP portati), menu `/radioanim` (F4).
* Framework: ESX Legacy, QBCore, Qbox, standalone. Lingue: italiano, inglese.
* Interfaccia adapter voce (`adapters/voice/`) per il futuro supporto a SaltyChat / Mumble.


---

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