Skip to content

Kivo Radio

Kivo Radio is a radio resource for servers that use pma-voice. Players tune a hand-held radio from a custom interface, talk to everyone on the same channel and see who is connected. As the server owner you can define job channels in the config, let selected players lock channels with a code, and decide whether people standing next to a radio can overhear it.

This documentation covers version 1.0.0.

  • Radio interface. A hand-held radio with a keypad for entering a channel, connect and disconnect buttons, a power knob, a volume slider and a member list for the current channel.
  • On-screen member list. While connected, a small panel shows the channel, the number of members and who is talking. Players can drag it, resize it or hide it.
  • Channels. Players enter a channel number such as 21.00 to join it.
  • Job channels. Preset channels with a label (for example “Police”), defined in config/jobChannels.lua. A job channel can be locked with a code.
  • Channel locks. Players with the right permission can lock the channel they are on with a code. Other players must enter the code to join.
  • Personalisation per player. Radio name, accent colour, radio size, member list size and visibility, and a list of favourite channels. Settings are remembered between sessions.
  • Proximity radio hearing. People standing within a few metres of a player who is receiving a transmission can hear it coming out of the radio.
  • Radio earpiece. An item that stops the radio from being overheard, so only its owner hears it. See Radio earpiece.
  • Hand-held radio animation. While the radio interface is open the player holds a radio prop and plays an animation. It can be switched off with a convar.
  • Demo mode. An optional setting, off by default, that lets you add fake players to your own channel roster to showcase the interface. See Demo mode.
Item Details
Voice pma-voice is required. It is listed as a dependency in fxmanifest.lua, so Kivo Radio needs it to be available.
Game build GTA V (game 'gta5'), fx_version 'cerulean'.
Framework Optional. qbx_core, qb-core and es_extended are detected automatically. Radio and proximity hearing work without one. The earpiece needs one.
Inventory Optional. ox_inventory is used when it is running. Every other inventory uses a per player fallback for the earpiece.
Database Kivo Radio needs no database tables. Servers on the default ESX inventory add two rows to the items table for the earpiece.
Build tools None. The interface is already built. You do not need Node.js.

Start pma-voice first. Start your framework and your inventory before Kivo Radio, so that automatic detection can see them.

ensure pma-voice
ensure qb-core # or qbx_core / es_extended
ensure ox_inventory # if you use it
ensure kivo-radio
Action How
Open or close the radio Use the radio item (when openRadioOnUse is on), or type /radio or /r.
Join a channel Enter the channel on the keypad or in the frequency field, then press connect. Or press connect next to a job or favourite channel.
Leave a channel Press the disconnect button.
Switch the radio off or on Click the power knob, or type /m or /mute.
Set a channel by command /f <number>, /freq <number> or /frequency <number>. Use 0 to leave the channel.
Change look and size Open the Settings tab in the radio.
Add a fake channel member /add <name>. Works only while demo mode is on. See Demo mode.

See Server convars for how to turn off /radio and /r.

File Purpose
config/channels.lua Whether players may lock channels, demo mode, and the timing of the periodic channel cleanup.
config/jobChannels.lua The preset job channels, with optional codes.
config/items.lua Item names, earpiece switch, framework and inventory overrides.
config/proximity.lua Range, volume and behaviour of proximity radio hearing.

All other files in the resource are part of the script and are not meant to be edited.

  1. Installation: folder, server.cfg lines, item definitions for each inventory and a first test.
  2. Configuration: every option in the four config files, including demo mode, plus the server convars and the permission for locking.
  3. Radio earpiece: how the earpiece works for players and for admins, and how it relates to proximity hearing.
  4. Frameworks and inventories: what is supported, how detection works, the override switches and what to do with unsupported setups.
  5. Examples and troubleshooting: ready-made configs, edge cases and fixes.

Back to the scripts index.