# Radio

<figure><img src="https://3936778620-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPLI7NdIesJTaEUHH6a2U%2Fuploads%2FDYcoOMsOFA4sUw2vTglY%2Fimage.png?alt=media&#x26;token=a9fb3389-a874-4cfc-b64c-3bc892c4b0fa" alt=""><figcaption></figcaption></figure>

## Categories

This system allows the configuration of multiple **radio categories**, each containing a list of individual **frequencies** (also referred to as unit channels). These are used to organize and manage communication between different units like EMS, police departments, and special forces.

### Configuration Structure

The `Config.Multifrec` table defines the structure of all available categories and their respective frequencies.

```lua
Config.Multifrec = {
    ["CATEGORY_NAME"] = {
        "FREQUENCY_NAME_1",
        "FREQUENCY_NAME_2",
        ...
    },
    ...
}
```

Each category represents a tab (column) in the radio UI, and each frequency appears as a row within that category.

## Shortcuts

<figure><img src="https://3936778620-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPLI7NdIesJTaEUHH6a2U%2Fuploads%2FU3addeKNMTDRJ8k4gf55%2Fimage.png?alt=media&#x26;token=e4d581a1-5870-4350-bf49-06f13f62fa41" alt="" width="507"><figcaption></figcaption></figure>

The `Config.BindFreqs` table defines keybindings for quick access to one or multiple frequencies. These shortcuts allow players to quickly transmit to certain units or categories without manually switching channels.

### Configuration Structure

```lua
Config.BindFreqs = {
    ["shortcut_key"] = { "frequency_or_category", ... }
}
```

* **Left (key)**: The name of the bind (e.g., `talk-to-central`). In the UI, it's displayed by replacing dashes (`-`) with spaces and converting the text to uppercase, so `talk-to-central` becomes **TALK TO CENTRAL**.
* **Right (value)**: A list of **frequencies or category names** that will be targeted when the shortcut is triggered. When the assigned key is pressed, the player will broadcast to all frequencies listed here.

## Frequences users

<figure><img src="https://3936778620-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPLI7NdIesJTaEUHH6a2U%2Fuploads%2FyJ6mZWdO8xm0n0wSoYSo%2Fimage.png?alt=media&#x26;token=a72c0115-c288-4bc1-9b23-a3eeda047f8b" alt=""><figcaption></figcaption></figure>

Users are displayed with six sections, which are defined as follows:

* **Availability**: Green if the user is marked as available in F7, red if marked as busy.
* **Name**: The agent’s name followed by their badge number.
* **Grade** (optional): The name of the agent’s grade or rank.
* **Icons** (optional): Icons representing all divisions the agent belongs to.
* **Mute** (optional): Indicates if the agent is muted.
* **Talking** (optional): Indicates if the agent is currently speaking.

## Move feature :smile:

Here, you can also move users between frequencies, similar to how it's done in platforms like Discord.

<figure><img src="https://3936778620-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPLI7NdIesJTaEUHH6a2U%2Fuploads%2FwsIFhLb4VaZaMy7PdPyA%2F2025-06-2601-08-44-ezgif.com-video-to-gif-converter.gif?alt=media&#x26;token=34fe9144-fce5-48a5-a042-9c214a8f5324" alt=""><figcaption></figcaption></figure>
