nc-busjob — Advanced Bus Job System
The most feature-rich, immersive bus driver experience for FiveM.
Now FREE — Escrow release.
Framework & Compatibility
Supported
Framework
QBCore • QBox • ESX • OX Core (auto-detect)
Target
ox_target • qb-target • qtarget • interact (auto-detect)
Dependency
ox_lib
Database
Not required — JSON file storage
Escrow
Yes (config files are fully open)
Features
Interactive NUI Dashboard
Built with Vue 3 — smooth, responsive, and beautiful.
- Route selection with detailed info (stops, pay, estimated time)
- Lap selector — run 1 to 5 laps per route for bonus pay
- Daily Challenges tab with progress tracking
- Stats & Leaderboard tab
- GTA-style interactive map showing all bus stops
- Dispatch panel for quick NPC overview
1st-Person Payment System
A fully interactive fare collection experience — not just auto-pay.
- NPCs pay by cash or card — you handle it in first person
- Cash payments: give change with real denomination buttons ($20, $10, $5, $1)
- Card payments: tap-to-pay with processing animation & occasional failures
- Overpay / underpay / exact change scenarios
- NPC speech bubbles during payment ("Keep the change!", "I'm a bit short...")
- Tip system based on your driving rating
- Timed change-making — too slow and passengers get upset
Driving Rating System
Your driving skill directly impacts your earnings.
- 5-star rating system (Excellent → Terrible)
- Penalties for: hard braking, collisions, speeding, running red lights
- Rating affects tip chance & completion bonus multiplier
- Real-time star display on the Route HUD
Daily Challenges
Keep players coming back every day.
- 3 random challenges per day from a 15+ challenge pool
- Types: trips, passengers, earnings, perfect rating, laps
- Easy / Medium / Hard difficulty with scaling rewards
- Auto-reset at configurable hour
- Visual progress bars in the Dashboard
Bus Condition Management
- Real-time fuel consumption (driving & idle rates)
- Vehicle condition tracking with visual warnings
- Speed penalty when condition is critical
- Refuel & repair at depot (costs deducted from earnings)
- Warning / Critical thresholds with color indicators on HUD
Time-Based Demand System
The city feels alive with realistic passenger flow.
- 6 configurable time periods (morning rush, daytime, evening rush, evening, late night, early morning)
- Each period affects: passenger count, tip chance, fare multiplier
- Weekend modifiers on top of time periods
- Event weight overrides per time period (more drunks at night, more VIPs in evening)
Random Events
Every route is different.
Event
Description
Fare Evader
Report them for a bonus or let them ride
Drunk Passenger
Handle unruly riders
Sick Passenger
Detour to hospital for extra reward
VIP Pickup
High-paying special passengers
- Configurable trigger chance & cooldown between events
NPC Passenger System
- 5 passenger types: Normal, Student, Elderly, Tourist, VIP
- Each type has unique fare multipliers & dedicated models
- NPCs board, ride for 1–4 stops, then alight realistically
- Last-stop force-alight logic — no NPCs left on the bus
- 50+ unique NPC models
Player Progression
- 5-tier level system (Newcomer → Premium)
- Level unlocks different bus models with more capacity
- Bonus pay percentage per level
- All progress saved to JSON — no database setup needed
Route Builder (Included)
Server developers can create custom routes in-game.
- In-game tool with NUI interface + interactive Leaflet map
- Click on the map or drive to positions to add stops
- Auto-generates ready-to-paste Lua config code
- Export routes as
bus.luaor config.lua format
Locale System
- Full translation support (Lua for server/client, JSON for NUI)
- Easy to add any language — just duplicate and translate
What's Included
- Full resource (escrowed with open config files)
- In-game Route Builder tool
- Pre-built NUI (no build step required)
- 5 pre-configured routes
- 3 bus models (City Bus, Airport Shuttle, Luxury Coach)
- English locale included
- Full documentation
- 100% Free
Open Config Files (Escrow Ignore)
The following files are fully open and editable:
File
Description
shared/config.lua
All settings, routes, levels, challenges, events, fare
shared/bus.lua
Bus stop definitions
shared/locale.lua
Locale loader
client/client_utils.lua
Client utility functions
server/server_utils.lua
Server utility functions
client/route_builder.lua
Route builder (client)
server/route_builder.lua
Route builder (server)
lang/*
All language files
data/*
JSON data files
Documentation
Support
Join our Discord
