nc-busjob

Discord Support

A complete bus driver job system for FiveM with 1st-person payment simulation, NPC passengers, player level progression, and a modern Vue 3 NUI dashboard.

Free escrow release — config and bridge files are fully open and editable.

Overview

nc-busjob provides a full bus driver experience — dispatch your bus at the depot, pick up passengers at stops, process fares in first-person view, and drive routes across the city. Features a realistic payment system where you see the passenger's card/cash, give change, and receive tips. Server owners can add custom routes with the built-in route builder.

Key Features

  • Bus Depot System — NPC dispatch via target interaction, 3 bus types by level
  • 5 Default Routes — Pre-configured city routes, fully customizable
  • Route Builder — In-game /routebuilder command to create custom routes
  • Route Modes — Normal, Reverse, Round Trip with selectable direction
  • Loop / Lap System — Up to 5 laps per route with bonus multiplier
  • 1st Person Payment — Card/cash handling, change-making, tip system
  • NPC Passenger System — 5 types (Normal, Student, Elderly, Tourist, VIP) with fare multipliers
  • Speech Bubble Dialog — NPCs speak during payment
  • Dynamic Fare System — Base fare + zone + night surcharge + discounts
  • Time-Based Demand — Rush hour, late night multipliers for passengers/tips/fares
  • Driving Rating System — 5-star rating based on driving behavior
  • Daily Challenges — 3 daily challenges with rewards, auto-reset
  • Player Level System — 5 levels, trip-based progression, bonus earnings (JSON storage)
  • Stats & Leaderboard — Personal stats + top 20 leaderboard in dashboard
  • Bus Condition — Fuel consumption + vehicle condition degradation, depot maintenance cost
  • Random Events — Fare evaders, drunk passengers, sick passenger emergencies, VIP pickups
  • GTA V Map Dashboard — Vue 3 + Leaflet.js route selection with full-color satellite map
  • Multi-Framework — QBCore, QBox, ESX, OX Core auto-detection
  • Multi-Target — ox_target, qb-target, qtarget, E key fallback
  • Multi-Language (i18n) — Lua + JSON locale system, extensible
  • Modern NUI — Vue 3 + Vite, light theme UI

Requirements

Resource Required Notes
ox_lib ✅ Callbacks, UI utilities
Framework ✅ QBCore / QBox / ESX / OX Core (one of)
Target System ❌ ox_target / qb-target / qtarget (auto-detected, falls back to E key)

Quick Start

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

⚠️ nc-busjob must start after your framework and ox_lib.

Supported Frameworks

Framework Resource Auto-Detect
QBCore qb-core ✅
QBox qbx_core ✅
ESX es_extended ✅
OX Core ox_core ✅

Supported Target Systems

Target Resource Auto-Detect
ox_target ox_target ✅
qb-target qb-target ✅
qtarget qtarget ✅
E Key — ✅ (fallback)

Feature Summary

Category Features Status
Depot NPC dispatch, bus spawn, parking zone, depot blip ✅
Buses 3 types (City Bus, Airport Shuttle, Luxury Coach), level-gated ✅
Routes 5 default routes, unlimited custom routes via /routebuilder ✅
Route Modes Normal / Reverse / Round Trip per route ✅
Laps 1–5 laps per route, bonus multiplier per extra lap ✅
NPC Passengers 5 types with fare multipliers, random spawn at stops ✅
Payment Card (40%) / Cash Exact (25%) / Cash Over (30%) / Cash Under (5%) ✅
Change System Denomination-based coin selection, timed change return ✅
Tips Random tip chance, adjustable range ✅
Speech Bubbles NPC dialog during payment with localized text ✅
Fare Calculation Base fare + zone + night surcharge + discounts ✅
Time Demand 6 time periods (rush hour, night, etc.) with multipliers ✅
Driving Rating 5-star system: hard brake, collision, speeding, red light penalties ✅
Daily Challenges 3 daily challenges from pool of 15, auto-reset ✅
Bus Condition Fuel drain + engine/body condition tracking, depot repair cost ✅
Random Events Fare evader, drunk, sick passenger, VIP pickup (4 types) ✅
Player Levels 5 levels (Newcomer → Premium), JSON storage, bonus earnings ✅
Stats / Leaderboard Personal stats + top 20 leaderboard in dashboard ✅
Dashboard Vue 3 NUI with GTA V map, 3 tabs (Routes / Challenges / Stats) ✅
Route Builder In-game /routebuilder to create custom routes ✅
HUD Next stop, passengers, earnings, progress, fuel, condition ✅
Depot Return Manual return-to-depot via dashboard, maintenance cost ✅
Sound Effects Card beep, cash register, door sounds, route complete ✅
Multi-Framework QBCore, QBox, ESX, OX Core with auto-detection ✅
Multi-Target ox_target, qb-target, qtarget, E key fallback ✅
i18n English included, extensible via lang files ✅
Escrow Support Config, utils, lang, HTML, route builder are open; core logic escrowed ✅

Commands

Command Keybind Description
/busloop F7 Open route selection dashboard (while in bus)
/buscancel — Cancel current route
/routebuilder — Open route builder tool

Support

Last updated: February 28, 2026

Last updated 1 month ago