# Radio System

<figure><img src="https://3505378470-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmOhVROw9E3kpmAG3JYVe%2Fuploads%2F30uxQrgICal01H5Bmyty%2Fradio.png?alt=media&#x26;token=98544df4-818a-45b8-89ce-521647559150" alt=""><figcaption></figcaption></figure>

#### 📖 Radio System — General Logic

This is a **handheld radio/walkie interface**. Players can join a frequency, use push-to-talk (PTT) to transmit voice, and manage channels via **Main / Channels / Members / Favorites / Settings** tabs. It includes features like incognito mode, dark/light theme, UI scaling, and custom colors.

***

### How It Works

1. Player must have the **`radio`** item to access the UI.
2. Enter a frequency or select one from the list → **Connect**.
3. Use the **PTT key (SpeakKey)** to talk; connected players appear in the **Members** list.
4. Add channels to **Favorites** for quick access; password-protected channels can be saved with Name/Password.
5. In **Settings**, players can toggle incognito mode (hide from member list), change theme, resize UI, choose colors, and enable/disable radio animation.

***

### In-Game Behavior

* **ItemCheckLoop**: If enabled, losing the radio item disconnects the player from channels.
* **RestrictedChannels**: Only specific **jobs/gangs** can join designated channels (e.g., channels 1–10 for police/ambulance).
* **VoiceSystem**: Integrated with `pma-voice` (or other voice systems) to handle join/leave logic.
* **Notify**: If enabled, uses your server’s notification system in addition to the built-in radio alerts.
* **RadioAnimation**: Plays a hand/phone animation while transmitting if enabled.
