Installation

3 min readUpdated 2 weeks ago

Overview

ML Radio adds handset radios on pma-voice, with signal that depends on antennas, jammers, hackable towers, broadcast stations limited to jobs, speaker zones and placeable stereos. Placed antennas, jammers and stereos are saved to the database.

Quick Start

  1. Download from CFX Portal
  2. Extract to your resources folder as ml_radio
  3. Add to server.cfg:
server.cfg
1ensure oxmysql
2ensure ox_lib
3ensure pma-voice
4ensure ml_bridge
5ensure xsound
6ensure ml_radio
Load Order

ml_radio must start AFTER ml_bridge and pma-voice.

Dual Channel Needs The Bundled pma-voice

The download ships a pma-voice folder next to ml_radio. It is pma-voice with a second radio channel added, which is what lets the handset talk on one frequency while monitoring another. Install it in place of your current pma-voice, or port the setSecondRadioChannel export into your own copy. On stock pma-voice the dual channel switches itself off, prints one warning and everything else runs unchanged.

Database

Tables are created automatically on first start:

  • ml_radio_antennas: antennas placed by players, with position, health and lockout
  • ml_radio_fixed_antennas: health and lockout of the fixed towers
  • ml_radio_jammers: placed jammers, with position, power and health
  • ml_radio_data: key and value store, used for placed stereos

The radio state of each handset lives in its item metadata, so a handset keeps its frequencies, callsign and charge when it changes hands.

_INSTALL/sql.sql holds the same four statements for anyone who prefers to create them by hand.

Item Registration

Register the following items in your inventory system. Ready-to-paste definitions ship in _INSTALL/items.lua, and _INSTALL/ox_items.txt is pre-formatted for ox_inventory/data/items.lua:

  • radio: Handset
  • radio_jammer: Placeable jamming tower
  • radio_antenna_small / radio_antenna_medium / radio_antenna_large: Placeable antennas
  • boombox / pa_speaker: Placeable stereos
  • battery_pack: Battery, recharges handsets and jammers
  • electronic_kit / metal_scrap: Repair materials
  • hacking_device: Required to hack antennas

Icons for all of them ship in _INSTALL/inventory_images/. Copy them into ox_inventory/web/images/.

Handset and consumable names live in Config.Items. Antenna and jammer names live with their models in Config.Antenna.tiers and Config.Jammer.tiers. Stereo names live in Config.StereoProps.items.

Props Ship With The Script

The custom tower model used by the large antenna and the fixed towers is streamed from the resource itself. Everything else uses base-game props. Nothing extra to install.

Verify

In game, use a radio item from your inventory and tune a frequency near a tower. The signal bars read above zero.

  • Radio opens but nobody hears voice: check that pma-voice is running and started before ml_radio.
  • Stations and boomboxes play no music: xsound is missing or Config.Broadcast.streamingProvider = 'none'. Voice radio is unaffected.
  • Using the item does nothing: the item is not registered in your inventory, or its name does not match Config.Items.radios.
  • "No signal" everywhere: signal starts at Config.Signal.baseSignalWithoutAntenna = 0; coverage comes from fixed towers and placed antennas. Check the tower coords are loaded.
  • Nothing posts to Discord: the webhooks in server/config_server.lua ship as the INSERT_WEBHOOK_LINK_HERE placeholder; fill in real URLs.
Radio Installation, FiveM Docs | Micio Mods