nc-taxijob

A taxi job system for FiveM. NPC missions with a shared dispatch board, player-to-player metered rides, multi-company management, and rank progression.

Overview

Drivers go on duty at their company depot, pull a taxi from the garage, and start taking fares. The dispatch board shows NPC calls to all on-duty drivers — first to accept gets the ride. Between NPC runs, drivers can pick up real players for metered rides. Bosses manage commission rates and employees through an in-game menu.

Key Features

NPC Missions — Random pickups/dropoffs, speech bubbles, card/cash payment
Shared Dispatch — All on-duty drivers see the same call board, one accepts per call
Player Rides — Metered rides between real players with payment prompt
Multi-Company — Unlimited companies, each with duty/garage/boss menu
Boss Menu — Hire/fire, set commission %, company funds
Night Surcharge — Auto fare increase at night, illegal surcharge detection
Rank & Tips — Mission-based ranks with fare multipliers, random tips
Statistics — Per-driver stats in database
All Vehicle Meter — Use the taximeter in any vehicle, not just taxi models
Meter Item System — Install/remove meters via items (per vehicle plate, saved to DB)
Target System — ox_target / qb-target NPC interaction for duty, garage, boss menu
Distance Unit — Global km/mi unit selection
Phone App (lb-phone) — Request rides, track drivers, real-time fare, favorites, receipts, ratings

Requirements

Resource	Required	Notes
ox_lib	✅	Callbacks, UI utilities
oxmysql	✅	Database storage
Framework	✅	QBCore / QBox / ESX (auto-detected)
ox_target / qb-target	❌	Optional — only if `Config.Target = true`
lb-phone	❌	Optional — enables phone app for passenger ride requests

Quick Start

ensure ox_lib
ensure oxmysql
ensure qb-core       # or es_extended, qbx_core
ensure nc-taxijob

nc-taxijob must start after your framework, ox_lib, and oxmysql.

How It Works

Go on duty — Interact with the duty NPC (target mode) or step on the marker, or use the duty command
Spawn a taxi — Interact with the garage NPC or walk to the marker, pick a vehicle
Open the meter — Press U to toggle the taximeter
Take NPC calls — Accept a dispatch call from the board, drive to pickup, deliver to destination
Pick up players — Real players get in, press Start/Stop/Pay to run a metered ride
Earn & rank up — Fares minus commission go to you, complete missions to rank up

Commands

Command	Keybind	Description
`/taximeter`	U	Toggle taxi meter
`/taxi_focus`	Q	Toggle mouse focus on meter
`/canceltaximission`	—	Cancel current NPC mission
`/taxiuiedit`	—	Reposition the meter UI

Support

Discord: discord.gg/noxcore