Skip to main content
Use this page to quickly find answers to common questions and fixes. If something is missing, reach out on our Discord server.
Please post a detailed bug report in our Discord channel #errors. Include steps to reproduce, screenshots, and the FiveM server console output if possible. We’ll try to fix it as soon as we can.
No. RoadCarRadio creates every table it needs on start and prints:
That applies to updates as well — new tables and new columns are added automatically. roadcarradio.sql is still shipped if you prefer to import the schema by hand, but you never need to.If you don’t see that line, check the console for [RoadCarRadio] Database: warnings — they name the table that failed.
The resource folder, the items and the exports were all renamed. If another script on your server talks to it, it needs updating:
Your installed vehicles migrate themselves. On the first start the old roadshop_carplay_cars table is copied over and renamed to roadshop_carplay_cars_migrated. Nothing to do by hand.

Full migration table

Including commands and config keys
Songs that players submit through the Music app have to be approved before they land in the library. The approval permission is handed out with /carmusic-verify:
  • 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
The command is ACE-restricted — run it from the server console, or give yourself the ACE:
server.cfg

All Commands

Full command reference for RoadCarRadio
A fresh library only fills up once songs have been submitted and approved. Work through this checklist:
1

Add songs through the Music app

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

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.
Want to skip the approval step entirely? Set Config.SkipMusicNeedAccept = true — submitted songs then go straight into the library.Rather bring your own catalog? See the Custom Music API.
Make sure you’re using our xSound version, and start xSound before RoadCarRadio in your server.cfg.
Checklist
  • Confirm Config.AudioLibrary matches what you actually run — 'xsound' or 'mxsurround'
  • 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)
  • Music is positional: you have to be near the vehicle. Config.DefaultMusicRange controls how near
If your loading screen uses YouTube and you muted it there, the sound is muted everywhere. Unmute the loading screen.
It waits for continuous reversing before it opens, so a quick tap of S does not trigger it. If it still feels twitchy, raise the delay:
config.lua
Set it to 0 to switch instantly, or turn the automatic off entirely with autoWhenReversing = false — the keybind still works.
Switch on diagnostics and let the resource tell you why:
config.lua
Then get into the vehicle and run /rearcamdebug. It prints to your own F8 console which condition is blocking — vehicle type, driver seat, install status or first person.

Reading the output

What each line means
Open /public/static/config/config.json, find AppStore, and remove the block for the app(s) you want gone. The home screen grid re-flows on its own.The same file is where you rename apps and swap their icons — nothing in the app list is hard-coded.
Every vehicle keeps its own background, stored per licence plate. In Settings → Wallpaper a player can either pick an included image, paste a link to their own, or build a gradient in the editor — linear, radial or conic, with up to eight colour stops.To ship your own images, drop them into public/img/backgrounds/ and add them to backgrounds in public/static/config/config.json.
They are not — every game locks itself as soon as the vehicle moves, and only unlocks once it stops. Coming back from a lock goes to a paused state rather than straight back into play, so nothing starts moving on screen while the driver is still looking at the road.

​
Still stuck?

Installation

Requirements, setup and every config option

Common Issues

Problems that affect all RoadShop resources