Редактирование: Online Report

== Схема кода ==
 hhmm S<sub>1</sub>P<sub>1</sub>OOOO/O<sub>m</sub>O<sub>m</sub>O<sub>m</sub>O<sub>m</sub>　S<sub>2</sub>P<sub>2</sub>OOOO/O<sub>m</sub>O<sub>m</sub>O<sub>m</sub>O<sub>m</sub> ... S<sub>n</sub>P<sub>n</sub>OOOO/O<sub>m</sub>O<sub>m</sub>O<sub>m</sub>O<sub>m</sub>
Группы кода разделены между собой пробелами
{| class="wikitable" style="border-collapse: collapse; "
|- 
! Группа
! Содержание
|- 
| hhmm
| Время создания (обновления) кода. Записывается в формате ''ччмм'', например: 1200 (12 часов 00 минут). Время указывается в московском часовом поясе.
|- 
|
S<sub>n</sub>P<sub>n</sub>OOOO/O<sub>m</sub>O<sub>m</sub>O<sub>m</sub>O<sub>m</sub>
|
Здесь S<sub>n</sub> — кодовое обозначение сервера (номер сервера. Также может использоваться буква: S00115/0120).&nbsp;

&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;P<sub>n</sub> — информация об установленном пароле. <span style="text-decoration: underline;">0</span> – пароль не установлен, <span style="text-decoration: underline;">1</span> – пароль установлен.

&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;OOOO — текущий онлайн на сервере. Записывается четырьмя символами. Если онлайн – не четырёхзначное число, то слева добавляются нули. (0123 – онлайн 123 игрока. 0001 – онлайн 1 игрок и т.д.).

&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp;/ — разделитель текущего онлайна и количества слотов.

&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; O<sub>m</sub>O<sub>m</sub>O<sub>m</sub>O<sub>m</sub> — максимальное количество игроков, которое может принять сервер. Аналогично текущему онлайну записывается четырьмя символами. Если указано 0000 – сервер недоступен.
|}

== Примеры ==
'''1215 100345/0815 200269/0815 300227/0815 400223/0815 500192/0815 600196/0815 71003/0815'''

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



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

