Tuning
JG Mechanic includes custom tuning functionality, such as engine swaps, custom drivetrains, traction options and more. These options aren't available as part of the base GTA game.
These options directly modify the vehicle's handling file, which can be complex. We provide a set of default custom tuning options that will appeal to most players, but you may want to create your own. If you don't understand how handling files work, you'll likely run into problems.
All customisation is done in config/config.tuning.lua. This page is an FAQ for that file.
I did an engine swap, why is my vehicle slower?
The script isn't broken. This functionality modifies the vehicle's handling file, and some vehicles can have wildly different handling files. The default configured handling changes therefore don't work well on all vehicles. They've been specifically tuned for the vanilla GTA vehicles.
This typically happens with addon vehicles, when their handling file is unbalanced. By default, our engine swaps overwrite certain handling values (see below). If some of the values modified as part of the swap were set too high in the vehicle's base handling file to compensate for other values that were set improperly, this can actually make your vehicle slower.
In these cases, it's unfortunately up to you to modify config.tuning.lua to make the handling changes more appropriate for the vehicles in your server. Though what we'd recommend more is improving the handling files of the addon vehicles in your server.
What do the different config options mean?
| Parameter | Explanation |
|---|---|
| name | The name of the modification that will be shown in the tablet. |
| info (optional) | Additional info that shows in the UI when the mechanic clicks the info icon while selecting an upgrade. Use it to warn mechanics about vehicles an upgrade shouldn't be applied to, or to share results from your testing of handling values. |
| itemName | For mechanics set up to use an item for upgrades, this is the name of the required item. |
| price | For mechanics set up to purchase upgrades, this is the cost to the mechanic to apply the upgrade. |
| audioNameHash | Any in-game vehicle name, or addon sound pack name (engine swaps only). |
| handling | Add or remove handling attributes and values. More help and info on handling values: gtamods.com/wiki/Handling.meta |
| handlingApplyOrder | The order in which this tuning option should be applied. This is useful when tuning options have overlapping handling values. Provide a priority number, and the lowest numbers will be applied first. |
| handlingOverwritesValues | Whether the handling values provided should overwrite the vehicle's existing values, or modify them. This works for negative values too. For example: a vehicle's current
|
| restricted | Can be false (unrestricted), "electric" or "combustion". |
| blacklist | List of archetype names (spawn codes) that cannot use this modification. |