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

# Radio

**ghiaccio\_radio v1.1.0** is a realistic handheld **NUI radio for pma-voice**: frequencies typed on the keyboard, private job channels with grade enforced by the server, member list, tower-based signal, emergency button, callsigns and configurable radio animations, for **ESX Legacy, QBCore, Qbox and standalone**.

|                |                                                                                                                                          |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Price**      | 15 € / $17.99 (EUR includes VAT for Italy, USD base price)                                                                               |
| **Store**      | [Buy on the official site](https://www.ghiaccioev.eu/scripts/ghiaccio-radio)                                                             |
| **Frameworks** | ESX Legacy, QBCore, Qbox, standalone (auto-detected)                                                                                     |
| **Requires**   | `pma-voice` (mandatory, never modified). Companion resource `ghiaccio_radio_props`, started before `ghiaccio_radio`. `oxmysql` optional. |
| **Delivery**   | Cfx.re Asset Escrow ([portal.cfx.re](https://portal.cfx.re) > Granted Assets)                                                            |
| **Languages**  | English, Italian (each player can choose)                                                                                                |

## Features

* **Handheld NUI radio**: textured shell, rubber grips, antenna, backlit LCD with 7-segment digits, keypad, TX / RX LED and a PTT that moves in while you transmit.
* **Typed frequencies**: the player types the frequency on the keyboard (for example `101.50`) and presses CONNECT. Power button, volume and favorite slots (8 by default).
* **Private job channels**: one frequency or a whole range per job, with a minimum grade and an optional on-duty requirement. Enforced by the **server** with pma-voice `addChannelCheck`: typing the frequency or editing the client does not bypass it.
* **Member list**: who is on the channel and who is talking, with character name, steam name or server id and an optional callsign.
* **Signal**: bars from the distance to configurable towers, weakened by interiors, underground and dead zones. Static and a transmit block below configurable thresholds. No battery.
* **Emergency button (SOS)**: double press on the orange button alerts everybody on the frequency with callsign, street, blip and sound; optional alert to every on-duty player of the sender's job.
* **Radio animations**: `/radioanim` menu (F4) with configurable presets, radio prop in hand, no duplicated props, animation re-applied if the game cancels it.
* **Custom radio prop** (companion resource `ghiaccio_radio_props`), with automatic fallback to the GTA native prop.
* **Radio item**: `ox_inventory`, `qb-inventory`, `qs-inventory` or ESX inventory, checked by the server on open, power on, connect and periodically.
* **Death and cuffed handling**: no transmission while dead or cuffed, with integrations for common ambulance scripts.
* **PTT anti-spam cooldown** (`Config.Ptt.cooldown`) and **rate limits** on every network request.
* **Storage**: per player (Rockstar license) in `oxmysql` with automatic migrations, or in the server KVP when `oxmysql` is missing.
* **Exports** on client and server, and a small voice adapter interface for other voice systems.

Next step: [Installation](https://ghiaccioscripts.gitbook.io/ghiaccioscripts-docs/radio/installation.md).


---

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