Installation

Mad Boosting App

A comprehensive boosting system for FiveM servers with marketplace integration and leaderboard functionality.

Important Note!

Execute .sql file

Vehicle Keys Integration

This script requires integration with your vehicle keys system to prevent unauthorized access to boosting vehicles. Follow the instructions below based on your vehicle keys script.

qb-vehiclekeys

Add the following code to the lockpicks:UseLockpick event in client/main.lua, after the if vehicle == nil or vehicle == 0 then return end check:

local boostingInfo = Entity(vehicle).state.boostingData
if boostingInfo ~= nil and ((not boostingInfo.authorizedCids and boostingInfo.ownerCid ~= QBCore.Functions.GetPlayerData().citizenid) or (boostingInfo.authorizedCids and not boostingInfo.authorizedCids[QBCore.Functions.GetPlayerData().citizenid])) then
    QBCore.Functions.Notify('This vehicle is not meant for you!', 'error')
    return
end

if boostingInfo ~= nil and boostingInfo.requiresAdvancedHack then
    QBCore.Functions.Notify('This vehicle requires more advanced systems!', 'error')
    return
end

qbx_vehiclekeys

Add the following code to the LockpickDoor function inside client/functions.lua, after the if not vehicle then return end check:

local boostingInfo = Entity(vehicle).state.boostingData
if boostingInfo ~= nil and ((not boostingInfo.authorizedCids and boostingInfo.ownerCid ~= QBCore.Functions.GetPlayerData().citizenid) or (boostingInfo.authorizedCids and not boostingInfo.authorizedCids[QBCore.Functions.GetPlayerData().citizenid])) then
    QBCore.Functions.Notify('This vehicle is not meant for you!', 'error')
    return
end

if boostingInfo ~= nil and boostingInfo.requiresAdvancedHack then
    QBCore.Functions.Notify('This vehicle requires more advanced systems!', 'error')
    return
end

Other Vehicle Keys Scripts

If you're using a different vehicle keys script, add the code above to your vehicle unlock/lockpick function on the client-side, wherever you handle vehicle unlocking attempts.

How It Works

The script uses StateBags to store boosting contract information on vehicles. When a player attempts to unlock a boosting vehicle:

1. The system checks if the vehicle has boostingData in its state

2. It verifies if the player is authorized (owner or group member)

3. It checks if the vehicle requires advanced systems (hacking)

4. If unauthorized, the unlock attempt is blocked

📦 Inventory Items Configuration

This page documents the required inventory items for the resource, compatible with ox_inventory and qb-inventory.

---

🔹 ox_inventory

Add the following items to your ox_inventory/data/items.lua:

['hackingdevice'] = {
    label = 'Hacking Device',
    weight = 0,
    description = 'Will allow you to bypass vehicle security systems.',
},

['gpshackingdevice'] = {
    label = 'GPS Hacking Device',
    weight = 0,
    description = 'If you wish to disable vehicle GPS systems.',
},

---

🔹 qb-inventory

Add the following items to qb-core/shared/items.lua:

['hackingdevice'] = {
    name = 'hackingdevice',
    label = 'Hacking Device',
    weight = 1000,
    type = 'item',
    image = 'hackingdevice.png',
    unique = true,
    useable = true,
    shouldClose = true,
    combinable = nil,
    description = 'Will allow you to bypass vehicle security systems.',
},

['gpshackingdevice'] = {
    name = 'gpshackingdevice',
    label = 'GPS Hacking Device',
    weight = 1000,
    type = 'item',
    image = 'gpshackingdevice.png',
    unique = true,
    useable = true,
    shouldClose = true,
    combinable = nil,
    description = 'If you wish to disable vehicle GPS systems.',
},

---

ℹ️ Dependacies

• ox_lib

• qb-core / qbx_core / esx

• any interaction script