🚍Bus Driver Pro

Bus Driver Pro is a bus script for FiveM that takes the bus driving experience to a new level with innovative features like voice announcements, round trip mode and even a drag & drop route editor.

Links and Other Information

FiveM Forum Post: https://forum.cfx.re/t/bus-driver-pro-2-0-the-ultimate-bus-job/5193393

YouTube Video: https://www.youtube.com/watch?v=lfiW2ipvUXg&t=1s

Download: https://garmingo.com/games/tebex/4292685

Installing Bus Driver Pro

This guide will show you how to install Bus Driver Pro.

This guide is very detailed but the basics that are always the same can be found in the Installation tutorial and should be enough for most server owners.

Please note that this guide is written for Bus Driver Pro version 1.4.0 and the installation might be different for older or newer versions.

1. Unpack the file you downloaded before. Now there are three folders: BusDriverPro, Voice Packs and Translations

2. Copy the BusDriverPro folder to your FiveM servers resources folder.

3. Open the config.json file included in your just copied BusDriverPro folder.

4. Enter the Transaction ID you got with your Purchase in the TransactionID field.

5. Edit the config file to your likings and close it (do not forget to save).

6. Open your servers config.cfg file and enter ensure BusDriverPro in a new line.

Installing Translations

Please note that third party translations could contain malicious code and you should read through them before installing them. All translations included with your Bus Driver Pro download are offical translations and are not containing malicious code.

The english version of Bus Driver Pro is already pre-installed and you do not have to install any additional translations to use Bus Driver Pro in english.

1. Open the folder you got with your Bus Driver Pro download. It contains three folders: BusDriverPro, Voice Packs and Translations.

2. Open the Translations folder.

3. Open the folder of the language you want to use. In my case, German.

4. Copy all files in there into your Bus Driver Pro installation (the BusDriverPro folder in your FiveM servers resources folder).

   1. If it asks if you want to replace or skip, select Replace.

5. Restart the script

Installing Voice Packs

Please note that third party voice packs could contain malicious code and you should read through them before installing them. All voice packs included with your Bus Driver Pro download are offical voice packs and are not containing malicious code.

The english male version of Bus Driver Pro is already pre-installed and you do not have to install any additional translations to use Bus Driver Pro with the male english voice.

1. Open the folder you got with your Bus Driver Pro download. It contains three folders: BusDriverPro, Voice Packs and Translations.

2. Open the Voice Packs folder.

3. Open the folder of the voice pack you want to use. In my case, Female Voice.

4. Copy all files in there into the sounds folder of your Bus Driver Pro installation (the BusDriverPro folder in your FiveM servers resources folder).

   1. If it asks if you want to replace or skip, select Replace.

5. Restart the script

Upgrading to version 1.4.0

Please note that you can simply reinstall Bus Driver Pro if you know what your settings are. This guide is only needed if you want to keep your old config.json file.

Please note that this guide might not work if you are using a Bus Driver Pro version older than 1.2.0.

1. Open the config.json file, that is located inside your Bus Driver Pro folder

2. Search for the ChargeSecurityDeposit entry

3. Create the following two entries, below it:

   "ChargeFromAccount": false,
   "ChargeAccount": "bank",

4. Seach for the AddToBank entry

5. Rename the AddToBank entry to AddToAccount

6. Create the following entry, below it:

   "AddToAccount": false,
   "Account": "bank",

7. Change the value of the Account entry to the account you want to use, for example society_bus if you have a bus company

Using esx_society

Please note that esx_society is only available in Bus Driver Pro version 1.4.0 and above.

1. Open the config.json file, that is located inside your Bus Driver Pro folder

2. Search for the Account entry

3. Change the value of the Account entry (default: bank) to the name of your societies account (usually society_SOCIETYNAME) in my case society_bus

4. Restart Bus Driver Pro

Key System implementation

Please note that the implementation for car key systems is only included in Bus Driver Pro version 1.6.2 or newer.

Please note that this is a client side event. If your car key system needs server side implementation you will have to implement the bridge yourself.

Bus Driver Pro has an event called BusDriverPro:CarSpawned that is triggered whenever a bus is being spawned for the player.

Parameters

1. Vehicle Handle

   Can be used to retrieve the vehicle object or for native calls

2. License Plate

   Can be used as identifier for some key resources

Example implementation

C# Example

EventHandlers["BusDriverPro:CarSpawned"] += new Action<int, string>(TargetFunction);

private void TargetFunction(int handle, string plate)
{
    myKeyScript.unlockCar(handle);
}

Lua Example

AddEventHandler("BusDriverPro:CarSpawned", function(handle, plate)
    myKeyScript.unlockCar(handle)
end)

JS Example

on('BusDriverPro:CarSpawned', (handle, plate) => {
    myKeyScript.unlockCar(handle);
});