FAQ

I found a bug — what should I do?

Please post a detailed bug report in our Discord channel #errors. Include steps to reproduce, screenshots, and logs if possible. We’ll try to fix it as soon as we can.

How do I give myself or others permission to approve music?

Songs that players submit through the Music app have to be approved before they land in the library. The approval permission is handed out in-game with /music-verify:

/music-verify PLAYERID

The command toggles: no permission → grants it, already has it → revokes it
PLAYERID is the server ID of the player (visible in the player list / txAdmin)
Only administrators can run the command

All Commands

Full command reference including verification commands

My Music Library is empty — what do I do?

A fresh library only fills up once songs have been submitted and approved. Work through this checklist:

Add songs through the Music app

Players submit songs directly in the app. They land in the pending queue first, not in the library.

Approve the pending songs

Someone with the music approval permission (see above) has to approve them. Once approved, they show up in the library for everyone.

I don’t hear music in the Music app

Make sure you’re using our xSound version and start xSound before RoadPhone.

Checklist

Clear your client cache.
Check that GTA music is turned on.
Verify your Windows volume mixer isn’t at 0% (this is independent of FiveM).

If your loading screen uses YouTube and you muted it there, the sound is muted everywhere. Unmute the loading screen.

How can I remove apps?

Open /public/static/config/config.json, search for AppStore, and remove the block for the app(s) you want to disable. Remove apps from AppStore config

Images / Videos are not saved in the Gallery

Make sure you entered your Fivemanage MEDIA KEY correctly in API.lua.

Fivemanage Setup

See the complete setup guide for Fivemanage configuration

Add jobs to the Service App / Add dispatches

Open /public/static/config/config.json, search for Service, then copy an example job and change: number, name, img, jobname, and the coords. Service app jobs config

On start it shows ESX nil

Follow the instructions in config.lua (ESX init). ESX nil fix

Add my own notifications

In ClientAPI.lua, find sendNotification(text) and replace ESX.ShowNotification(text) with your notification trigger.

Talk on the radio and voice at the same time

If you use SaltyChat, set EnableHardCoreMode to false in your SaltyChat config.

Mouse stuck in the center when opening the phone

Go to Settings → Keyboard/Mouse → Mouse Input Method → Raw Input. Raw input setting

Notify EMS when someone is down

ESX
QBCore

This example refers to esx-ambulancejob. If you use a different script, adapt accordingly.

In esx_ambulancejob/client/main.lua, find SendDistressSignal() and replace:

SendDistressSignal()

function SendDistressSignal()
    exports['roadphone']:sendDispatch("Injured person", "ambulance", nil)
end

This example refers to qb-ambulancejob. If you use a different script, adapt accordingly.

In qb-ambulancejob/client/dead.lua, search for “hospital:server:ambulanceAlert” and replace with:

qb-ambulancejob

exports['roadphone']:sendDispatch("Injured person", "ambulance", nil)

Phone doesn't open after reviving

If you’re using an old ESX Ambulancejob or a custom one, change Config.ESXplayerSpawnEvent to playerSpawned. Spawn event setting

Disable cryptocurrency

In config.lua, set Config.Crypto = false.

Lock radio channels

In config.lua, configure Config.lockedRadioChannels with the channel list. Locked radio channels config

Change the phone language

App names are excluded from translation. To localize app names, change them in config.json.

ESX
QBCore

In config.lua, set the locale to your preferred language.

In fxmanifest.lua, find the locales/ path and change it to your preferred language.

SaltyChat: Radio doesn’t work

If you have SaltyRadio on the server, remove it.
If not, try our SaltyChat version.

Car is locked after delivery

Edit the GiveCarKeys function in clientAPI.lua.

ESX
QBCore

GiveCarKeys (ESX)

function GiveCarKeys(plate, model)
  TriggerEvent("vehiclekeys:client:SetOwner", plate)
end

GiveCarKeys (QBCore)

