CreateTrainWebAPI

This mod adds an endpoint for the postion data of the create trains. To install simply place the jar file into the mods folder. By default it uses port 8080, this can be changed in the config file.

BlueMap overlay

To show trains, tracks, stations, signals and portals on the map, copy train.js into BlueMap's webroot (e.g. bluemap/web/), set host at the top of the file to the address of this API as seen from the browser, and add it to the scripts in BlueMap's webapp.conf:

scripts: [
    "./train.js"
]

Clicking a train shows its speed, destination, schedule and cargo; clicking a station shows the next arrivals; clicking a portal jumps to the map of the other dimension. If BlueMap is served over https, the API must be reachable over https as well (browsers block mixed content).

When used together with https://github.com/BeneHenke/BluemapCreateEntityAddon the path to the train models can be configured in the config aswell.

Endpoints

All data is read from Create on the server thread and cached, so requests never touch the game state directly.

Example config:

#Webserver Port
# Default: 8080
# Range: 1 ~ 65535
serverPort = 8080
#Webserver hostname
serverHost = "0.0.0.0"
#Path of the train models
trainModelPath = "bluemap/train_models/"

Optional data

The [data] section of the config turns optional information on or off. Disabled data is not collected at all and is null in the answers; /features reports the current switches, and the BlueMap overlay hides whatever is disabled. Positions, tracks and stations are always included.

[data]
    owner = true           # train owner (uuid and player name)
    trainStatus = true     # speed, max speed, derailed
    passengers = true      # number of players on board
    navigation = true      # destination, distance to it, waiting at a signal
    schedule = true        # schedule title, current stop, state, wait reason
    route = true           # planned route to the destination
    stationArrivals = true # per station: train at the platform, arriving train, next arrivals
    signals = true         # signals, signal states and occupied signal blocks
    portals = true         # track nodes linked through portals
    cargo = true           # train inventories and tanks (/cargo)