Vehicle Routes

🚌 Vehicles & Routes

---

Vehicles

Config.Vehicle = {
    { Model = "bus",     Label = "City Bus",  Capacity = 40, Speed = 90,  Level = 0  },
    { Model = "tourbus", Label = "Tour Bus",  Capacity = 30, Speed = 110, Level = 5  },
    { Model = "airbus",  Label = "Long Bus",  Capacity = 60, Speed = 85,  Level = 10 },
}

Field	Description
Model	GTA vehicle spawn name
Label	Display name shown in the menu
Capacity	Max passengers the vehicle can carry
Speed	Displayed max speed (km/h) - cosmetic only
Level	Minimum player level required to use this vehicle

You can add as many vehicles as you want. Make sure Model matches a valid GTA or add-on vehicle spawn name.

---

Routes

Config.Route = {
    {
        Id       = 1,
        Name     = "Line 1 - Downtown",
        Level    = 0,
        Time     = nil,
        Distance = 8.5,
        Duration = 25,
        Payment  = { Min = 420, Max = 680 },
        Stops    = {
            { Pos = vec3(463.16, -611.99, 28.49), Name = "Depot"  },
            { Pos = vec3(305.64, -760.84, 29.31), Name = "Stop 1" },
            { Pos = vec3(463.16, -611.99, 28.49), Name = "Return" },
        },
    },
}

Field	Description
Id	Unique numeric ID - never duplicate
Name	Route name shown in the menu
Level	Minimum player level to unlock this route
Time	Hours available. nil = always. Use { From = 22, To = 6 } for night-only routes
Distance	Displayed in the menu - does not affect gameplay
Duration	Displayed in the menu - does not affect gameplay
Payment	Base pay range for the whole route
Stops	Ordered stop list. The last stop is the terminal - all passengers exit, nobody boards

---

Per-stop time limit

Each stop supports an optional TimeLimit field (in seconds) that overrides Config.StopTimeLimit:

{ Pos = vec3(305.64, -760.84, 29.31), Name = "Stop 1", TimeLimit = 120 },

---

Night-only route example

Time = { From = 22, To = 6 },  -- available 22:00 → 06:00

Stop order matters. The script visits stops in the exact order they are listed. The last stop in the list is always the terminal.