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 Business, then copy an example job and change: job, name, shortName, icon, number, openingHours, minGradeToManage and the coords. Service app jobs config

Add my own notifications

In ClientAPI.lua, find sendNotification(text) and replace Bridge.Notification.Show(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 / Qbox

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 Ambulancejob or a custom one, go to bridge/modules/events/shared.lua and change the PlayerSpawn events from your framework you using to the custom event. 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.

In config.lua, set the locale 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 ( only without metadata )

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 ( metadata )

Go to the metadata description.

OxInventory snippets

If you don’t use metadata with OxInventory, use these snippets to block/unblock the phone based on inventory.The following example items block will block/unblock the phone based on inventory.

OxInventory items

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

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

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

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

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

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

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

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

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

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

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

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

Home

RoadPhone-Pro

RoadPhone

RoadPad

RoadCarPlay

RoadPods

RoadBackup

All Commands

Fivemanage Setup