rxRadio

rxRadio is a modernized fork of x-radiolist for FiveM servers using pma-voice. It's a fully standalone resource that provides a live radio member list, active speaker indicators, custom radio display names, and a fully rebuilt React + TypeScript NUI with editable, persistent HUD positioning alongside a complete rewrite of several key functions to improve performance & stability.

This resource is a fork of x-radiolist.

Features

• Live radio member list driven by pma-voice
• Active speaking indicator for radio users
• Beautified channel header with frequency, channel name, and online count
• Player-editable radio HUD position and scale
• Robust adaptive scaling defaults, ensuring compatibility with all resolutions
• Client-local layout persistence for the radio HUD
• /callsign support for custom player radio names
• Optional RP-name support through ESX or QBCore
• Optional QBCore on-duty callsign enforcement
• Optional server ID display next to names
• Configurable named radio channels
• Optional access restriction by job/gang/group
• ox_lib notifications for UI/name/channel actions

Dependencies

Start these before rxRadio:

• ox_lib
• pma-voice

Installation

1. Download a release from the right hand side.
2. Place the resource in your server resources folder as rxRadio.
3. Ensure dependencies start before it.
4. Add ensure rxRadio to your server config.

Example:

ensure ox_lib
ensure pma-voice
ensure rxRadio

Commands

Default commands from the current config:

• /ch [channel] Joins a radio frequency. Use /ch 0 to leave radio.
• /radiodisplay Toggles the radio list UI.
• /radiodisplayedit Enables or disables HUD edit mode.
• /radiodisplayreset Resets the saved HUD layout back to the default profile.
• /callsign [name] Sets your radio display name when custom names are enabled.

Edit mode finishes through the configured keybind:

• RETURN Saves edited position & size
• ESC Discards edited position & size restoring the configured defaults.

Developing From Source

If you are working from source:

1. Install Bun.
2. Open the repository root.
3. Install dependencies with bun install.
4. Use the scripts below depending on whether you are developing, validating, or packaging.

Available scripts

• bun run dev Starts the Vite dev server for working on the React NUI in a browser.
• bun run build Runs TypeScript compilation and builds the production NUI into web/dist for FiveM.
• bun run lint Runs ESLint across the frontend source.
• bun run preview Serves the built frontend locally for previewing the production bundle.
• bun run packaging -- <version> Builds the frontend and creates a drag-and-drop release zip using scripts/create-release.sh.

Framework Notes

Although by default rxRadio is a standalone resource

When Config.UseRPName is enabled:

• ESX uses xPlayer.getName() for RP names
• QBCore uses character first/last name for RP names
• QBCore can force job callsigns onto the radio name while on duty for jobs listed in Config.JobsWithCallsign

If RP names are disabled, the resource falls back to the player server name unless the player has set a custom radio name.

License

This repository still includes the upstream LICENSE. Review it before redistributing modified versions of the resource.