Config


Vehicle Classes Config (config.lua)

The VehicleClasses configuration defines how different vehicle classes behave in the Boosting system. Each class determines rewards, difficulty, police alert chance, time limits, and other parameters for contracts.


General Settings

Config.PlateFormat = "NLLNNNLL"   -- Example: 1 number, 2 letters, 3 numbers, 2 letters
-- Other formats:
-- "ABCNNN" – Always starts with "ABC" then 3 random numbers
-- "NNNNLL" – 4 numbers followed by 2 letters
  • PlateFormat – defines the vehicle license plate format for all spawned vehicles.


Vehicle Classes Example

Config.VehicleClasses = {
    ["d"] = { ... }, -- D Class
    ["c"] = { ... }, -- C Class
    ["b"] = { ... }, -- B Class
    ["a"] = { ... }, -- A Class
    ["s"] = { ... }, -- S Class
}

Each class is configurable with the following fields:

Field
Description

name

Display name of the class.

level

Numerical level of the class.

xpRequired

XP required to unlock this class.

description

Short description for players.

rewards

Text-based reward description.

costToAccept

Kcoin cost range to accept a contract.

copChance

Percentage chance police are alerted.

copRequired

Minimum cops required to accept the contract.

timeLimit

Maximum time (in minutes) to complete a contract.

timeToAccept

Time (in minutes) a player has to accept a contract.

reward

Numeric reward range for the contract.

kcoin

Kcoin reward range (if applicable).

trackerEnabled

Boolean, enable GPS tracker for the vehicle.

xpReward

XP reward range.

tuningChance

Percentage chance tuning options are available.

chopshop

Chance (%) that a contract generates for chopshop (optional).

cooldown

Minutes before the same player can start another contract.

cancelContract

Percentage charge applied if the player cancels the contract.


Example: D Class

["d"] = {
    name = "D Class",
    level = 1,
    xpRequired = 0,
    description = "Basic vehicles - Sedans, compacts, and economy cars",
    rewards = {
        "$5,000 - $15,000 per contract",
        "Low security systems",
        "Short boost times"
    },
    copChance = 5,
    costToAccept = {0, 0},
    copRequired = 0,
    timeLimit = 20,
    timeToAccept = 5,
    reward = {5000, 15000},
    trackerEnabled = false,
    xpReward = {10, 15},
    tuningChance = 20,
    cooldown = 30,
    cancelContract = 150,
}

Other classes (C, B, A, S) follow the same structure with increasing difficulty, higher rewards, and advanced security features.


Notes

  • Adjust rewards, copChance, timeLimit, and cooldown to balance the gameplay for your server.

  • Chopshop chance allows certain vehicle classes to generate contracts that require taking the vehicle to a chopshop.

  • TrackerEnabled can be toggled per class to make missions easier or harder.

  • CancelContract is a penalty to discourage abandoning contracts.

Last updated