[Preview Video]

Dependencies

ESX or QBCore Framework

[Discord]

izzy-radio — FiveM Radio System

📦 Overview

* 📻 Use the radio item from your inventory — menu opens with a handheld radio prop and animation

* 💼 Works with ESX and QBCore (auto picks whichever is running)

* 🎙️ Connect via pma-voice, mumble-voip, or SaltyChat

* 📡 Create custom frequencies, set passwords, add favorites

* 👥 See everyone on your channel; green highlight when someone is talking

* ⚠️ If you no longer have a radio in your inventory, you are kicked off the frequency automatically

👤 Profile area (what you see in the menu)

* ⚠️ **No in-game character mugshot.**

* ⚠️ **No Discord profile picture either.**

* Lists show only your **character name** (first and last name from ESX/QB data).

* Generic icons only (antenna / microphone) — no player face or avatar.

* Unlike radiov2, there is **no chat screen** or Discord avatars here — focus is frequency + voice + member list.

📻 How to open the radio

* ESX / QBCore — uses the item name from config (default: `radio`)

* ox_inventory example in `setup-files/items.txt` — add it the same way if you use ox

* Radio prop + phone animation when the menu opens

* Press **ESC** to close

* If you open it again too fast, you get a "wait 1 second" message

🔢 Connecting (Main screen — Members)

* Enter a frequency (MHz) → **Connect**

* If the channel has a password → password screen, connect when correct

* Wrong password / frequency not found → messages from `Config.Locale`

* While connected, the frequency field is locked; **Disconnect** to leave

* ⭐ **Star** — add or remove the current frequency from favorites (saved in the database)

* **Job frequencies (`Config.jobChannels`):** Certain MHz values are job-only (e.g. police, bcso, ambulance). Wrong job returns: “This frequency is dedicated to a specific job!”

📋 Channels tab

* **Channel list:** Player-created channels currently open on the server, quick connect from favorites (cable icon), and favorite / unfavorite from the list (star).

* **Create channel:** Frequency + optional password. Cannot create if that frequency already exists. You connect automatically after creating.

* Favorites are stored in **MySQL** (`izzy_radio` table) and reload after server restarts.

👥 Member list

* **Inside the radio (Members):** Names of everyone on the channel while connected. Green mic highlight when someone is talking.

* **Active Radio Member List (on-screen panel):** Shows while connected, includes member count, name list + talking highlight. Drag the panel to move it (position is saved) or minimize/expand it.

* `/resetradio` — resets the panel position.

🔊 Audio

* Volume **+ / −** on the radio graphic (while connected). Volume changes by **10%** (min / max warnings).

* Default: `defaultVolume` (0–100)

* pma-voice, mumble-voip, or SaltyChat handles the radio channel.

🎨 Interface

* Realistic radio design with a clock at the top.

* Channels and Members tabs.

* Red when disconnected, green when connected.

* Wi‑Fi / cable / star icons.

🌍 Language

* All messages in `Config.Locale` (English examples: connected, wrong password, volume min/max, job frequency, kicked for no radio, etc.).

* Add Turkish by translating the same table yourself — no built-in pack of 16 languages.

🛠️ Setup (server owners)

* **config.lua:** Framework (auto / esx / qb), `radioName`, `defaultVolume`, `RadioProp`, `LoopTime` (how often “who is talking” is checked), `jobChannels`, and `Locale`.

* **Required:**

  * `ox_lib`

  * `mysql-async` + `setup-files/sql.sql` (`izzy_radio` table)

  * Voice: `pma-voice`, `mumble-voip`, or `SaltyChat`

* **Commands:** `/resetradio` — resets the member list panel position

* **Item:** `setup-files/items.txt` — ox_inventory example; QB/ESX use usable `radio` item