Features
Discord Support
Detailed explanation of all nc-busjob features.
Bus Depot System
- NPC dispatch interaction (supports all target systems or E key)
- Bus selection menu by player level
- Bus spawns at designated parking spot
- Vehicle keys auto-assigned
Bus Types
| Bus |
Model |
Max Passengers |
Required Level |
| City Bus |
bus |
15 |
Level 1 |
| Airport Shuttle |
airbus |
20 |
Level 2 |
| Luxury Coach |
coach |
25 |
Level 3 |
Route System
- 5 default routes, unlimited custom routes via
/routebuilder
- Modes: Normal / Reverse / Round Trip
- Loop system: 1–5 laps per route with bonus multiplier
- Vue 3 NUI dashboard with GTA V satellite map (Leaflet.js)
- 3 dashboard tabs: Routes, Challenges, Stats
NPC Passenger System
| Type |
Chance |
Fare Multiplier |
| Normal |
50% |
1.0x |
| Student |
20% |
0.7x |
| Elderly |
15% |
0.5x |
| Tourist |
10% |
1.2x |
| VIP |
5% |
1.5x |
1st Person Payment System
- Card, Cash Exact, Cash Overpay, Cash Underpay
- Change system with denomination selection ($20, $10, $5, $1)
- Timed change return
- Random tip chance
- NPC speech bubbles during payment
Fare System
| Component |
Description |
| Base Fare |
Per-stop base fare |
| Zone Extra |
Additional fare per zone crossed |
| Night Surcharge |
Percentage surcharge during night hours |
| Student Discount |
Percentage discount for student NPCs |
| Elderly Discount |
Percentage discount for elderly NPCs |
Time-Based Demand System
Dynamic multipliers based on the in-game time of day:
| Period |
Hours |
Effect |
| Morning Rush |
7:00–9:00 |
Double passengers, +50% tips |
| Daytime |
9:00–17:00 |
Normal |
| Evening Rush |
17:00–19:00 |
Double passengers, +50% tips |
| Evening |
19:00–22:00 |
Slightly more passengers/tips, more VIPs |
| Late Night |
22:00–2:00 |
Fewer passengers, higher tips, more drunks |
| Early Morning |
2:00–7:00 |
Very few passengers, highest tips |
Weekend modifiers can be enabled separately with adjusted multipliers.
Driving Rating System
5-star rating based on driving behavior during a route:
| Penalty |
Deduction |
Trigger |
| Hard Brake |
-5 points |
Sudden deceleration above speed threshold |
| Collision |
-10 points |
Vehicle collision detected |
| Speeding |
-2 points |
Exceeding speed limit (checked periodically) |
| Red Light |
-15 points |
Running a red light |
| Stars |
Score |
Tip Modifier |
Bonus Modifier |
| ⭐⭐⭐⭐⭐ |
90+ |
2.0x |
+25% |
| ⭐⭐⭐⭐ |
75+ |
1.5x |
+10% |
| ⭐⭐⭐ |
55+ |
1.0x |
Normal |
| ⭐⭐ |
35+ |
0.5x |
-20% |
| ⭐ |
0+ |
0x |
-50% |
Daily Challenges
- 3 random challenges selected daily from a pool of 15
- Auto-resets at configurable hour (default: 6 AM server time)
- Challenge types: trips, passengers, earnings, perfect ratings, laps
- Each challenge has difficulty tier (easy/medium/hard) and reward
- Track progress in the Dashboard "Challenges" tab
- Claim rewards when completed
Bus Condition Management
Fuel System
- Fuel drains while driving (configurable rate)
- Separate idle drain rate when engine is on but not moving
- Warning at 25%, critical alert at 10%
- Fuel level displayed on route HUD
Vehicle Condition
- Engine and body health tracked as combined condition %
- Warning at 40%, critical at 20%
- Speed penalty when condition is critical
- Condition displayed on route HUD
Depot Maintenance
- When returning bus to depot, maintenance cost is calculated
- Cost breakdown: repair cost + fuel cost
- Automatically deducted from earnings
Player Level System
| Level |
Name |
Trips Required |
Earnings Bonus |
| 1 |
Newcomer |
0 |
0% |
| 2 |
Growing |
50 |
+5% |
| 3 |
Established |
150 |
+10% |
| 4 |
Major |
400 |
+15% |
| 5 |
Premium |
1,000 |
+20% |
- Saved to JSON file (no database required)
- Level unlocks higher-tier buses
- Bonus applied to all fare earnings
Stats & Leaderboard
- Personal Stats: Total trips, total revenue, total passengers, current rank
- Leaderboard: Top 20 players sorted by total trips
- Medals for top 3 (🥇🥈🥉)
- Accessible from the Dashboard "Stats" tab
Random Events (4 types)
| Event |
Description |
| Fare Evader |
Passenger tries to board without paying — report for bonus |
| Drunk Passenger |
Disruptive passenger — kick off or tolerate |
| Sick Passenger |
Emergency hospital detour — bonus for delivery |
| VIP Pickup |
High-value passenger with generous bonus |
Route HUD
- Route name and progress bar
- Next stop name
- Current passengers count
- Total earnings
- Fuel level bar (if bus condition enabled)
- Vehicle condition bar (if bus condition enabled)
- Driving rating stars
Other Features
- Route builder (
/routebuilder) — see Customization
- Depot return system with maintenance cost
- 7 sound effects (GTA V native audio)
- Multi-framework (QBCore/QBox/ESX/OX Core)
- Multi-target (ox_target/qb-target/qtarget/E key)
- Multi-language (i18n, Lua + JSON locale)
Last updated: February 28, 2026