Installation

Requirements

• FiveM server with OneSync enabled
• oxmysql
• MySQL 5.7+ or MariaDB 10.2+
• Optional: qbx_core / qb-core / es_extended, ox_lib, a vehicle keys and a fuel resource

Steps

1. Download the resource from your Cfx Portal / Tebex purchase and extract it to resources/. The folder must be named ns-vehiclehandling.
2. Database: import sql/vehiclehandling.sql, or leave Config.Database.autoCreateTables = true and the tables are created on the first start. The SQL never drops or overwrites data.
3. server.cfg (order matters):

   ensure oxmysql
   ensure qbx_core            # or qb-core / es_extended
   ensure ns-vehiclehandling
   

   Copy
4. Permission for your admins:

   add_ace group.admin ns-vehiclehandling.admin allow
   

   Copy
   Framework admin groups (admin, god, superadmin) are accepted too — see config.lua.
5. Turkish UI: set Config.Locale = 'tr'.
6. Restart the server, sit in a vehicle as the driver and type /vh.

Escrow

The resource is protected with Cfx Asset Escrow. The server must run under the Cfx account / license key that owns the asset (getting it on Tebex adds it to your Cfx Portal).

Editable files: config.lua, locales/*.lua, bridge/*.lua, sql/*.sql.

Updating

Replace every file except config.lua and your edited locale files. The database schema is the same in all 1.x versions.

1.2.0: six new fields. If you keep your old config.lua, add them to Config.AllowedFields (fDriveBiasFront, fSuspensionUpperLimit, fSuspensionLowerLimit, fRollCentreHeightFront, fRollCentreHeightRear, fCamberStiffnesss); without them the editor keeps the old 34 fields. Config.TestDrive is optional (measurements are on, in km/h, when it is missing). If you keep your own locale files, copy the new keys from the shipped locales/en.lua / tr.lua. Default profiles captured before the update get the new fields' original values the next time an admin opens the editor on that model; existing profiles keep all their values.

Troubleshooting