Troubleshooting

Failed to load audiobank

You may see this error while jg-mechanic is starting:

failed to load audiobank 'audiodirectory/jg_mechanic'

The JG Mechanic sound bank didn't finish loading before FiveM timed out. Disable the script's sounds so it can start without the sound bank.

1. Open config/config.lua.

2. Set Config.DisableSound to true:

   Config.DisableSound = true

3. Fully restart your server.

Respray particles fail to load

You may see this error when installing a respray order:

failed to load ptFxName 'core'

FiveM couldn't load the particle asset used for the spray mist. JG Mechanic now continues the installation without particles if the asset doesn't load within three seconds.

To disable the mist, add or replace this block in config/config.lua:

Config.ResprayPtfx = {
  enabled = false,
  dict = "core",
  name = "ent_sht_steam"
}

This disables only the particles. The spray can, animation, installation time and vehicle colour change still work.

To use a different effect, set enabled = true and change dict and name to a matching particle dictionary and effect that work on your server. The values above are the defaults. Existing configs without this block keep the default effect.

Restart jg-mechanic and install a respray order. With particles disabled, the order should complete without spray mist or a particle-loading error.

SQL error while starting JG Mechanic

You may see an error containing:

[SQL ERROR]

JG Mechanic tries to make the required database changes automatically. In rare cases this fails, and you need to make the changes manually.

1. Open jg-mechanic/install/database.
2. Run run.sql in your database software, such as phpMyAdmin or HeidiSQL.