QBCore Frameworkqbcore.netCommunity docs
On this page

Updated 2026-10-11 · 2 min read

qb-radio: restricted channels and pma-voice

qb-radio provides a usable radio item and UI on top of pma-voice. Current source: commit e8caccf.

Install and configure

Start qb-core and pma-voice before qb-radio. Register the radio item in QBCore shared items and ensure your inventory delivers it. The server registers a QBCore usable-item handler which triggers the qb-radio:use client event.

The config.lua defines:

KeyDefaultPurpose
Config.RadioItem'radio'Configured radio item identifier
Config.RestrictedChannelsChannels 1–10 require police/ambulance on dutyJob/gang access rules
Config.MaxFrequency500Maximum configured radio frequency

Restrict a job or gang channel

-- Example configuration entries, within Config.RestrictedChannels:
[1] = { jobs = { 'police', 'ambulance' } },
[500] = { gangs = { 'ballas', 'vagos' } },

The real server.lua registers pma-voice:addChannelCheck for configured channels. A listed job must be on duty. A matching gang name can also satisfy its rule; do not assume the same duty requirement applies to gangs.

The client also checks access before joining channels. That client guard is for user experience; pma-voice server-side checks are the trust boundary.

Troubleshooting

SymptomWhat to verify
Radio does not openItem radio, usable-item registration and resource load order
Police cannot enter a restricted channelExact job name, onduty and configured channel
Gang radio blockedConfigured gang names and the player's active gang
Voice works but radio does notpma-voice integration, addChannelCheck and channel selection
Channel access bypassed after editsConfirm server-side pma-voice restriction is still installed and active

Update checklist

  1. Pin both qb-radio and pma-voice revisions.
  2. Test a job on duty, off duty, a permitted gang and an unauthorized player.
  3. Test joining a restricted channel after a restart and after job changes.
  4. Never rely on client-side radio restrictions alone.

Sources

Repository · Config · Server channel checks · Client UI

Related: voice-chat troubleshooting.

Found an issue in this guide?

Send the page URL, the affected example, and a source or reproduction to the site maintainer. For a server or resource problem, use the support guide.

On this page

Leonida RP server website built with RPWebsite
RPWebsite

Advertisement · RPWebsite

Want a website for your server?

Launch a site with live player status, rules, and a join button in minutes.

Build your website