Installation

Discord Support

Complete guide for installing nc-busjob on your FiveM server.

Prerequisites

  • FiveM Server (latest recommended artifacts)
  • ox_lib — callbacks, UI
  • One of: QBCore / QBox / ESX / OX Core
  • Optional: ox_target / qb-target / qtarget (falls back to E key interaction)

Step 1: Download

  1. Download nc-busjob for free from the CFX Releases page
  2. Extract the archive

Step 2: Place Resource

Place the nc-busjob folder in your server's resources directory.

Step 3: server.cfg

ensure ox_lib
ensure qb-core       # or es_extended, ox_core, qbx_core
ensure nc-busjob

⚠️ Load order matters: nc-busjob must start after ox_lib and your framework.

Step 4: Configuration

Edit shared/config.lua. Most settings work out of the box, but key options to check:

Config.Framework = 'auto'
Config.Target = 'auto'
Config.Locale = 'en'

Target System

Priority Resource Notes
1st ox_target Preferred
2nd qb-target QBCore default
3rd qtarget Legacy support
Fallback E key No target resource needed

Step 5: Restart

refresh
ensure nc-busjob

File Structure

nc-busjob/
├── fxmanifest.lua
├── shared/
│   ├── config.lua              # Main configuration (editable)
│   ├── bus.lua                 # Bus stop definitions (editable)
│   └── locale.lua              # Locale system (editable)
├── client/
│   ├── main.lua                # Core client logic (encrypted)
│   ├── client_utils.lua        # Framework bridge (editable)
│   └── route_builder.lua       # Route builder tool (editable)
├── server/
│   ├── main.lua                # Core server logic (encrypted)
│   ├── server_utils.lua        # Framework bridge (editable)
│   └── route_builder.lua       # Route builder save logic (editable)
├── data/
│   ├── player_levels.json      # Player data (auto-generated)
│   └── daily_challenges.json   # Challenge data (auto-generated)
├── generated/                  # Route builder output folder
├── lang/
│   ├── en.lua                  # Server/client translations (editable)
│   └── en.json                 # NUI translations (editable)
└── html/
    └── dist/                   # Built NUI files

Editable Files (escrow_ignore)

File Description
shared/config.lua Main configuration — all systems, routes, settings
shared/bus.lua Physical bus stop coordinate definitions
shared/locale.lua Locale system loader
client/client_utils.lua Client framework bridge, hooks, notifications
client/route_builder.lua Route builder client tool
server/server_utils.lua Server framework bridge, money, logging
server/route_builder.lua Route builder save logic
lang/en.lua Server/client translation strings
lang/en.json NUI translation strings
html/**/* All NUI files

Framework-Specific Notes

  • QBCore: Auto-detected via qb-core
  • QBox: Auto-detected via qbx_core
  • ESX: Auto-detected via es_extended
  • OX Core: Auto-detected via ox_core

Troubleshooting

  • Resource not starting — Ensure ox_lib starts before nc-busjob
  • No NPCs at depot — Verify Config.Depot.coords
  • Target not working — Set Config.Target manually
  • Payment not working — Check Config.Payment settings
  • Challenges not resetting — Check Config.DailyChallenges.resetHour

Last updated: February 28, 2026

Last updated 1 month ago