Skip to content
LX Studios

Troubleshooting & FAQ

Startup issues

Section titled “Startup issues”

“Missing dependency: lx-lib” error on start

Section titled ““Missing dependency: lx-lib” error on start”

The product started before lx-lib, or lx-lib is not installed. Ensure lx-lib earlier in server.cfg:

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

Resource does not start / .fxap errors

Section titled “Resource does not start / .fxap errors”

The .fxap file delivered with each escrowed resource must stay in the resource root, unmodified. If it is missing, re-download the resource from your Cfx.re Keymaster account. Also confirm your server artifact is reasonably current (build 7290+).

The terminal UI does not open, or a “Loading game (X%)” chip sticks after start

Section titled “The terminal UI does not open, or a “Loading game (X%)” chip sticks after start”

Do not edit anything inside ui/dist and do not proxy UI assets through a CDN — all UI files (including map tiles) are local by design. If you modified ui/dist, restore the original files from your download.

Gameplay questions

Section titled “Gameplay questions”

Passengers are not boarding

Section titled “Passengers are not boarding”
  • You must stop within the stop radius (Config.StopRadius, default 12 m) at the shelter
  • Doors must be opened (below Config.DoorOpenMaxSpeed) — passengers use the curb door defined per vehicle in config/vehicles.lua
  • If you added a custom fleet vehicle, verify its doors.board index is the curb-side door

Players earn too much / too little

Section titled “Players earn too much / too little”

Tune Config.PayScale and Config.Contracts in config/contracts.lua — see Economy & Contracts. Pay scales with route length automatically, so a single multiplier change rebalances every route.

Can I move the depot?

Section titled “Can I move the depot?”

Yes — Config.Depot, Config.BusSpawn, and Config.ReturnZone in config/shared.lua. See Configuration.

Can I add my own buses or routes?

Section titled “Can I add my own buses or routes?”

Yes, both are config-only. See Routes & Fleet.

Does it work with ESX / QB-Core / Qbox?

Section titled “Does it work with ESX / QB-Core / Qbox?”

Yes — one build supports all three through lx-lib. We recommend ox_inventory on ESX.

Is Quasar (qs-*) supported?

Section titled “Is Quasar (qs-*) supported?”

No. There are no Quasar integrations.

Framework notes

Section titled “Framework notes”
  • Qbox — vehicle keys use qbx_vehiclekeys automatically
  • QB-Core — qb-vehiclekeys and qb-target auto-detect
  • ESX — pair with ox_inventory and any supported fuel/keys resource

Still stuck?

Section titled “Still stuck?”

Open a ticket in our Discord with:

  1. Your framework and version
  2. The full console error (F8 client / server console)
  3. Your Config.Integrations block
  4. What you changed most recently