Online Report

Online Report (сокращенно OR или ОР) — текстовый код для передачи информации об онлайне на серверах MTA: Province, разработанный ботом ТБРУ. Основан на кодах SYNOP и METAR.

Код OR используется в «Архиве Онлайна» и приложении BusKassa.
Минимальный интервал выпуска «сводок по онлайну» — 1 минута, но чаще выпуск производится каждые 5 минут. В «сводках» содержится информация об онлайне на серверах и пароле (установлен или нет). Параллельно групповой сводке, содержащей всех онлайн серверов MTA: Province, ведется запись «персональных» сводок для каждого сервера отдельно, в которых хранятся дополнительные параметры.

Схема кода

hhmm S1P1OOOO/OmOmOmOm　S2P2OOOO/OmOmOmOm ... SnPnOOOO/OmOmOmOm

Группы кода разделены между собой пробелами

Группа	Содержание
hhmm	Время создания (обновления) кода. Записывается в формате ччмм, например: 1200 (12 часов 00 минут). Время указывается в московском часовом поясе.
SnPnOOOO/OmOmOmOm	Здесь Sn — кодовое обозначение сервера (номер сервера. Также может использоваться буква: S00115/0120).             Pn — информация об установленном пароле. 0 – пароль не установлен, 1 – пароль установлен.            OOOO — текущий онлайн на сервере. Записывается четырьмя символами. Если онлайн – не четырёхзначное число, то слева добавляются нули. (0123 – онлайн 123 игрока. 0001 – онлайн 1 игрок и т.д.).           / — разделитель текущего онлайна и количества слотов.           OmOmOmOm — максимальное количество игроков, которое может принять сервер. Аналогично текущему онлайну записывается четырьмя символами. Если указано 0000 – сервер недоступен.

Примеры

1215 100345/0815 200269/0815 300227/0815 400223/0815 500192/0815 600196/0815 71003/0815

1) Время получения онлайна: 12 часов 15 минут (МСК).
2) Онлайн на 1 сервере 345 из 815 игроков, сервер без пароля.
3) Онлайн на 2 сервере 269 из 815, сервер без пароля.
4) Онлайн на 3 сервере 227 из 815, сервер без пароля.
...
8) Онлайн на 7 сервере 3 из 815, сервер защищен паролем.

2000 100000/0000 200000/0000 300000/0000 400000/0000 500000/0000 600000/0000 700000/0000

1) Время получения онлайна: 20 часов 00 минут.
2) Первый сервер недоступен (буквально, онлайн 0 человек из 0).
...
8) Седьмой сервер недоступен.

OR1

OR1 (Online Report 1.0) — первая версия данного кода. Отличается от основной тем, что с помощью этого кода не передаётся информация об установленном пароле на сервере. С 12 декабря 2021 года бот ТБРУ был переведен на использование кода второй версии, а поддержка первой версии была полностью прекращена 1 января 2022 года. Ниже представлена схема кода первой версии:

hhmm 1OOOO/OmOmOmOm　2OOOO/OmOmOmOm ... SnOOOO/OmOmOmOm

ORS

ORS (Online Report Separated by servers) — Персональная «сводка», создаваемая отдельно для каждого сервера. Содержит дополнительную иформацию, которая не была добавлена в основной код или которую невозможно туда добавить. В отличие от основного кода, в ORS передаётся информация только об одном сервере. Схема кода ORS:

hhmm SnOOOO/OmOmOmOm Ppppp Ttttt 111 Pname ... 222 Ppppp Ttttt 333 Ppppp Ttttt

