esx_taxijob

esx_taxijob adds a taxi job: drivers spawn a cab at the depot, bill player passengers from an F6 menu, and run NPC fares that pick up a pedestrian and drive them to a random destination for a payout. It is the simplest official job addon and a good template for your own delivery-style jobs.

OverviewCopy Anchor Link

Depot markersCopy Anchor Link

InstallationCopy Anchor Link

ensure esx_society
ensure esx_billing
ensure esx_taxijob

ConfigurationCopy Anchor Link

-- Offer a second cab model
Config.AuthorizedVehicles = {
    { model = 'taxi', title = 'Taxi', icon = 'fas fa-car' },
    { model = 'stretch', title = 'Limousine', icon = 'fas fa-car' },
}

How NPC fares workCopy Anchor Link

1. Open F6 and choose Start NPC job while driving an authorized cab (or any car at grade 3+).
2. The client finds a pedestrian, and when they get in, sends esx_taxijob:startMission with the pickup and destination.
3. The server stores the mission only if the destination is one of Config.JobLocations, the player is within 80 units of the pickup, and the trip is at least Config.MinimumDistance long.
4. At the destination the client sends esx_taxijob:success. The server pays only if the player is within 18 units of the stored drop-off, still in an authorized vehicle, and at least 10 seconds have passed since the last payout.

With the society_taxi account available the payout is split: 30% to the driver as cash and 70% to the society. Without it, the driver gets the full amount.

Commands and keybindsCopy Anchor Link

Depot markers use the E key (control 38).

Server eventsCopy Anchor Link

esx_taxijob:success pays money, so it is the event an exploiter would spam. The mission state lives on the server, and the payout requires a stored mission, so calling it without a real fare only logs a warning.

Server callbacksCopy Anchor Link

Integration tipsCopy Anchor Link

• Player fares from the F6 menu are sent through esx_billing:sendBill to society_taxi, so the society receives the money once the passenger pays.
• To adjust the 30/70 split, edit the esx_taxijob:success handler in server/main.lua. There is no config key for it.
• Add more drop-off points by appending vector3 positions to Config.JobLocations. Keep them on roads so the AI passenger can walk away.

Common issuesCopy Anchor Link

• Cab does not spawn. The spawn point is blocked by another vehicle, OneSync is off, or the player is not near the spawner.
• "Must be in a taxi" for a car that looks like a taxi. Only exact models from Config.AuthorizedVehicles count for grades 0 to 2.
• Fare never pays. The destination must be within 18 units when you arrive. Stopping far from the marker or switching vehicles cancels the payout.

RelatedCopy Anchor Link

• esx_society
• esx_billing
• esx_service
• Create a job

Frequently asked questions