Features

All systems included in nc-taxijob and how they work.

Taximeter

The meter sits in the corner of the screen. It shows status, live fare, distance, time, and a surcharge toggle.

What does the player see?

1. Press U — meter opens
2. Status shows Vacant / Driving / Stopped
3. Fare updates in real-time as the vehicle moves
4. Receipt auto-prints after payment
5. Players can drag the meter to reposition it (if Config.UI.Drag = true)

Player-to-Player Rides

Drivers can pick up real players for metered rides.

What does the player see?

1. Player gets in the taxi as passenger
2. Driver presses Start — meter begins
3. Driver presses Stop at destination — meter freezes
4. Driver presses Pay — passenger sees a payment prompt
5. Passenger chooses Cash or Card
6. Driver receives fare minus company commission

NPC Missions

On-duty drivers receive NPC passenger missions.

What does the player see?

1. A dispatch call appears in the meter — destination, estimated fare, distance
2. Driver accepts the call — blip appears on map
3. Drive to the pickup, press E to board the passenger
4. Camera shifts to the backseat, passenger requests a destination via speech bubble
5. Dropoff blip appears — drive there
6. Press E at the dropoff — passenger pays by card or cash
7. Receipt prints, fare is paid

NPC Behaviors

• Speech — Greeting on board, thanks on arrival, angry on crash
• Crash reactions — Minor crash → angry. Major → scared. Too many → mission fails
• Fare evasion — Configurable chance the NPC runs without paying full fare
• Illegal surcharge — Night surcharge during the day → NPC reports to police, refuses to pay

Tips & Bonuses

• Safe driving bonus for no-crash rides
• Random tips with rank scaling
• Perfect ride bonus for zero-crash deliveries

Dispatch Board

The dispatch board appears inside the taximeter when Config.NpcMission.Dispatch.Enabled = true.

How it works

• Server generates NPC calls at configurable intervals
• All on-duty drivers see the same list
• Each call shows: destination, estimated fare, distance from you
• Click to accept — removed from all other drivers' boards
• While on a ride, the board shows "In Ride"
• Unclaimed calls expire after timeout

Multi-Company

Define companies in Config.Companies. Each company has its own duty location, garage, and boss menu.

Duty

• Step on a marker, use a command, or both
• Per-company blip and marker

Garage

• Spawn taxi vehicles at the depot
• Vehicles can be rank-locked (e.g. Premium Taxi requires rank 2)
• Auto-delete vehicle when going off duty

Boss Menu

Accessible to players with isboss = true (QBCore/QBox) or matching BossGrade (ESX):

• View and manage employees
• Hire nearby players, fire employees
• Set commission rate (capped by config)
• View and withdraw company funds
• Per-employee stats

Commission

Boss sets a commission rate (e.g. 10%). Every fare auto-splits — driver gets the fare minus commission, company fund gets the rest. Works for all payment types.

Ranks

Complete missions to rank up. Higher ranks earn a fare bonus multiplier.

Ranks, thresholds, and multipliers are all configurable.

Statistics

Per-driver stats stored in database: income, missions completed, distance driven, total rides. View with /taxistats.