Installation

Prerequisites

• FiveM Server (latest recommended artifacts)
• ox_lib
• oxmysql
• QBCore, QBox, or ESX

Step 1: Place Resource

Place nc-taxijob in your server's resources directory.

Step 2: Register the Taxi Job

Add the taxi job to your framework. The job name must match a key in Config.Companies (default: taxi).

QBCore (qb-core/shared/jobs.lua):

['taxi'] = {
    label = 'City Taxi',
    defaultDuty = false,
    offDutyPay = false,
    grades = {
        ['0'] = { name = 'Driver', payment = 0 },
        ['1'] = { name = 'Senior', payment = 0 },
        ['2'] = { name = 'Supervisor', payment = 0 },
        ['3'] = { name = 'Manager', isboss = true, payment = 0 },
    },
},

isboss = true is required for the boss menu. Payment is 0 because drivers earn from fares.

ESX: Register the job through your ESX job system. The boss grade name must match Config.Companies[job].BossMenu.BossGrade.

Step 3: server.cfg

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.

Step 4: Configure

Edit shared/config.lua — companies, vehicles, fares, locations. See Configuration.

Step 5: Start

refresh
ensure nc-taxijob

Database tables are created automatically on first start.

Troubleshooting

Taximeter not showing

1. You must be in a vehicle listed in Config.TaxiVehicleNames
2. Your job must match a key in Config.Companies
3. Press U while seated as driver

NPC missions not spawning

1. Config.NpcMission.Enabled must be true
2. You must be on duty
3. Config.NpcPickupLocations must have valid coordinates

Boss menu not opening

1. Player's job grade needs isboss = true (QBCore) or matching BossGrade (ESX)
2. Config.Companies[job].BossMenu.Enabled must be true
3. Player must be near the boss menu location