Installation & Dependencies

Advanced Bus Job ships as a three-resource product:

• lx-busjob — gameplay, terminal, contracts, passengers, fleet, and persistence
• lx-lib — framework bridge
• lx-navigation — GPS guidance and driver HUD

Install all three with their original folder names.

Dependencies

Required

Dependency	Purpose
One supported framework: Qbox (qbx_core), QB-Core (qb-core), or ESX Legacy (es_extended)	Players, identity, jobs, and cash payouts through lx-lib
ox_lib — installation/download	Locale loading, callbacks, notifications, and interaction UI
oxmysql — installation/download	Career stats and daily-contract persistence
lx-lib	Multi-framework player, money, lifecycle, and notification bridge
lx-navigation	Route pathing, GPS line, turn guidance, and driver HUD
OneSync setup + FiveM server artifacts (build 7290 or newer)	Required by lx-lib and the supported networked gameplay environment

Recommended, not required

Dependency	Purpose
ox_inventory — installation/download	Recommended inventory for the broader server stack, including ESX
qb-inventory — documentation	Supported lx-lib inventory alternative

The current Advanced Bus Job loop does not use item APIs, so an inventory is not required to drive routes or receive framework cash payouts.

Optional integrations

These are only needed when you select their matching integration in Config.Integrations:

• Fuel system
• Vehicle-key system
• Target system (ox_target installation or qb-target documentation)

If no target resource is selected, the built-in interaction prompt remains available. See Integrations for supported adapters and custom integration instructions. No banking resource is required; wages, tips, and bonuses are paid as framework cash.

Install

1. Download and place resources

Download all three resources from your Cfx.re account and place them under your resources directory:

resources/
  [lx]/
    lx-busjob/
    lx-lib/
    lx-navigation/

Do not rename the folders.

2. Configure start order

Start the chosen framework and dependencies before LX resources:

ensure ox_lib
ensure oxmysql
ensure qbx_core          # or qb-core / es_extended
ensure ox_inventory      # recommended; optional (or qb-inventory)

ensure lx-lib
ensure lx-navigation
ensure lx-busjob

Use only one supported framework. Use only the inventory your server actually runs.

lx-lib detects framework and inventory once at startup, so those adapters must already be started. If you change either adapter, restart lx-lib and lx-busjob.

Explicit ensure lines are recommended for first installation. They make dependency order visible and avoid relying on alphabetical category-folder startup.

3. Remove conflicting bus jobs

Stop or remove the stock bus job to prevent duplicate depot peds and blips:

# remove/comment if present
# ensure qbx_busjob

Also check for another bus resource using the same depot area.

4. Configure integrations

Review lx-busjob/config/shared.lua:

Config.Integrations = {
    fuel = 'auto',
    keys = 'auto',
    target = 'auto',
}

auto selects a supported, already-started adapter. For predictable production behavior, you may set an exact supported resource name after confirming your stack.

5. Start and verify

No manual SQL import is needed. Advanced Bus Job creates its oxmysql tables on startup.

Confirm:

• No red errors from lx-lib, lx-navigation, or lx-busjob
• Console reports the expected framework and inventory detection
• The Bus Depot blip and depot NPC appear
• The NPC opens the LST Operations Terminal
• A route starts, a bus spawns, and the navigation HUD appears
• Returning a completed shift pays framework cash and saves career progress
• Restarting each resource does not leave the FiveM “Loading game” indicator visible

If verification fails, see Troubleshooting & FAQ.