> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apex-services.site/llms.txt
> Use this file to discover all available pages before exploring further.

# APEX Bus Job

> XP-driven routes, passenger sim, and an immersive NUI dashboard.

A professional bus driver job with XP/level progression, dynamic passenger simulation, 9 routes across two depots (Los Santos and Paleto Bay), and a polished NUI dashboard. Routes are level-gated and payout scales with route length and passenger count.

## Features

* 9 full-length routes across LSIA, Vinewood Hills, Mirror Park, South Central, Tataviam, Paleto, Grapeseed, Chiliad, Forest
* XP and level progression — routes gated by level, payout scales with XP per route + per passenger
* Dynamic passenger sim — stops, wait timers, actual peds start boarding.
* Immersive NUI dashboard with route previews and a NUI while you're on the job
* Bus license can be item required (`fuehrerschein` class C) — overridable via function
* Daily limit + cooldowns prevent XP farming^^

## Requirements

<CardGroup cols={2}>
  <Card title="Required" icon="circle-check">
    `es_extended`, `ox_lib`, `oxmysql`
  </Card>

  <Card title="Optional" icon="puzzle-piece">
    `vehiclekeys`, custom license system (via `Hooks.HasBusLicense`)
  </Card>
</CardGroup>

## Installation

1. Drop `apex-bus-job` into `resources/`
2. Import `sql.sql` (or rely on automatic table creation)
3. `ensure apex-bus-job`

## Configuration

```lua config.lua theme={null}
Config.RequireLicense = true
Config.LicenseClass   = 'C'
Config.DailyLimit     = 20000
Config.NeededXP       = 1200
Config.MaxKmForRoutes = 25
Config.XPPerRoute     = 200
Config.XPPerPassenger = 5
```

Ships with 2 depots, 9 routes (level 0–3), and a pre-configured driver uniform (male + female).

## Hooks

See [Hooks reference / Bus](/hooks/apex-bus-job). Key hooks: `Hooks.HasBusLicense`, `Hooks.OnQuestProgress`, `Hooks.ShowHelpPrompt`.

## Resource info

<Note>
  Code accessible: `config.lua`, `hooks.lua`, `locales/*`, `html/*`. Approximately 2500 lines of Lua + NUI. English + German.
</Note>