Common Errors

Common Errors — Bus Driver Job for FiveM | Quasar Store | Quasar Store

The framework was not running when the job started, so it found none. The console may show one of these lines, or nothing at all if the framework had not started yet when the job loaded:

bash

[qs-busjob] es_extended has not answered getSharedObject after 10s. Is it started, and does it start before this resource?
[qs-busjob] qb-core has not answered GetCoreObject after 10s. Is it started, and does it start before this resource?

Move your framework's ensure above ensure qs-busjob and restart the server.

"Illegal mix of collations" in the console

The leaderboard joins the job's table to your framework's player table, and MySQL refuses when their collations differ — common on MariaDB 11.4 and newer. The job fixes this itself on start; when it cannot, it prints the exact statement to run:

bash

[qs-busjob] could not align `qs_busdriverjob`.`identifier` to utf8mb4_uca1400_ai_ci (users.identifier uses it).
  The leaderboard will fail with "Illegal mix of collations" until it matches. Run by hand:
    ALTER TABLE `qs_busdriverjob` MODIFY `identifier` varchar(46) COLLATE utf8mb4_uca1400_ai_ci NOT NULL;

Run that statement in HeidiSQL or phpMyAdmin, then restart the resource.

"Parking lot is full"

Every bay in Config.VehicleSpawnCoords has a vehicle standing in it — often a car someone left in the depot. Clear the bays, or add more; keep new bays more than 2.5 m apart across their heading so a bus in one never blocks the next.

"The depot could not bring a bus out"

A bay was free, but no bus appeared within 5 seconds, so the route was dropped without charge. F8 names the model:

bash

[qs-busjob] The bus 'pbus2' never spawned. Is the model on this server?

Check the spawn name in Config.Vehicles, and that an add-on model is actually streamed by a running resource.

No prompt at a stop, or pressing E there does nothing

The prompt only appears within 10 m of the stop, and only while you are in the driver's seat of the bus this route spawned — not another bus, not as a passenger, not on foot. The server then needs you within Config.StopReachDistance (25 m) of the stop point, and it has to be the next stop. A custom stop placed away from the road can be unreachable in a bus: move it onto the pavement beside the lane.

The bus has no keys, or cannot be locked

No supported key script was running when the job started — check that it is ensured above qs-busjob — or yours is not on the list. Integrations shows how to pin one or add a bridge for it.

The bus spawns with an empty tank

Set Config.Fuel = true and point Config.FuelExport at your fuel resource, which needs a SetFuel export.

Stops take too long

Every passenger uses the front door, one at a time, at about three seconds a head. Lower maxBoard and maxAlight in Config.PassengersPerStop, and the longRideBonus if long routes are the slow ones.

Some passengers walk away instead of boarding

Correct behaviour. Either the bus had no seat left for them, or they could not reach the door after two tries — blocked by traffic, a bollard, or a bus parked too far from the kerb. They are never teleported into a seat.

There is no prompt to hand the bus back

It only appears after the last stop has been served, within 5 m of Config.DeliverBusCoords. The server then needs you within Config.DeliverReachDistance (20 m) of it.

The route paid less than the card says

The card shows the route's base pay. Each crash the server logged took Config.CrashMonetaryPayment off, less your crash protection; the bus multiplier and level bonus then apply to the rest. With Discord logs on, the MissionFinished embed shows the crash penalty that was taken.

The route was not paid at all

Either the driver lost the job before handing the bus back — they were told "You don't have the bus driver job" — or the route was abandoned. With qs-job-management running, the payout went to it rather than to the driver's cash.

A player passenger was not charged

The driver must be on a route and at the wheel of that route's bus. The same passenger pays the same driver once per Config.TicketCooldown (180 s), the fare comes from cash — not the bank — and Config.MultiplayerTicketPrice = 0 turns fares off.

The uniform does not change, or stays on after the route

On ESX the outfit is skipped for a character with no saved skin in esx_skin — the job itself carries on. On QBCore and Qbox your appearance script has to answer the qb-clothing events; for illenium-appearance, swap in its reload line in client/clothing.lua (see Integrations). Or turn Config.Clothing off.

Key	Means
`NOTIFY_NOT_BUS_DRIVER`	The player holds no job listed in `Config.busdriverjob` — when starting, or by the time of the hand-back.
`NOTIFY_ALREADY_ON_MISSION`	A route is already open for this player.
`NOT_ENOUGH_LEVEL`	The stored level is below the route's `levelRequired`.
`NOTIFY_VEHICLE_LOCKED`	The stored level is below the chosen bus's `levelRequired`.
`PARKING_FULL`	Every bay in `Config.VehicleSpawnCoords` is blocked.
`NOTIFY_BUS_NOT_AVAILABLE`	A bay was free but no bus appeared within 5 seconds — usually a model that is not on the server.
`NOTIFY_NOT_ENOUGH_MONEY`	A player passenger cannot pay the ticket in cash.

Installation and Startup#

Common Errors

Installation and Startup#

The Depot and the Panel#

Driving a Route#

Leaderboards#

Error Keys#