⚙️Configuration

Check the instructions below.

The main configuration file is Config.lua. Additional configurations can be done through serverconfig.lua and locales.lua.

---

General Settings

Setting	Description	Default Value
Framework	Framework used (qb, esx, oldesx).	"qb"
Locale	Language for the script.	"en"
DebugStreet	Enable/disable debug for street names.	false
Target	Targeting system (qb, ox, none).	"qb"
JobRequirement	Require a specific job to use the bus job.	true
Job	Job name required to access the bus job.	"police"
Menu	Coordinates for the job menu.	vector3(468.89, -577.03, 29.49)
Vehicle	Vehicle model for the bus job.	"bus"
SpamProtectionTime	Time (ms) to prevent menu spam.	2000
TimeToGetInVehicle	Time (seconds) to get into the vehicle before timeout.	30
CrashFine	Fine for crashing the bus.	100

---

NPC Configuration

Setting	Description	Default Value
hash	Ped model hash for the NPC.	"a_m_y_business_02"
coords	NPC coordinates.	vector3(468.89, -577.03, 28.49)
heading	NPC heading.	172.13

Blip Configuration

Setting	Description	Default Value
sprite	Blip icon sprite.	513
color	Blip color.	4
scale	Blip size.	0.6
name	Blip name on the map.	"Bus Driver Job"

---

Passenger Peds

Define the ped models that can spawn as passengers.

Example Passenger Configuration:

PassengerPeds = {
    "a_f_m_bevhills_01",
    "a_f_m_bevhills_02",
    "a_f_m_business_02",
    "a_f_m_downtown_01"
}

---

Parking Lots

Define parking lot locations where buses will spawn.

Example Parking Lots Configuration:

ParkingLots = {
    vector4(439.9370, -581.0314, 28.4998, 263.1297),
    vector4(437.3640, -585.4839, 28.4998, 264.4554)
}

---

Routes and Stops

Routes contain the stops for bus rides.

Setting	Description
RouteName	Name of the bus route.
Salary	Payment for completing the route.
Level	Minimum level required to access the route.
TicketPrice	Ticket price for passengers.
Exp	Experience gained per stop.

Stops Configuration

Setting	Description
StopName	Name of the stop.
Level	Minimum level required for the stop.
StopCoords	Coordinates of the stop.
PassengerWaitCoords	Where passengers wait at the stop.
MaxPassengers	Maximum number of passengers per stop.
MinPassengers	Minimum number of passengers per stop.
StopBlip	Blip configuration for the stop.

Example Route Configuration:

Routes = {
    {
        RouteName = "Airport",
        Salary = 1200,
        Level = 0,
        TicketPrice = 10,
        Exp = 3,
        Stops = {
            {
                StopName = "Little Bighorn Ave",
                StopCoords = vector3(460.41, -618.25, 28.49),
                PassengerWaitCoords = vector4(455.21, -615.76, 28.49, 291.30),
                MaxPassengers = 6,
                MinPassengers = 2,
                StopBlip = {
                    Sprite = 1,
                    Color = 4,
                    Scale = 0.6,
                    Text = "Stop: Little Bighorn Ave"
                }
            }
        }
    }
}

---

Localization

The script supports multiple languages through locales.lua.

Language Code	Description
en	English
tr	Turkish
es	Spanish
de	German
ru	Russian

Example Localization Key:

Translation = {
    ["en"] = {
        ["MISSION_STARTED"] = "The mission just started!",
        ["CRASHED_VEHICLE"] = "You've crashed and fined $%s",
    }
}

---

Discord Integration

Add your Discord bot token in serverconfig.lua to enable profile image support in logs.

Example Configuration:

Config.DiscordBotToken = "38DB612AAAAAAAA02678E23"

---