Documentation

Pepper Bus (Open Source)

Bus driver career with real line service, schedules, 50 levels and an in-game route editor – ESX Legacy.

Overview

Pepper Bus is a long-term bus driver career for ESX Legacy: real lines with stops, NPC passengers getting on and off, a live schedule with punctuality, 50 levels, reputation, 10 line types, ratings, challenges, an optional player-run bus company and an in-game route editor for admins. Everything is controlled from the driver tablet at the bus depot.

Requirements

Requirement Version
FiveM server build ≥ 7290 with OneSync
Framework ESX Legacy 1.9+
Database oxmysql

ox_lib, ox_target and ox_inventory are not required.

Installation

  1. Download the resource from the Cfx.re portal (Granted Assets)
  2. Extract it to resources/[pepper]/pepper_bus
  3. Import sql/install.sql – or keep Config.Database.AutoInstall = true and the resource creates the tables itself. On first start the 14 default lines are created.
  4. In your server.cfg:
ensure oxmysql
ensure es_extended
ensure pepper_bus
  1. Grant admin permissions (see README.md), then drive the default lines once and adjust stops in the route editor
  2. Restart the server, drive to the bus depot (bus icon) and press E

Route editor

Tablet (F7) → Admin → Line editor: create a line, drive the route and add stops at your position (button or /busstop), reorder them, preview them on the map and start a test run. Lines are stored in the database – updates of the resource never overwrite them.

Configuration

All settings are open in config/: stops and dwell times, schedule, payouts, levels, passenger types, line types, vehicles, challenges and the company. Set the language with Config.Locale (de or en).

Support

Questions and bugs: please open a ticket on our Discord: https://discord.gg/6NaFJWKDYu


Found a mistake? Report it on Discord.