Description

Zerio Radio v3 is a radio system for FiveM roleplay servers. Players join frequencies, talk with push-to-talk, and deal with signal coverage, jammers, batteries and other radio realism. Radio audio runs on Zerio’s own voice server (zerio-voice), separate from pma-voice, so it works next to whatever proximity voice your server already uses.

Key Features

Radio

• Frequencies: Join any frequency, or only the ones you have access to. Listen to several channels at once and pick which one you transmit on.
• Push-to-talk: Its own keybind (Left Alt by default, configurable), with transmit and receive sounds that you can change per channel. A second keybind switches which channel you talk on.
• Clear audio: Radio voice is crisp and clear, and each speaker’s level is evened out so quiet microphones are heard.
• No-talk-over channels: Only one person can transmit at a time on channels where you turn this on.
• Member list: See who is on the channel and who is talking, with callsigns and an optional anonymous mode.
• Groups: Split a channel’s members into groups like “SWAT” or “Traffic”, picked by players or assigned by your scripts.
• Presets: Save a set of channels and join them all in one tap.
• Favorites and recents: Save frequencies and jump back to recently used ones.
• Private channels: Players can create temporary, password-protected channels.
• Messages and contacts: Send text messages to other players from the radio.
• Panic button: Sends an alert with a sound, screen effect and notification, and passes it on to dispatch.
• Radio scanner: Scan for nearby active channels and lock on to listen in.
• Player settings: Themes, light and dark mode, three radio skins, a microphone picker, and movable, resizable overlays.

Signal and Realism

• Radio towers: Coverage comes from towers you place. Towers can be shot down and repaired in-game.
• Repeaters: Players place repeaters to extend tower coverage.
• Jammers: Ground jammers and personal (backpack) jammers that kill signal in an area.
• Signal zones: Draw zones in the admin menu that force a signal level, from none (tunnels, bunkers) to full.
• Underground and weather: Signal drops underground and in bad weather.
• Audio degradation: Weak signal sounds worse and breaks up, both for the listener and the transmitter.
• Battery: Optional battery drain, battery swaps and charging stations.
• Ambient capture: Nearby gunshots and aircraft can be heard in transmissions.
• Audio leak: Players standing next to you hear your radio unless you wear an earpiece.

Coordination

• Man-down alerts: Warns, then alerts the channel when a player stays down. Turned on per channel.
• Unit GPS: Live map blips for players on the same channel. Turned on per channel.
• Channel patches: Link channels so they hear each other.
• Speakers: PA speakers placed in the world that play alert tones from dispatch (Coming in full release).
• Signal 100: Dispatch can reserve a channel for emergency traffic, so only dispatch can talk on it.
• Dispatch integrations: Panic and man-down alerts go to the dispatch console (Coming in full release) and to zerio-dispatch, ps-dispatch or lb-tablet. Other scripts can hook in through exports and events.

Items and Access

• Radio as an item: Players need the item to use the radio. Dropping or losing it disconnects them.
• Codeplug radios: Items like a police radio that only work on a fixed set of channels, and are the only way onto those channels.
• Access rules: Restrict channels by job, gang (QBCore, rcore_gangs, op-crime), ace permission, identifier or Discord role. Job channels can require players to be on duty.

Administration

• In-game admin menu (/radioadmin): Manage channels, players, towers, repeaters, jammers, signal zones, speakers and patches, and view a signal map.
• Customer portal: Set up and manage your voice server at portal.radio.zerio-scripts.com. The portal also has a web dispatch panel (Coming in full release).
• Upgrading from v2: Your v2 database tables and channels are upgraded on the first start. See Migrating from v2.

Requirements

Essential

• Database: oxmysql. Other SQL resources (mysql-async, ghmattimysql) are not supported.
• ox_lib: Used for keybinds, notifications, interaction prompts and callbacks.
• zerio-radio-prop: Streams the radio, repeater and vehicle radio props. It is included in the download and runs as its own resource.
• OneSync: Must be enabled.
• Zerio voice server: During the beta you run it yourself next to your FiveM server, see Self-Hosting. Hosting by Zerio is coming in the full release.
• Framework: QBCore, Qbox, ESX, or none (standalone).

Optional Dependencies

• ox_target or qb-target: Only if you switch jammer, repeater, tower repair or charging station interactions to "target".
• zdiscord or Badger_Discord_API: For channels restricted by Discord role.
• rcore_gangs or op-crime: For channels restricted to those gang systems.
• zerio-dispatch, ps-dispatch or lb-tablet: Panic and man-down alerts can also be sent to one of these.

Compatibility

Frameworks

• QBCore and Qbox: Detected automatically. Qbox runs through its QBCore compatibility layer.
• ESX: Detected automatically.
• Standalone: Used when no framework is found. There are no items; players open the radio with a command or keybind, and admin features use ace permissions.

Inventories

• ox_inventory: Version 2.47.0 or newer.
• qb-inventory: Through QBCore’s item functions.
• ESX inventory: ESX’s built-in inventory.

Voice

• zerio-radio does not replace your proximity voice. pma-voice, or any other proximity voice resource, keeps handling normal voice chat.
• zerio-radio turns off pma-voice’s own radio, radio UI and radio animation on start, so they don’t overlap.

Hardened Servers

zerio-radio works with every setting of sv_entityLockdown, sv_filterRequestControl and sv_stateBagStrictMode true.