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

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 RoadPad.

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 disable 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 that you have entered your Discord webhooks correctly in the API.lua.

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.

Mouse stuck in the center when opening the pad

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

Pad doesn't open after reviving

Choose your ESX Version in config.lua.If you use an old ESX Ambulancejob or a custom one, change the ESX Version to 1.1 and try again.

Disable cryptocurrency

Go to config.lua and search for Config.Crypto, then set the value for the cryptocurrency you want to disable to false. Cryptocurrency config

Change the pad 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.

Car is locked after delivery

Edit the GiveCarKeys function in clientAPI.lua.

ESX
QBCore

GiveCarKeys (ESX)

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

GiveCarKeys (QBCore)

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

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

I forgot my pad PIN

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

Home

RoadPhone-Pro

RoadPhone

RoadPad

RoadCarPlay

RoadPods

RoadBackup