function GiveCarKeys(plate, model)
  TriggerEvent("qb-vehiclekeys:client:AddKeys", plate)
end

Disable car delivery

Open /public/static/config/config.json and set DeliverCar to false.

GetExtendedPlayers error (es_extended 1.1/1.2)

Add this to es_extended/server/functions.lua:

GetExtendedPlayers helper

ESX.GetExtendedPlayers = function(key, val)
    local xPlayers = {}
    for _, v in pairs(ESX.Players) do
        if key then
            if (key == 'job' and v.job.name == val) or v[key] == val or v.variables[key] == val then
                xPlayers[#xPlayers+1] = v
            end
        else
            xPlayers[#xPlayers+1] = v
        end
    end
    return xPlayers
end

Problems with VideoCall

Clear your client cache.
On the first video call after clearing the cache, accept the F8 prompt to allow recording.
Accept the Windows Defender warning when it appears.

Use a fixed prefix for phone numbers

Edit server/serverAPI.lua function getPhoneRandomNumber. If you change the prefix to more than two digits, also update the string.format.

Phone number prefix

function getPhoneRandomNumber()
  local prefix = 49
  local numBase = math.random(1000000, 9999999) -- 7 digits
  local num = string.format("%02d%07d", prefix, numBase)
  return num
end

-- Output example: 497649867

I forgot my phone PIN

Clear your cache once — this will remove the PIN lock. Clear cache to reset PIN

Add jobs to the Jobs App

Open /public/static/config/config.json, search for JobsApp, then copy an example and change the name, coords, and icon. Jobs App config example

Finding IconsVisit Iconify, search for an icon, choose Vue + Components, and copy the icon name from the shown code.

OxInventory snippets

The following example items block will block/unblock the phone based on inventory.

OxInventory items

['phone'] = {
    label = 'Handy',
    weight = 190,
    stack = false,
    consume = 0,
    client = {
        add = function(total)
            if total > 0 then
                exports['roadphone']:unblockPhone()
            end
        end,

        remove = function(total)
            if total < 1 then
                exports['roadphone']:blockPhone()
            end
        end
    }
},

['purple_phone'] = {
    label = 'Handy',
    weight = 190,
    stack = false,
    consume = 0,
    client = {
        add = function(total)
            if total > 0 then
                exports['roadphone']:unblockPhone()
            end
        end,

        remove = function(total)
            if total < 1 then
                exports['roadphone']:blockPhone()
            end
        end
    }
},

['green_phone'] = {
    label = 'Handy',
    weight = 190,
    stack = false,
    consume = 0,
    client = {
        add = function(total)
            if total > 0 then
                exports['roadphone']:unblockPhone()
            end
        end,

        remove = function(total)
            if total < 1 then
                exports['roadphone']:blockPhone()
            end
        end
    }
},

['red_phone'] = {
    label = 'Handy',
    weight = 190,
    stack = false,
    consume = 0,
    client = {
        add = function(total)
            if total > 0 then
                exports['roadphone']:unblockPhone()
            end
        end,

        remove = function(total)
            if total < 1 then
                exports['roadphone']:blockPhone()
            end
        end
    }
},

['blue_phone'] = {
    label = 'Handy',
    weight = 190,
    stack = false,
    consume = 0,
    client = {
        add = function(total)
            if total > 0 then
                exports['roadphone']:unblockPhone()
            end
        end,

        remove = function(total)
            if total < 1 then
                exports['roadphone']:blockPhone()
            end
        end
    }
},

['black_phone'] = {
    label = 'Handy',
    weight = 190,
    stack = false,
    consume = 0,
    client = {
        add = function(total)
            if total > 0 then
                exports['roadphone']:unblockPhone()
            end
        end,

        remove = function(total)
            if total < 1 then
                exports['roadphone']:blockPhone()
            end
        end
    }
},

Home

RoadPhone-Pro

RoadPhone

RoadPad

RoadCarPlay

RoadPods

RoadBackup

All Commands

Fivemanage Setup