Configuration

Complete configuration reference for nox-taxi.

Basic Settings

Debug Mode

Config.Debug = false  -- Enable console debug prints

Language

Config.Locale = 'en'  -- 'en' or 'ko'

Commands

Customize command names and keybinds:

Config.Commands = {
    Taximeter = 'taximeter',      -- Toggle taxi meter UI
    TaximeterKey = 'U',           -- Default keybind
    Focus = 'taxi_focus',         -- Toggle mouse focus
    FocusKey = 'Q',               -- Default keybind
    CancelMission = 'canceltaximission',  -- Cancel NPC mission
    EditUI = 'taxiuiedit',        -- Edit UI position
}

UI Settings

Config.UI = {
    Drag = true,              -- Allow players to reposition UI
    Position = 'top-right',   -- Default position when Drag = false
}

Position Options

• top-left
• top
• top-right
• middle-left
• middle-right

Fare Settings

Configure fare calculation:

-- Base fare when ride starts
Config.BaseFare = 3

-- Distance-based fare
Config.FareStepDistance = 100.0  -- Meters between fare increases
Config.FareStepAmount = 1        -- Amount added per step ($1 per 100m)

-- Night surcharge
Config.SurchargeRate = 1.5       -- 1.5 = 50% increase
Config.NightTimeStart = 20       -- 8 PM
Config.NightTimeEnd = 6          -- 6 AM

Fare Example

For a 2km ride during the day:

• Base: $3
• Distance: 20 steps × $1 = $20
• Total: $23

Same ride at night (with 50% surcharge):

• Base: $3 × 1.5 = $4.50
• Distance: $20 × 1.5 = $30
• Total: $34.50

Taxi Vehicles

Define which vehicles work as taxis:

Config.TaxiVehicleNames = {
    "taxi",
    "taxi5",
    "caravantaxi",
    "gbtaxiargento7f",
    "gbtaxieon",
    "gbtaxistanierle",
    "gbtaxistarlight",
    "marbtaxirx",
    "roxvivantaxi",
    "roxtaxi",
    "roxtaxi2",
    "roxtaxi3",
}

Add your custom taxi vehicle models to this list

NPC Mission Settings

Configure the AI passenger mission system:

Config.NpcMission = {
    Enabled = true,
    
    -- Fare settings
    FarePerMile = 3,
    StartingFare = 0,
    
    -- Dispatch timing
    DispatchWaitMin = 30,   -- Minimum wait (seconds)
    DispatchWaitMax = 120,  -- Maximum wait (seconds)
    
    -- Fare evasion
    FleeChance = 30,            -- 30% chance to attempt flee
    FleeMinFarePercent = 60,    -- Minimum payment on flee
    FleeMaxFarePercent = 100,   -- Maximum payment on flee
    
    -- Bonus for safe driving
    Bonus = {
        Enabled = true,
        Percentage = 10,  -- 10% tip
    },
    
    -- Accident detection
    MinVehicleHealth = 750,     -- Mission fails below this
    MaxCrashesAllowed = 5,      -- Max allowed crashes
}

NPC Speech & Reactions

Config.NpcMission.Speech = {
    Enabled = true,
    Greeting = 'GENERIC_HI',
    Angry = 'GENERIC_INSULT_HIGH',
    Scared = 'GENERIC_FRIGHTENED_HIGH',
    Grateful = 'GENERIC_THANKS',
    Happy = 'GENERIC_HAPPY',
}

Config.NpcMission.Bubble = {
    Enabled = true,
    Duration = 3000,   -- Speech bubble duration (ms)
    OffsetX = -0.08,   -- Screen X offset
    OffsetY = 0.05,    -- Screen Y offset
}

Destination Names

Names shown when passenger boards:

Config.NpcMission.DestinationNames = {
    "Downtown", "Airport", "Beach", "Hospital", "Police Station",
    "Gas Station", "Mart", "Hotel", "Bank", "Club"
}

Camera Settings

Cinematic camera when passenger boards:

Config.NpcMission.Camera = {
    Duration = 3000,    -- Camera transition time (ms)
    FOV = 60.0,
    OffsetX = 0.25,     -- Right from driver's head
    OffsetY = -0.15,    -- Forward from driver's head
    OffsetZ = 0.1,      -- Up from driver's head
}

Reward Items

Random item reward after missions:

Config.NpcMission.RewardItem = 'coffee'
Config.NpcMission.RewardChance = 25  -- 25% chance

Pickup & Dropoff Locations

Define NPC spawn points:

Config.NpcPickupLocations = {
    vector4(257.61, -380.57, 44.71, 340.5),
    vector4(-48.58, -790.12, 44.22, 340.5),
    -- Add more locations...
}

Config.NpcDropoffLocations = {
    vector4(-1074.39, -266.64, 37.75, 117.5),
    vector4(-1412.07, -591.75, 30.38, 298.5),
    -- Add more locations...
}

vector4(x, y, z, heading) - Include heading for NPC orientation

NPC Skins

Define available passenger appearances:

Config.NpcSkins = {
    -- Female skins
    [1] = {
        'a_f_m_skidrow_01',
        'a_f_m_soucentmc_01',
        'a_f_m_soucent_01',
        -- Add more...
    },
    -- Male skins
    [2] = {
        'a_m_m_business_01',
        'a_m_m_downtown_01',
        -- Add more...
    },
}

Last updated: January 28, 2026