1) Время получения онлайна: 20 часов 00 минут.<br>2) Первый сервер недоступен (буквально, онлайн 0 человек из 0).<br>...<br>8) Седьмой сервер недоступен.
== OR1 ==
'''OR1''' (''Online Report 1.0'') — первая версия данного кода. Отличается от основной тем, что с помощью этого кода не передаётся информация об установленном пароле на сервере. С 12 декабря 2021 года бот ТБРУ был переведен на использование кода второй версии, а поддержка первой версии была полностью прекращена 1 января 2022 года{{Источник2|название=Приказ о переходе на схему кода OnlineReport 2.0|автор=Мониторинговая служба Провинции (ТБРУ)|ссылка=https://fantastic-game.ru/TBRU/docs/order_8.pdf|дата обращения=06.12.2021}}. Ниже представлена схема кода первой версии:
 hhmm 1OOOO/O<sub>m</sub>O<sub>m</sub>O<sub>m</sub>O<sub>m</sub>　2OOOO/O<sub>m</sub>O<sub>m</sub>O<sub>m</sub>O<sub>m</sub> ... S<sub>n</sub>OOOO/O<sub>m</sub>O<sub>m</sub>O<sub>m</sub>O<sub>m</sub>

== ORS ==
'''ORS''' (''Online Report Separated by servers'') — Персональная «сводка», создаваемая отдельно для каждого сервера. Содержит дополнительную иформацию, которая не была добавлена в основной код или которую невозможно туда добавить. В отличие от основного кода, в&nbsp;''ORS'' передаётся информация только об одном сервере. Схема кода&nbsp;''ORS'':
 hhmm S<sub>n</sub>OOOO/O<sub>m</sub>O<sub>m</sub>O<sub>m</sub>O<sub>m</sub> Ppppp Ttttt 111 Pname ... 222 Ppppp Ttttt 333 Ppppp Ttttt

{| class="wikitable" style="border-collapse: collapse; "
|- 
! Группа
! Содержание
|- 
! colspan="2" | Обязательная часть (обязательно присутствует в ORS)
|- 
| hhmm
| Время создания (обновления) кода. Записывается в формате ''ччмм'', например: 1200 (12 часов 00 минут). Время указывается в московском часовом поясе.
|- 
|
S<sub>n</sub>P<sub>n</sub>OOOO/O<sub>m</sub>O<sub>m</sub>O<sub>m</sub>O<sub>m</sub>
|
Здесь S<sub>n</sub> — кодовое обозначение сервера (номер сервера. Также может использоваться буква: S00115/0120).&nbsp;

&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;P<sub>n</sub> — информация об установленном пароле. <span style="text-decoration: underline;">0</span> – пароль не установлен, <span style="text-decoration: underline;">1</span> – пароль установлен.

&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;OOOO — текущий онлайн на сервере. Записывается четырьмя символами. Если онлайн – не четырёхзначное число, то слева добавляются нули. (0123 – онлайн 123 игрока. 0001 – онлайн 1 игрок и т.д.).

&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp;/ — разделитель текущего онлайна и количества слотов.

&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; O<sub>m</sub>O<sub>m</sub>O<sub>m</sub>O<sub>m</sub> — максимальное количество игроков, которое может принять сервер. Аналогично текущему онлайну записывается четырьмя символами. Если указано 0000 – сервер недоступен.
|- 
! colspan="2" | Дополнительная часть (может не включатся в ORS)
|- 
| Ppppp
| Пинг сервера в мс (время, затраченное для получения онлайна). Первый символ, ''P'', является индикатором того, что речь идет про пинг.
Например: P0019 — пинг 19 миллисекунд.

Максимальный пинг — 4 секунды. В случае, если сервер оффлайн, вместо пинга будет указано число, приблизительно равное 4000 мс.
|- 
| Ttttt
| TPS сервера (для Minecraft). Записывается с точностью до десятых (разделитель целой и дробной частей не ставится). Первый символ, ''T'', является индикатором того, что речь идет про TPS. Не смотря на то, что TPS занимает три символа (с учётом десятых долей), записывается он четырьмя символами. Первым символом ставится 0.
Например: T0199 — TPS 19,9.
|- 
! colspan="2" | Список игроков (может не включатся в ORS)<br>
111 Pname<sub>1</sub> Pname<sub>2</sub> ...
|- 
| 111
| Разделитель, отделяющий основной раздел от раздела со списком игроков. Разделитель ставится только в начале списка. В конце списка может быть указан разделитель другого раздела, либо ничего. Ники игроков разделены между собой пробелами.
|- 
| Pname<sub>1</sub>
| Никнейм игрока. Состоит из символа ''P'' и непосредственно никнейма ''name'' игрока. Символ ''P'' добавляется в начало каждого ника. Если в нике есть пробелы, то они будут заменены на «_» (Однако, наличие «_» не всегда говорит о пробеле в этом месте).

Например: 1520 100002/0003 111 PWeekThor POleg — на сервере 2 игрока из 3: WeekThor и Oleg.
|- 
! colspan="2" | Минимальные значения (может не включатся в ORS)<br>
222 Ppppp Ttttt
|- 
| 222
| Разделитель, отделяющий основной раздел от раздела с минимумами. Разделитель ставится только в начале списка. В конце списка может быть указан разделитель другого раздела, либо ничего.
|- 
| Ppppp
| Минимальные значение пинга. Кодируется аналогично основному разделу. Предполагается, что здесь указано минимальное значение пинга между сроками выпуска «сводок», либо же минимальное значение пинга между «сводками», в которых включается данный параметр (в случае, если параметр включается не в каждой сводке).
|- 
| Ttttt
| Минимальные значение TPS. Кодируется аналогично основному разделу. Правила включения аналогичны правилам для минимального пинга.
|- 
! colspan="2" | Максимальные значения (может не включатся в ORS)<br>
333 Ppppp Ttttt
|- 
| 333
| Разделитель, отделяющий основной раздел от раздела с максимумами. Разделитель ставится только в начале списка. В конце списка может быть указан разделитель другого раздела, либо ничего.
|- 
| Ppppp
| Максимальное значение пинга. Кодируется аналогично основному разделу. Предполагается, что здесь указано максимальное значение пинга между сроками выпуска «сводок», либо же максимальное значение пинга между «сводками», в которых включается данный параметр (в случае, если параметр включается не в каждой сводке).
|- 
| Ttttt
| Максимальное значение TPS. Кодируется аналогично основному разделу. Правила включения аналогичны правилам для максимального пинга.
|}

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

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

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

Команда боту ТБРУ&nbsp;''/онлайн &lt;код сервера&gt;'' показывает график онлайна на сервере за последние 3 часа (кроме кодового обозначения&nbsp;''sum'').&nbsp;
{| class="wikitable" style="text-align: center"
|- 
! colspan="2" | Используемые в настоящее время кодовые обозначения
|-
! Кодовое обозначение
! Описание
|- 
| 1
| Кодовое обозначение первого сервера.
|- 
| 2
| Кодовое обозначение второго сервера.
|- 
| 3
| Кодовое обозначение третьего&nbsp; сервера.
|- 
| 4
| Кодовое обозначение четвертого сервера.
|- 
| 5
| Кодовое обозначение пятого сервера.
|- 
| 6
| Кодовое обозначение шестого сервера.
|- 
| 7
| Кодовое обозначение седьмого сервера.
|- 
| 8
| Кодовое обозначение [[ST сервер|StressTest сервер]]а.
|- 
| R
| Кодовое обозначение приватного сервера в Minecraft.
|- 
! colspan="2" | Зарезервированные и ранее использовавшиеся кодовые обозначения
|-
! Кодовое обозначение
! Описание
|-
| 9
| ''Описание не представлено''.
|-
| S
| Планируемое кодовое обозначение для StressTest сервера. <br>Не используется. <br>Зарезервировано.
|-
| F
| Кодовое обозначение приватного сервера в Minecraft. <br>Зарезервировано. <br>История сводок недоступна.
|- 
| sum
| Кодовое обозначение для суммарного онлайна серверов. <br>Используется только в архиве онлайна.
|}

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

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

 Название категории
 	S<sub>n</sub> название сервера$ Дополнительная информация=
 .Название скрытой категории
 	S<sub>n</sub> название сервера$ Дополнительная информация=

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

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

{| class="wikitable"
|- 
! colspan="2" | Список сокращений в ServerInfo
|-
!  Сокращение
! Расшифровка
|- 
| style="text-align: center" | AN
| Alternative Name — альтернативное название сервера (название может включать пробелы. В конце названия не ставится символ доллара).
|- 
| style="text-align: center" | RT
| Report Time — основная частота (срок) создания сводки по серверу. Указывается числом с суффиксом: RT 5m – раз в 5 минут, RT 1h — раз в час.
|- 
| style="text-align: center" | ER
| Every Report — включается в каждой сводке.
|- 
| style="text-align: center" | Ping
| Срок включения в сводку информации о пинге. Указывается числом, либо ''ER''.
|- 
| style="text-align: center" | Players
| В сводку включен список игроков. После сокращения может быть указан срок включения.
|}
== Ссылки ==
* https://waste.fantastic-game.ru/tbru/report.txt — информация об онлайне на серверах MTA: Province по схеме кода OR.
* [https://m.fantastic-game.ru/archive.php Мониторинговая служба Провинции] (''ранее «Архив Онлайна»'').
* https://waste.fantastic-game.ru/tbru/serverInfo — ServerInfo: Список всех кодовых обозначений. Доступен так же в формате [https://waste.fantastic-game.ru/tbru/serverInfo.json JSON].

== Примечания ==
<references />
@@ Строка 1: / Строка 1: @@
-'''Online Report''' (''сокращенно OR или ОР'') — текстовый код для передачи информации об онлайне на серверах [[MTA: Province]], разработанный [[Онлайн серверов (ТБРУ)|ботом ТБРУ]]. Основан на кодах [[wikipedia:ru:КН-01|SYNOP]] и [[wikipedia:ru:METAR|METAR]].
-Код OR используется в «Архиве Онлайна» и приложении [[BusKassa (Приложение)|BusKassa]].<br>Минимальный интервал выпуска «сводок по онлайну» — 1 минута, но чаще выпуск производится каждые 5 минут. В «сводках» содержится информация об онлайне на серверах и пароле (установлен или нет). Параллельно групповой сводке, содержащей всех онлайн серверов [[MTA: Province]], ведется запись «персональных» сводок для каждого сервера отдельно, в которых хранятся дополнительные параметры.
 == Схема кода ==
   hhmm S<sub>1</sub>P<sub>1</sub>OOOO/O<sub>m</sub>O<sub>m</sub>O<sub>m</sub>O<sub>m</sub>　S<sub>2</sub>P<sub>2</sub>OOOO/O<sub>m</sub>O<sub>m</sub>O<sub>m</sub>O<sub>m</sub> ... S<sub>n</sub>P<sub>n</sub>OOOO/O<sub>m</sub>O<sub>m</sub>O<sub>m</sub>O<sub>m</sub>