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:
| Key | Default | Purpose |
|---|---|---|
Config.RadioItem | 'radio' | Configured radio item identifier |
Config.RestrictedChannels | Channels 1–10 require police/ambulance on duty | Job/gang access rules |
Config.MaxFrequency | 500 | Maximum 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
| Symptom | What to verify |
|---|---|
| Radio does not open | Item radio, usable-item registration and resource load order |
| Police cannot enter a restricted channel | Exact job name, onduty and configured channel |
| Gang radio blocked | Configured gang names and the player's active gang |
| Voice works but radio does not | pma-voice integration, addChannelCheck and channel selection |
| Channel access bypassed after edits | Confirm server-side pma-voice restriction is still installed and active |
Update checklist
- Pin both
qb-radioandpma-voicerevisions. - Test a job on duty, off duty, a permitted gang and an unauthorized player.
- Test joining a restricted channel after a restart and after job changes.
- 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.
progressbar
Current QBCore progressbar reference: Functions.Progressbar, direct progressbar exports, cancellation, animations and common errors.
qb-target
Use qb-target with BoxZone, CircleZone, PolyZone and NPC interactions. Add job and item conditions, clean up registrations and diagnose invisible targets.
