Config File

⚙️ Configuration

All client-side settings live in config.lua. The file is fully open - edit anything you need.

---

General

Config.Job      = "unemployed"  -- ESX job name required to use the script (if CheckJob = true)
Config.CheckJob = true          -- set to false to allow all players regardless of job
Config.Debug    = true          -- prints debug info to the server console

Set Config.Debug = false on a live server. It generates a lot of console output.

---

Cooldowns

Config.Cooldown = {
    Spawn  = 3000,  -- delay between bus spawns (ms)
    Delete = 2000,  -- delay between bus returns (ms)
    Route  = 2500,  -- route action cooldown (ms)
    Stop   = 1000,  -- stop action cooldown (ms)
}

---

Distances

Config.Distance = {
    Interact = 50.0,  -- interaction radius for the job zone
    Spawn    = 5.0,   -- min. distance from other vehicles when spawning
    Stop     = 15.0,  -- detection radius for a bus stop
    Accident = 10.0,  -- accident detection range
}

---

Bus Outline

The outline is drawn around your bus so you can always spot it when on foot.

Config.BusOutline = {
    R = 255,  -- red
    G = 220,  -- green
    B = 0,    -- blue
    A = 255,  -- alpha (255 = fully visible)
}

---

Payment

Config.Payment = {
    Stop      = { Min = 35,  Max = 55  },  -- base pay per stop
    Passenger = { Min = 8,   Max = 15  },  -- extra pay per passenger on board
    Bonus     = { Min = 150, Max = 300 },  -- end-of-route bonus
    Perfect   = 200,                       -- extra bonus for a perfect route
    Night     = 1.5,                       -- multiplier for routes between 22:00–06:00
    Weekend   = 1.25,                      -- multiplier on Saturday and Sunday
}

Final pay is also affected by: player level, daily bonus multiplier, smooth driving score, and damage penalties.

---

Penalties

Config.Penalty = {
    Accident           = 50,   -- fine per accident
    Missed             = 75,   -- fine for a missed stop
    Speed              = 25,   -- fine per speeding violation
    Damage             = 100,  -- fine for vehicle damage
    DamageThreshold    = 50,   -- damage below this value is ignored
    MaxDamageReduction = 0.60, -- maximum pay reduction from damage (60%)
    StopTimeout        = 100,  -- fine when stop time limit expires
}

---

Stop Time Limit

Config.StopTimeLimit = 300  -- seconds a player has to reach the next stop

Each stop can also have its own TimeLimit field set directly in Config.Route. If a stop has no TimeLimit, this global value is used.

---

NPC Passengers

Config.NPC = {
    SpawnDistance  = 200,  -- distance from stop at which NPC passengers spawn
    MinSpawn       = 2,    -- minimum passengers waiting at a stop
    MaxSpawn       = 8,    -- maximum passengers waiting at a stop
    LineSpacing    = 1.2,  -- spacing between NPCs in the queue (metres)
    ExitWander     = 10.0, -- wander distance after exiting the bus
    ExitWanderTime = 5000, -- how long NPCs wander before being deleted (ms)
    ExitDeleteTime = 3000, -- delay before deletion starts (ms)
    MaxExitPerStop = 5,    -- max passengers that can exit at one stop
}

---

Driving Score

Config.SmoothDrivingThreshold = 95   -- min. score (0–100) for a route to count as "perfect"
Config.MaxAcceleration        = 5.0  -- sudden acceleration above this lowers the score
Config.SpeedLimit             = 110  -- speed limit in km/h; exceeding it triggers a fine

---

Zones

Config.Zone = {
    Job         = vec4(451.24, -629.42, 28.53, 260.03),  -- NPC position / ox_target zone
    Spawn       = vec4(459.36, -649.14, 28.13, 212.80),  -- where the bus spawns
    ReturnPoint = vec4(459.36, -649.14, 28.13, 212.80),  -- where the bus must be returned
}

Spawn and ReturnPoint can be the same coordinates (default) or different ones depending on your depot layout.