Installation

⚠️

Before asking support in Discord, as many tickets are due to ignoring certain steps in this guide, read the Common Issues tab on the left menu. Your issue might already be there.

Install steps

Downloading Dependency

Download the lc_utils dependency from this link: lc_utils.zip

Extracting Files

Extract the contents of lc_advanced_vehicles and lc_utils from the zip files into your resources folder.

Configuring the Scripts

Configure the framework settings in the lc_utils/config.lua file.

Downloading the Images

Download the items images from this link advanced_vehicles_images.zip
Extract the images into your inventory folder.

Creating the Items

Copy the items below and paste them in your [qb]\qb-core\shared\items.lua. (There is a copy button in the top-right corner of the box below)

[qb]\qb-core\shared\items.lua

["oil"]                 = {["name"] = "oil",                ["label"] = "Engine Oil",           ["weight"] = 1, ["type"] = "item", ["image"] = "oil.png",              ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Oil for your engine."},
["tires"]               = {["name"] = "tires",              ["label"] = "Tires",                ["weight"] = 10, ["type"] = "item", ["image"] = "tires.png",            ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Tires for your car."},
["brake_pads"]          = {["name"] = "brake_pads",         ["label"] = "Brake Pads",           ["weight"] = 2, ["type"] = "item", ["image"] = "brake_pads.png",       ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "brake pads for your car."},
["transmission_oil"]    = {["name"] = "transmission_oil",   ["label"] = "Transmission Oil",     ["weight"] = 2, ["type"] = "item", ["image"] = "transmission_oil.png", ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Transmission oil for your car."},
["shock_absorber"]      = {["name"] = "shock_absorber",     ["label"] = "Shock Absorber",       ["weight"] = 4, ["type"] = "item", ["image"] = "shock_absorber.png",   ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Shock absorber for your car."},
["clutch"]              = {["name"] = "clutch",             ["label"] = "Clutch",               ["weight"] = 2, ["type"] = "item", ["image"] = "clutch.png",           ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Clutch for your car."},
["air_filter"]          = {["name"] = "air_filter",         ["label"] = "Air Filter",           ["weight"] = 1, ["type"] = "item", ["image"] = "air_filter.png",       ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Air filter for your car."},
["fuel_filter"]         = {["name"] = "fuel_filter",        ["label"] = "Fuel Filter",          ["weight"] = 1, ["type"] = "item", ["image"] = "fuel_filter.png",      ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Fuel filter for your car."},
["spark_plugs"]         = {["name"] = "spark_plugs",        ["label"] = "Spark Plugs",          ["weight"] = 1, ["type"] = "item", ["image"] = "spark_plugs.png",      ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Spark plugs for your car."},
["serpentine_belt"]     = {["name"] = "serpentine_belt",    ["label"] = "Serpentine Belt",      ["weight"] = 1, ["type"] = "item", ["image"] = "serpentine_belt.png",  ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Serpentine belt for your car."},
["susp"]                = {["name"] = "susp",               ["label"] = "Lowered Suspension",   ["weight"] = 15, ["type"] = "item", ["image"] = "susp.png",             ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Lowered suspension for your car."},
["susp1"]               = {["name"] = "susp1",              ["label"] = "Stanced Suspension",   ["weight"] = 15, ["type"] = "item", ["image"] = "susp1.png",            ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Stanced suspension for your car."},
["susp2"]               = {["name"] = "susp2",              ["label"] = "Sport Suspension",     ["weight"] = 15, ["type"] = "item", ["image"] = "susp2.png",            ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Sport suspension for your car."},
["susp3"]               = {["name"] = "susp3",              ["label"] = "Confort Suspension",   ["weight"] = 15, ["type"] = "item", ["image"] = "susp3.png",            ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Confort suspension for your car."},
["susp4"]               = {["name"] = "susp4",              ["label"] = "Lifted Suspension",    ["weight"] = 15, ["type"] = "item", ["image"] = "susp4.png",            ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Lifted suspension for your car."},
["garett"]              = {["name"] = "garett",             ["label"] = "Garett GTW Turbo",     ["weight"] = 7, ["type"] = "item", ["image"] = "garett.png",           ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Garett GTW Turbo for your car."},
["nitrous"]             = {["name"] = "nitrous",            ["label"] = "Nitro",                ["weight"] = 5, ["type"] = "item", ["image"] = "nitrous.png",          ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Nitro for your car."},
["awd"]                 = {["name"] = "AWD",                ["label"] = "AWD Swap",             ["weight"] = 30, ["type"] = "item", ["image"] = "awd.png",              ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "AWD Swap for your car."},
["rwd"]                 = {["name"] = "RWD",                ["label"] = "RWD Swap",             ["weight"] = 20, ["type"] = "item", ["image"] = "rwd.png",              ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "RWD Swap for your car."},
["fwd"]                 = {["name"] = "FWD",                ["label"] = "FWD Swap",             ["weight"] = 10, ["type"] = "item", ["image"] = "fwd.png",              ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "FWD Swap for your car."},
["k20a"]                = {["name"] = "k20a",               ["label"] = "K20",                  ["weight"] = 180, ["type"] = "item", ["image"] = "k20a.png",             ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "K20 engine."},
["rb26"]                = {["name"] = "rb26",               ["label"] = "RB26DETT",             ["weight"] = 190, ["type"] = "item", ["image"] = "rb26.png",             ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "RB26DETT engine."},
["2jz"]                 = {["name"] = "2jz",                ["label"] = "2JZ-GTE",              ["weight"] = 195, ["type"] = "item", ["image"] = "2jz.png",              ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "2JZ-GTE engine."},
["semislick"]           = {["name"] = "semislick",          ["label"] = "Semi Slick Tires",     ["weight"] = 12, ["type"] = "item", ["image"] = "semislick.png",        ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Semi Slick Tires for your car."},
["slick"]               = {["name"] = "slick",              ["label"] = "Slick Tires",          ["weight"] = 10, ["type"] = "item", ["image"] = "slick.png",            ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Slick Tires for your car."},
["race_brakes"]         = {["name"] = "race_brakes",        ["label"] = "Brembo Brakes",        ["weight"] = 8, ["type"] = "item", ["image"] = "race_brakes.png",      ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Brembo Brakes for your car."},
["piston"]              = {["name"] = "piston",             ["label"] = "Piston",               ["weight"] = 1, ["type"] = "item", ["image"] = "piston.png",           ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Piston for your car."},
["rod"]                 = {["name"] = "rod",                ["label"] = "Connecting Rod",       ["weight"] = 1, ["type"] = "item", ["image"] = "rod.png",              ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Rod for your car."},
["gear"]                = {["name"] = "gear",               ["label"] = "Gear",                 ["weight"] = 2, ["type"] = "item", ["image"] = "gear.png",             ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Gear for your car."},
["brake_discs"]         = {["name"] = "brake_discs",        ["label"] = "Brake Disc",           ["weight"] = 5, ["type"] = "item", ["image"] = "brake_discs.png",      ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Brake Disc for your car."},
["brake_caliper"]       = {["name"] = "brake_caliper",      ["label"] = "Brake Caliper",        ["weight"] = 2, ["type"] = "item", ["image"] = "brake_caliper.png",    ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Brake caliper for your car."},
["springs"]             = {["name"] = "springs",            ["label"] = "Springs",              ["weight"] = 4, ["type"] = "item", ["image"] = "springs.png",          ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Springs for your car."},
["iron"]                = {["name"] = "iron",               ["label"] = "Iron",                 ["weight"] = 7, ["type"] = "item", ["image"] = "iron.png",             ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Iron for your car."},
["aluminum"]            = {["name"] = "aluminum",           ["label"] = "Aluminum",             ["weight"] = 2, ["type"] = "item", ["image"] = "aluminum.png",         ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Aluminum for your car."},
["scanner"]             = {["name"] = "scanner",            ["label"] = "Scanner",              ["weight"] = 1, ["type"] = "item", ["image"] = "scanner.png",          ["unique"] = false, ["useable"] = true, ["shouldClose"] = false, ["combinable"] = nil, ["description"] = "Scanner for your car."},

Starting Resources

Start both resources at the bottom of your server.cfg file:

server.cfg

# your other resources above
ensure lc_utils
ensure lc_advanced_vehicles

⚠️

The loading order matters! Ensure that the scripts are placed at the bottom of your server.cfg, as specified above.

Done

Setup is complete. Join your server, enter in an owned vehicle, and then use the /inspect command to open the UI.

The script doesn't require SQL, it generates everything automatically
The tables in your database will have the advanced_vehicles_ prefix

🏎️ Advanced Vehicles Common Issues and FAQ