Bus Service

{:links-list}

INSTALLATION

  1. Open the downloaded ZIP product file and drop the folder in it somewhere in your resources folder.
  2. Add your product key (get it here) to the settings.ini file
  3. Add start BigDaddy-BusService to your server.cfg.

DO NOT RENAME THE FOLDER.

If you change the name of the folder it will not function correctly so leave the name as it is.

{:is-danger}

COMPATIBILITY/INTEGRATION

This is built to work with frameworks.

CONFIGURATION

SETTING DEFAULT DESCRIPTION
[licensing]
key1 none This is where you put your product key
[settings]
debug false turns on lots of log items for debugging. Only needed if BDS asks you so turn it on

ROUTES

There is a routes.json that contains all the route data. It is preconfigured with FOUR routes (shown on the included route map). You can add or edit routes but it is HIGHLY RECOMMENDED that you do not. Since the AI are really terrible at driving the buses, we spent many, many hours tweaking the routes to make them drive the route successfully, usually. But if you still insist on adding or editing this is the format of the data. Again, I STRONGLY recommend you don't mess with it.

[
    {
        "id": 1, //route must have unique id
        "routeInfo": {
            "color": 3, //color of blips
            "model": "bus", //model of bus
            "busNum": 3, //how many buses can be running at one time 
            "timeBetweenBuses": 750, //milliseconds between spawning buses
            "startHeading": 341.95 //heading the bus will spawn facing

        },
        "busStops": [
            {
                "pos": { //the coords of the stop
                    "X": 1203.57,
                    "Y": -781.95,
                    "Z": 56.95
                },
                "stop": true, //if true, the bus will stop here, if false it is just a waypoint to help in navigation
                "precise": false //if true the bus will aim directly for the coords, if false it will aim for the nearest road node
            }
        ]
    }
]

HOW TO PLAY

Bus stops are marked on the map. Buses run on cycles from 5 to 10 minutes so one will be there somewhat soon. When a bus comes, get on. It'll charge you (if using money). If you don't have enough money they will throw you off the bus. When you get to the stop you want, get off. You CAN get on a bus that is not at a stop. It'll stop and open the doors for you.