KS-Vehicle-Shop

Installation

1. Unzip the delivered archive into your resources/ folder, under the name ks-vehicle-shop.
2. Import the provided install.sql file into your database.
3. Add ensure ks-vehicle-shop to your server.cfg, after oxmysql, qb-core and qb-garages.
4. Restart your server.

Creating a dealership

Each dealership is declared in config/dealerships.lua:

{
  label = "Premium Deluxe Motorsport",
  ped = { coords = vec4(-56.2, -1096.4, 26.4, 150.0), model = `mp_m_freemode_01` },
  catalog = { "sultan", "buffalo", "banshee" },
  financingAllowed = true,
  testDriveZone = { coords = vec3(-40.1, -1105.8, 26.4), radius = 60.0 },
}

The catalog references your vehicles’ model names (spawnName) — make sure they’re properly registered on the qb-core side before adding them here.

Financing configuration

Config.FinancingDownPaymentPercent = 20   -- minimum down payment, in % of price
Config.FinancingInstallments = { 4, 8, 12 } -- available installment counts
Config.FinancingInterestRate = 5          -- applied interest rate, in %

Common issues

The purchased vehicle doesn’t show up in the garage. Make sure qb-garages (or your equivalent garage script) starts before ks-vehicle-shop, and that the garage name configured in dealerships.lua actually exists on the garage side.

The test drive won’t start. Check that the testDriveZone doesn’t overlap another blocking zone (a marker from another script), and that the test vehicle is included in your list of allowed models.