💽Installation

Installation difficulty

🟠⚫⚫⚫⚫

Download the resource

• Head to your cfx keymaster, in Granted Assets look for an asset called sb-handlingtuning V2 Latest Release and download it.

Install dependencies

• Download and install ox_lib

  • Insallation guide: https://overextended.dev/ox_lib

Create inventory items

ox_inventory

Add this to ox_inventory/data/items.lua

['car_mod_nitro_kit'] = {
    label = 'Nitro Kit',
    weight = 500,
    close = true,
    client = {},
},
['car_mod_nitro_tank'] = {
    label = 'Nitro Refill Tank',
    weight = 700,
    close = true,
    client = {},
},
['car_mod_diff_lsd'] = {
    label = 'LSD Differential',
    weight = 1000,
    close = true,
    client = {},
},
['car_mod_diff_welded'] = {
    label = 'Welded Differential',
    weight = 1000,
    close = true,
    client = {},
},
['car_mod_tires'] = {
    label = 'Sport Tires',
    weight = 1000,
    close = true,
    client = {},
    server = {
        -- Add server export if needed
    },
},
['car_mod_stiff_arb'] = {
    label = 'Stiff ARB',
    weight = 1000,
    close = true,
    client = {},
},
['car_mod_ecu'] = {
    label = 'ECU',
    weight = 175,
    close = true,
    client = {},
},
['car_mod_lock_kit'] = {
    label = 'Lock Kit',
    weight = 800,
    close = true,
    client = {},
},

["tunertablet"] = {
    label = "Tuner tablet",
    weight = 1,
    stack = true,
    close = true,
},

["smalltunertablet"] = {
    label = "Small tuner tablet",
    weight = 1,
    stack = true,
    close = true,
},

ESX

Run the following sql code on your database:

-- Tablet items
INSERT INTO `items` (`name`, `label`, `weight`, `rare`, `can_remove`) VALUES
    ('tunertablet',	'Spray',	200,	1,	1),
    ('smalltunertablet',	'Spray Remover',	150,	1,	1);

-- Upgrades items
INSERT INTO `items` (`name`, `label`, `weight`, `rare`, `can_remove`) VALUES
    ('car_mod_nitro_kit',	'Nitro Kit',	500,	1,	1),
    ('car_mod_nitro_tank',	'Nitro Refill Tank',	700,	1,	1),
    ('car_mod_diff_lsd', 'LSD Differential', 1000, 1, 1),
    ('car_mod_diff_welded', 'Welded Differential', 1000, 1, 1),
    ('car_mod_tires', 'Sport Tires', 1000, 1, 1),
    ('car_mod_stiff_arb', 'Stiff ARB', 1000, 1, 1),
    ('car_mod_ecu', 'ECU', 175, 1, 1),
    ('car_mod_lock_kit', 'Lock kit', 800, 1, 1);

QBCore

Add the following to qb-core/shared.lua > QBShared.Items

['car_mod_nitro_kit'] = {['name'] = 'car_mod_nitro_kit', ['label'] = 'Nitro Kit', ['weight'] = 500, ['type'] = 'item', ['image'] = 'car_mod_nitro_kit.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = 'A kit for installing nitrous oxide boosting'},
['car_mod_nitro_tank'] = {['name'] = 'car_mod_nitro_tank', ['label'] = 'Nitro Refill Tank', ['weight'] = 700, ['type'] = 'item', ['image'] = 'car_mod_nitro_tank.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = 'A refill tank for nitrous oxide systems'},
['car_mod_diff_lsd'] = {['name'] = 'car_mod_diff_lsd', ['label'] = 'LSD Differential', ['weight'] = 1000, ['type'] = 'item', ['image'] = 'car_mod_diff_lsd.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = 'Limited Slip Differential for better traction'},
['car_mod_diff_welded'] = {['name'] = 'car_mod_diff_welded', ['label'] = 'Welded Differential', ['weight'] = 1000, ['type'] = 'item', ['image'] = 'car_mod_diff_welded.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = 'Welded Differential for drift racing'},
['car_mod_tires'] = {['name'] = 'car_mod_tires', ['label'] = 'Sport Tires', ['weight'] = 1000, ['type'] = 'item', ['image'] = 'car_mod_sport_tires.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = 'High-performance sport tires'},
['car_mod_stiff_arb'] = {['name'] = 'car_mod_stiff_arb', ['label'] = 'Stiff ARB', ['weight'] = 1000, ['type'] = 'item', ['image'] = 'car_mod_stiff_arb.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = 'Stiff Anti-Roll Bar for improved handling'},
['car_mod_ecu'] = {['name'] = 'car_mod_ecu', ['label'] = 'ECU', ['weight'] = 175, ['type'] = 'item', ['image'] = 'car_mod_ecu.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = 'Engine Control Unit for performance tuning'},
['car_mod_lock_kit'] = {['name'] = 'car_mod_lock_kit', ['label'] = 'Lock Kit', ['weight'] = 800, ['type'] = 'item', ['image'] = 'car_mod_lock_kit.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = ''},
['tunertablet'] = {['name'] = 'tunertablet', ['label'] = 'Tuner Tablet', ['weight'] = 1000, ['type'] = 'item', ['image'] = 'tunertablet.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = 'Tablet used to adjust vehicle handling data'},
['smalltunertablet'] = {['name'] = 'smalltunertablet', ['label'] = 'Small Tuner Tablet', ['weight'] = 1000, ['type'] = 'item', ['image'] = 'smalltunertabler.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = 'Small Tablet used to adjust vehicle handling data'},

Unzip the resource archive

• Using 7zip or win rar unzip the archive you just downloaded.

Add the script to your server resources folder

• Locate your server files and inside it find the resources folder;

• Copy and paste the sb-handlingtuning folder to it;

• Add the resource to your server.cfg by adding the following line: ensure sb-handlingtuning;

• Restart the server...

  • The resource should identify your framework and create database tables. To make sure the automatic processes went through properly have a look at messages that come up on your server console.

Save default handling data

• In game use command /admin:cars and save all vehicles data

Common issues

TODO