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

Download the resource from your Cfx Portal / Tebex purchase and extract it to resources/. The folder must be named ns-vehiclehandling.
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.

server.cfg (order matters):

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

Permission for your admins:
```
add_ace group.admin ns-vehiclehandling.admin allow
```
Framework admin groups (admin, god, superadmin) are accepted too — see config.lua.
Turkish UI: set Config.Locale = 'tr'.
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 (claiming 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.

Troubleshooting

Problem	Fix
"You lack the required entitlement"	The server key is not on the Cfx account that claimed the asset.
`err_no_permission`	Add the ACE above or check `Config.Permissions.groups`.
"The handling system is still starting"	oxmysql is not started before this resource, or the database connection failed (see console).
Value does not change the car	Fields marked "Needs refresh" need Apply & refresh or a respawn.