Installation

Complete guide for installing nox-taxi on your FiveM server.

Prerequisites

• FiveM Server
• ox_lib (latest version)
• oxmysql (database driver)
• QBCore or ESX framework

Step 1: Download

1. Purchase and download nox-taxi from noxcore.tebex.io
2. Extract the downloaded archive

Step 2: Install Dependencies

Ensure required resources are installed:

ensure ox_lib
ensure oxmysql

Step 3: Add Resource

1. Place the nox-taxi folder in your server's resources directory
2. Add to your server.cfg:

ensure ox_lib
ensure oxmysql
ensure nox-taxi

⚠️ Important: nox-taxi must start AFTER ox_lib and oxmysql

Step 4: Configure

Edit shared/config.lua to customize your taxi system. See the Configuration guide for details.

Step 5: Restart Server

refresh
ensure nox-taxi

File Structure

nox-taxi/
├── fxmanifest.lua            # Resource manifest
├── shared/
│   └── config.lua            # Main configuration (editable)
├── client/
│   ├── main.lua              # Client-side (encrypted)
│   └── client_utils.lua      # Client hooks (editable)
├── server/
│   ├── main.lua              # Server-side (encrypted)
│   └── server_utils.lua      # Server hooks (editable)
├── lang/
│   ├── en.lua               # English translations (editable)
│   ├── en.json              # English JSON (editable)
│   ├── ko.lua               # Korean translations (editable)
│   └── ko.json              # Korean JSON (editable)
└── ui/                       # Vue.js UI (built)

Editable Files

Integration Points

nox-taxi provides hook functions in client_utils.lua and server_utils.lua for easy integration with your server's systems:

Client Hooks

• Police dispatch integration
• Custom notification system
• Text UI integration
• Mission callbacks

Server Hooks

• Custom payment processing
• Stats tracking
• Logging integration
• Reward item distribution

Troubleshooting

Taximeter not showing

1. Check if you're in a valid taxi vehicle
2. Verify vehicle model is in Config.TaxiVehicleNames
3. Check for console errors

NPC missions not spawning

1. Verify Config.NpcMission.Enabled = true
2. Check pickup/dropoff location coordinates
3. Ensure you're in a taxi vehicle

Night surcharge not applying

1. Verify Config.SurchargeRate > 1.0
2. Check Config.NightTimeStart and Config.NightTimeEnd
3. Confirm server time is correct

Last updated: January 28, 2026