SAFScriptsDocs

Troubleshooting

SAF Garage is coming soon. These docs describe the build that will ship.

On this page

Vehicles are saved to garage.json, not the database

oxmysql wasn't running when SAF Garage started. Make sure ensure oxmysql comes before ensure saf-garage, or set Config.Storage = 'oxmysql'. The console prints which storage it uses on start.

The plate is already taken

Config.Plates.Unique is on and another saved vehicle on the server already has that plate. Pick another, or set Unique = false if your server doesn't need unique plates.

A plate is refused

The text is shorter than MinLength, longer than MaxLength, has characters outside Allowed, or contains a word from BadWords.

An addon car shows a plain icon

Config.ImageUrl points at FiveM's pictures of base game vehicles. Addon cars don't have one there. Point ImageUrl at your own folder of pictures named by spawn code, or set it to false.

No keys after taking a car out

Your keys script isn't one SAF Garage knows. Replace Bridge.GiveKeys in custom/client/ (and the server one for scripts that give keys on the server). See Custom servers.

The car spawns with an empty tank

Your fuel script isn't one SAF Garage knows, so only the game value is set. Replace Bridge.SetFuel with your fuel script's export.

The car won't come out next to me

Every spawn point near you is blocked by another vehicle within Config.SpawnClearRadius. Move away from parked cars, or add more spawns to your garage spots.

The menu says I'm not at a garage

Config.SpawnMode is 'garages'. Go to a garage blip, or set it to 'anywhere'.

The last car disappears when I take out another

That is Config.ReplacePrevious. Set it to false to keep both.

Saved vehicles are gone after switching framework

Vehicles are saved under Bridge.GetIdentifier, which differs per framework. Moving from one framework to another changes the identifier, so old saves don't match.

SAF Scripts by San Andreas' Finest StoreDiscordsupprot@safrp.org

Not affiliated with or endorsed by Rockstar Games, Take-Two Interactive or Cfx.re.