Группа	Содержание
Обязательная часть (обязательно присутствует в ORS)
hhmm	Время создания (обновления) кода. Записывается в формате ччмм, например: 1200 (12 часов 00 минут). Время указывается в московском часовом поясе.
SnPnOOOO/OmOmOmOm	Здесь Sn — кодовое обозначение сервера (номер сервера. Также может использоваться буква: S00115/0120).             Pn — информация об установленном пароле. 0 – пароль не установлен, 1 – пароль установлен.            OOOO — текущий онлайн на сервере. Записывается четырьмя символами. Если онлайн – не четырёхзначное число, то слева добавляются нули. (0123 – онлайн 123 игрока. 0001 – онлайн 1 игрок и т.д.).           / — разделитель текущего онлайна и количества слотов.           OmOmOmOm — максимальное количество игроков, которое может принять сервер. Аналогично текущему онлайну записывается четырьмя символами. Если указано 0000 – сервер недоступен.
Дополнительная часть (может не включатся в ORS)
Ppppp	Пинг сервера в мс (время, затраченное для получения онлайна). Первый символ, P, является индикатором того, что речь идет про пинг. Например: P0019 — пинг 19 миллисекунд. Максимальный пинг — 4 секунды. В случае, если сервер оффлайн, вместо пинга будет указано число, приблизительно равное 4000 мс.
Ttttt	TPS сервера (для Minecraft). Записывается с точностью до десятых (разделитель целой и дробной частей не ставится). Первый символ, T, является индикатором того, что речь идет про TPS. Не смотря на то, что TPS занимает три символа (с учётом десятых долей), записывается он четырьмя символами. Первым символом ставится 0. Например: T0199 — TPS 19,9.
Список игроков (может не включатся в ORS) 111 Pname1 Pname2 ...
111	Разделитель, отделяющий основной раздел от раздела со списком игроков. Разделитель ставится только в начале списка. В конце списка может быть указан разделитель другого раздела, либо ничего. Ники игроков разделены между собой пробелами.
Pname1	Никнейм игрока. Состоит из символа P и непосредственно никнейма name игрока. Символ P добавляется в начало каждого ника. Если в нике есть пробелы, то они будут заменены на «_» (Однако, наличие «_» не всегда говорит о пробеле в этом месте). Например: 1520 100002/0003 111 PWeekThor POleg — на сервере 2 игрока из 3: WeekThor и Oleg.
Минимальные значения (может не включатся в ORS) 222 Ppppp Ttttt
222	Разделитель, отделяющий основной раздел от раздела с минимумами. Разделитель ставится только в начале списка. В конце списка может быть указан разделитель другого раздела, либо ничего.
Ppppp	Минимальные значение пинга. Кодируется аналогично основному разделу. Предполагается, что здесь указано минимальное значение пинга между сроками выпуска «сводок», либо же минимальное значение пинга между «сводками», в которых включается данный параметр (в случае, если параметр включается не в каждой сводке).
Ttttt	Минимальные значение TPS. Кодируется аналогично основному разделу. Правила включения аналогичны правилам для минимального пинга.
Максимальные значения (может не включатся в ORS) 333 Ppppp Ttttt
333	Разделитель, отделяющий основной раздел от раздела с максимумами. Разделитель ставится только в начале списка. В конце списка может быть указан разделитель другого раздела, либо ничего.
Ppppp	Максимальное значение пинга. Кодируется аналогично основному разделу. Предполагается, что здесь указано максимальное значение пинга между сроками выпуска «сводок», либо же максимальное значение пинга между «сводками», в которых включается данный параметр (в случае, если параметр включается не в каждой сводке).
Ttttt	Максимальное значение TPS. Кодируется аналогично основному разделу. Правила включения аналогичны правилам для максимального пинга.

Параметры Ppppp и Ttttt могут включаться в любом порядке. Разделы 1, 2 и 3 должны включаться в порядке возрастания (сначала первый). Если один из разделов не передается в «сводке», он не включается.

Кодовое обозначение серверов

Каждому серверу в системах ТБРУ присвоено кодовое обозначение. Оно используется как в отчётах OnlineReport, так и в Архиве Онлайна. Кодовые обозначения были введены вместе с появлением кода OnlineReport второй версии, ранее использовался лишь номер сервера.

Кодовое обозначение состоит из одного символа и может содержать только цифры, латинские буквы и спецсимволы. Используется для идентификации сервера, информация о котором передается.

Команда боту ТБРУ /онлайн <код сервера> показывает график онлайна на сервере за последние 3 часа (кроме кодового обозначения sum). 

Используемые в настоящее время кодовые обозначения
Кодовое обозначение	Описание
1	Кодовое обозначение первого сервера.
2	Кодовое обозначение второго сервера.
3	Кодовое обозначение третьего  сервера.
4	Кодовое обозначение четвертого сервера.
5	Кодовое обозначение пятого сервера.
6	Кодовое обозначение шестого сервера.
7	Кодовое обозначение седьмого сервера.
8	Кодовое обозначение StressTest сервера.
R	Кодовое обозначение приватного сервера в Minecraft.
Зарезервированные и ранее использовавшиеся кодовые обозначения
Кодовое обозначение	Описание
9	Описание не представлено.
S	Планируемое кодовое обозначение для StressTest сервера. Не используется. Зарезервировано.
F	Кодовое обозначение приватного сервера в Minecraft. Зарезервировано. История сводок недоступна.
sum	Кодовое обозначение для суммарного онлайна серверов. Используется только в архиве онлайна.

Для информации об актуальных и зарезервированных кодовых обозначений используется специальный код ServerInfo (доступен также в формате JSON).

Код имеет вид:

Название категории
	Sn название сервера$ Дополнительная информация=
.Название скрытой категории
	Sn название сервера$ Дополнительная информация=

Символ $ обозначает конец названия. Символ = обозначает конец информации о сервере. Между этими символами может быть заключена дополнительная информация. Перед кодовым обозначением S_n присутствует символ табуляции. Точка в начале названия категории обозначает скрытую категорию (неиспользуемые или зарезервированные кодовые обозначения). Дополнительная информация записана с использованием сокращений. Чаще всего здесь указаны параметры сводок ORS для конкретного сервера. Пример ServerInfo:

MTA Province
	1 1 сервер$ Ping ER  RT 5m=

Список сокращений в ServerInfo
Сокращение	Расшифровка
AN	Alternative Name — альтернативное название сервера (название может включать пробелы. В конце названия не ставится символ доллара).
RT	Report Time — основная частота (срок) создания сводки по серверу. Указывается числом с суффиксом: RT 5m – раз в 5 минут, RT 1h — раз в час.
ER	Every Report — включается в каждой сводке.
Ping	Срок включения в сводку информации о пинге. Указывается числом, либо ER.
Players	В сводку включен список игроков. После сокращения может быть указан срок включения.

Ссылки

• https://waste.fantastic-game.ru/tbru/report.txt — информация об онлайне на серверах MTA: Province по схеме кода OR.
• Мониторинговая служба Провинции (ранее «Архив Онлайна»).
• https://waste.fantastic-game.ru/tbru/serverInfo — ServerInfo: Список всех кодовых обозначений. Доступен так же в формате JSON.