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

# Changelog

## 1.1.0 (2026-11-19)

Push-to-talk, death handling, animation and prop improvements. Recommended update for everyone.

### Push-to-talk and death

* New `Config.Ptt.cooldown` (ms, default `750`, `0` = off): anti-spam between transmissions, same as the `radioDelay` of the reference pma-voice. The first press is instant; a press within `cooldown` ms after the previous transmission was released is refused. Optional `Config.Ptt.notifyBusy`. A pma-voice with its own `radioDelay` stacks with it: set one to 0.
* Fix: a press refused while dead / cuffed or without signal no longer leaves the pma-voice `radioActive` state bag stuck at `true`, which could fake a transmission once the signal came back.
* New `Config.Death` (`mode` auto / export / event / statebag / native, export, events, state bag keys, cuffed option). Dead = no transmission, UI closes. The flag is cleared on character load / unload and after 5 s alive with no other dead source.
* The radio transmits always except when dead or cuffed (`Config.Death.blockWhenCuffed = true`). With a weapon, the real cause of "I cannot talk with a pistol" was the missing feedback: PTT clicks and a small TX mark (`Config.UI.txIndicator`) now also play with the UI closed.
* ESX bridge death flag follows the 5 s alive safety exit and is cleared on `esx:playerLoaded`.

### Animations and prop

* Custom prop is the default: `Config.PropModel = 'ghiaccio_radio_b'` (resource `ghiaccio_radio_props`, start it before `ghiaccio_radio`), fallback to `prop_cs_hand_radio` with a console warning if the model is missing, per-model offset `Config.PropModelOffsets`.
* New `Config.Anim.whileAiming` (default `true`): the talk animation also plays while aiming. `false` = paused while aiming (also on controller lock-on).
* `Config.Anim.withWeapon = true` by default: right-hand presets fall back to `default` (left hand); no idle hold animation with a weapon. If the fallback preset is also right-hand, the first bone 60309 preset is used, otherwise no prop.
* Fix ("prop in hand, no animation"): presets restored 1:1 from Wave RP with the radio on bone 60309 (left hand) for the `random@arrests` presets and 28422 with the Wave offsets for Police; radio in hand also on the Ear presets.
* New `Config.Debug`: prints TaskPlayAnim, re-apply and missing dictionary events to the F8 console.
* Removed the animation creator (in game and import codes): no `/radioanimcreator`, no custom or server-published animations. Players choose among `Config.AnimPresets`; an old choice that no longer exists falls back to `Config.Anim.default`. The `ghiaccio_radio_anims` table of older installs is left untouched and unused.
* No animation while dead, ragdoll, falling, swimming or entering a vehicle.

### Interface

* Fix Esc: with the UI open (radio and F4 animation menu) Esc only closes the UI and no longer opens the pause menu.
* Radio NUI redrawn as a real handheld: textured shell, rubber grips, screws and belt clip, antenna, knurled knobs, amber backlit LCD with 7-segment digits, speaker grille, rubber keys, TX / RX LED, PTT that moves in while transmitting. The keypad types the frequency (`*` = decimal point, `#` = delete, CONN connects).
* Radio screen restored to the previous LCD (green-grey, large frequency, TX / signal / VOL line, channel line, volume bar).
* The UI keeps the game input (`Config.UI.keepInputWhileOpen`): the pma-voice PTT works and the talk animation plays with the UI open. While a NUI text field has the focus all controls are blocked.
* Favorite label limit aligned to 16 in the NUI.

### New features

* Emergency button (SOS) with cooldown, job-channel option, blip, sound and on-duty job alert (`Config.Emergency`).
* Callsign set in Settings, validated by the server, saved per player, shown in the member list (`Config.Callsign`), exports `getCallsign` / `setCallsign`.
* New `stream/` folder for custom (Blender) radio props.

### Other

* New installs no longer create the unused `ghiaccio_radio_anims` table.

### Updating from 1.0.0

* Replace the `ghiaccio_radio` folder and add `ghiaccio_radio_props`, started before `ghiaccio_radio`.
* Review your `config.lua`: new `Config.Ptt`, `Config.Death`, `Config.Emergency`, `Config.Callsign`, `Config.Branding`, `Config.PropModel`, `Config.Anim.whileAiming`, `Config.Debug`.

## 1.0.0 (2026-11-15)

First release.

* NUI radio for pma-voice (exports and events only, pma-voice is never modified): frequency typed on the keyboard, connect / disconnect, power, volume.
* Radio item (`ox_inventory`, `qb-inventory`, `qs-inventory`, ESX inventory) checked by the server; losing it disconnects the player.
* Private job channels with minimum grade, enforced by the server with pma-voice `addChannelCheck`; job / grade changes remove the player from the channel.
* Member list (RP name / callsign, who is talking), favorites, per-player settings saved to oxmysql (migrations) or KVP.
* Signal from configurable towers, interiors, underground and dead zones; static warning and transmit block below a threshold. No battery.
* Radio animations while transmitting (Wave RP presets ported), `/radioanim` menu (F4).
* Frameworks: ESX Legacy, QBCore, Qbox, standalone. Languages: Italian, English.
* Voice adapter interface (`adapters/voice/`) for future SaltyChat / Mumble support.


---

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