CreateTrainWebAPI

Этот мод добавляет эндпоинт для данных о положении поездов Create. Для установки просто поместите jar-файл в папку mods. По умолчанию используется порт 8080, его можно изменить в файле конфигурации.

Оверлей BlueMap

Чтобы отображать поезда, пути, станции, сигналы и порталы на карте, скопируйте train.js в webroot BlueMap (например, bluemap/web/), укажите в host в начале файла адрес этого API, видимый из браузера, и добавьте его в скрипты в webapp.conf BlueMap:

scripts: [
    "./train.js"
]

Клик по поезду показывает его скорость, пункт назначения, расписание и груз; клик по станции показывает ближайшие прибытия; клик по порталу переносит на карту другого измерения. Если BlueMap раздаётся по https, API тоже должен быть доступен по https (браузеры блокируют смешанный контент).

При использовании вместе с https://github.com/BeneHenke/BluemapCreateEntityAddon путь к моделям поездов также можно настроить в конфиге.

Эндпоинты

Все данные читаются из Create в потоке сервера и кэшируются, поэтому запросы никогда не обращаются к состоянию игры напрямую.

Пример конфига:

#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/"

Опциональные данные

Секция [data] конфига включает или отключает опциональную информацию. Отключённые данные вообще не собираются и в ответах равны null; /features сообщает текущие переключатели, а оверлей BlueMap скрывает всё отключённое. Позиции, пути и станции включаются всегда.

[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)