Все команды бота ТБРУ

(ред. )

Здесь представлен актуальный список команд для бота «Онлайн серверов (ТБРУ)» (или просто ТБРУ).
Все указанные команды работают как с ботом ВКонтакте, так и с ботом в Telegram.

Формат ввода команды: /{команда} [аргументы…]

Для просмотра текущего онлайна можно просто ввести две косые черты: //

Если в Telegram-чате несколько ботов, ТБРУ будет реагировать только в том случае, если чат переключен на бота – особенность работы мессенджера. Для переключения телеграма на ТБРУ можно выбрать команду из списка в чате или ввести «/{команда}@provincetbru_bot [аргументы через пробел]». Между {команда} и @provincetbru_bot не должно быть пробела

Доступ к переписке боту не нужен.

Описание аргументов команд
Все аргументы должны быть введены в строгом порядке, указанном в описании команд.

Шаблон ввода аргумента Описание
<id> Обязательный аргумент.
Все обязательные аргументы обозначены треугольными скобками <…>
[номер страницы] Необязательный аргумент, его можно опустить (не вводить)
Все необязательные аргументы обозначены квадратными скобками […]
[a|b] Разделить | означает, что в качестве аргумента можно указать либо «a» либо «b»
[текст…] Многоточие в конце аргумента означает, что в аргументе можно использовать пробелы
<arg...> или [arg…] Аргументы временно отключены, бот на них не будет реагировать.

СПИСОК КОМАНД

Команды онлайна

/онлайн

Синтаксис: /онлайн [номер сервера]
Пример: /онлайн
Вариации: /online, /сервер

Команда показывает текущий онлайн на всех серверах MTA Province.
Если был указан номер сервера в качестве аргумента, то в ответном сообщении бот отправит краткую сводку по онлайну для указанного сервера: минимальный и максимальный онлайн за текущие сутки, пинг и аптайм сервера и поминутный график онлайна за последние 3 часа.

Примечание 1: StreesTest и Province OBT в системе имеют номер «8». 
Примечание 2: для получения графика суммарного онлайна вместо номера следует указать «sum»

/график

Синтаксис: /график [дата]
Пример: /график
Вариации: /диаграмма, /graphic

В ответ бот присылает поминутный график онлайна (график рисуется «с чистого листа» с 0:00). График обновляется раз в 10 минут

Если указана [дата], бот пришлет график за указанную дату (см. /архив


Команды архива

/архив

Синтаксис: /архив <дата> [номер сервера]
Пример: /архив 3.09.2021 или /архив 2022-12-06 1
Вариации: /archive

В ответном сообщении бот пришлет график онлайна в указанную дату. Если указан номер сервера, то вместо графика бот пришлет сохраненные в архиве данные для указанного сервера в виде текста (почасовой онлайн, минимальный и максимальный онлайн).

Дату можно указать любом из форматов: дд.мм.гггг, дд-мм-гггг, мм/дд/гггг, или гггг-мм-дд
Можно указать (английскими буквами): 1jan (1 января); 12jun25 (12 июня 2025) 31dec2019
Также можно указать относительную дату: -1year -5day (см. подробности в Формат даты)

Примечание 1: архив онлайна ведется с 1 января 2019 года.
Примечание 2:
StreesTest и Province OBT в системе имеют номер «8». 
Примечание 3: для получения архива суммарного онлайна вместо номера следует указать «sum».   

/сравнить

Синтаксис: /сравнить <номер сервера> <дата 1> [дата 2] … [дата 8]
Пример: /сравнить 5 18.04.2020 18.04.2021 18.04.2022
Вариации: /diff, /compare, /сравнение, /разница, /различие

В ответном сообщении бот отправит график онлайна для <номер сервера> сервера с несколькими линиями, соответствующие указанным датам. Можно указать от 1-й до 8-ми дат. Дата указывается в любом из форматов: дд.мм.гггг, дд-мм-гггг, мм/дд/гггг, или гггг-мм-дд (см. подробнее в Формат даты)

Если для одной из указанных дат данных не будет — эта дата не будет добавлена на график

Примечание 1: StreesTest и Province OBT в системе имеют номер «8».
Примечание 2: для сравнения суммарного (общего) онлайна в разные дни в качестве сервера следует указать «sum»


Команды бесед

/варны (Rate Limit)

Синтаксис: /варны
Пример: /варны
Вариации: /warnings, /warns

Покажет количество предупреждений в беседе и дату последнего использования или дату снятия игнорирования беседы ботом.

Примечание 1: предупреждения выдаются за слишком частое использование команд. При превышении лимита варнов бот включит режим игнорирования беседы, который автоматически снимается через 5 минут.
Примечание 2: время действия режима игнорирования может быть продлено.
Примечание 3: варны автоматически снимаются по истечению некоторого времени.

/название

Синтаксис: /название [текст…]
Пример: /название Беседа FantasticGame
Вариации: 

Покажет название беседы (в базе данных бота). Если задан аргумент [текст…], то установит [текст…] в качестве названия беседы в базе данных. Указанное название используется в команде /рейтинг. Беседы без названия в рейтинге отображаются как «CHATx1234567890»

/инфо

Синтаксис: /инфо 
Пример: /инфо
Вариации: /info

Покажет общую информацию о беседе, в которой была отправлена команда.
В общую информацию входят: id беседы в системе бота, id в социальной сети (SID), общее число использований бота, использования за текущий месяц и активность в текущем месяце по сравнению с предыдущим, дату последнего использования и количество варнов.

/рейтинг

Синтаксис: /рейтинг [старый|с названиями] [номер страницы]
Пример: /рейтинг 3; /рейтинг старый 5
Вариации: /rating

Покажет рейтинг бесед (по количеству использований за текущий месяц).
Если в качестве первого аргумента указано слово «старый», покажет рейтинг по общему количеству использований за всё время.
Если указать фразу «с названиями» – покажет в рейтинге только беседы с установленным названием.


Мини-игры

Игра «Лотерея»

Синтаксис: /лотерея 
Пример: /лотерея
Вариации: /lottery

Принять участия в ежедневой игре. Ежедневно в 18:00 (МСК) результаты игры публикуются сообщением в беседе, в которой была введена команда.
Стоимость участия — 35 баллов (см. ниже). Если не набралось необходимого числа участников, баллы возвращаются пользователю.

Примечание: Игра глобальная (Победители выбираются среди всех участников), однако в сообщении с результатами, которое бот рассылает в беседы, перечисляются только те пользователи, которые ввели в этой же беседе команду /лотерея.

Игра «Камень, ножницы, бумага»

Синтаксис: /кнб <камень|ножницы|бумага> [ставка: 1-15] или /кнб [ставка: 1-15] <камень|ножницы|бумага>
Пример: /кнб камень
Вариации: /кмб

Игра с ботом в «камень, ножницы, бумагу». Вы можете играть с ним на баллы, указав ставку от 1 до 15. Если вы побеждаете, то получаете указанную сумму себе, проигрываете – отдаете боту. В случае ничьей, ни у кого баллы не снимаются. Но будьте осторожны, бот не выдает случайным образом один из трех вариантов, а анализирует ваши предыдущие с ним игры.


Баллы

/перевод

Синтаксис: /перевод <id> <сумма баллов>
Пример: /перевод 58 199
Вариации: /перевести, /передать, /transfer, /pay

Перевод баллов (β), полученных в лотерее, другому пользователю бота. Указывать следует id пользователя в системе бота (посмотреть свой id можно командой /профиль)

/Обмен

Синтаксис: /обмен <сумма баллов> <номер сервера> <счет>
Пример: /вывод 199 1 123456
Вариации:

Обмен баллов (β), полученных в лотерее, на игровую валюту на указанном сервере.

Курс обмена непостоянен и в целом зависит от общего количества баллов в системе и от количества доступных на сервере денег (см. /курс).

Перевод баллов в игровую валюту осуществляется в течение 28 дней. Обмен осуществляется с комиссией: 6% от суммы. Минимальная комиссия 3β. Статус обмена (в обработке/деньги перечислены) можно узнать, введя команду /баллы обмен.

/баллы

Синтаксис: /баллы [[операции|обмен] [номер страницы]]
Пример: /баллы или /баллы операции 4
Вариации: /баланс, /balance, /money, /bal

Покажет Ваше количество баллов. Если указано слово «операции» или «обмен» — покажет список последних операций с баллами (переводы, выигрыши в /лотерее) или список обмена на игровую валюту (см. /обмен)
Примечание: Баланс может быть отрицательным, т.к. участие в /лотерея разрешено даже если на балансе недостаточно баллов.

/профиль

Синтаксис: /профиль
Пример: /профиль
Вариации: /profile

Бот присылает общую информацию о Вашем профиле: ID, ник и количество баллов

/курс

Синтаксис: /курс [количество баллов]
Пример: /курс 100
Вариации: /

Бот присылает курс обмена баллов, полученных в лотерее, на игровую валюту на сервере.


Прочие команды

/репостить

Синтаксис: /репостить
Пример: /репостить
Вариации: /уведомлять

Включает репосты новых записей из официального сообщества MTA Province

Примечание: бот проверяет стену официальной группы раз в несколько минут (точный интервал проверки указан в /статистика), поэтому может быть небольшая задержка между публикацией записи и репостом.

/нерепостить

Синтаксис: /нерепостить
Пример: /нерепостить
Вариации: /неуведомлять

Выключает репосты новых записей из официального сообщества MTA Province

/вики

Синтаксис: /вики <текст…>
Пример: /вики Приволжск
Вариации: /wiki

Поиск статей на первой провинциальной википедии ProvincePedia. Бот попытается найти статью, в названии или в тексте которой упоминается <текст…>. В ответ бот пришлет вырезку из статьи и ссылку на неё.

/ищи

Синтаксис: /ищи <текст…>
Пример: /ищи магнит
Вариации: /где, /найти

Поиск по карте OpenProvinceMap. Бот попытается найти на карте провинции объект (точку, здание и т.п.), в названии которого присутствует <текст…>. В ответ бот присылает «скриншот» карты с местоположением найденного объекта, название найденного объекта и ссылку на карту.

/статистика

Синтаксис: /статистика
Пример: /статистика
Вариации: /stats, /bank, /банк

Бот присылает свою статистику: количество пользователей, бесед, количество использований бота. 

Если была введена команда /банк бот также пришлет статистику баллов

/погода

Синтаксис: /погода [-r|-мс|мс] <код или город>
Пример: /погода мс Москва; /погода UUEE; /metar SVX; /погода 28441
Вариации: /weather, /metar

В ответ бот присылает фактические погодные условия на территории указанного аэропорта или данные с указанной метеостанции.

В качестве аргумента можно указать:

  1. ИКАО-/IATA-код аэропорта (ICAO — 4-х символьный код: USSS; IATA трехбуквенный: SVX).
    Погодные сводки передаются по ICAO-коду, но если Вы укажите IATA, бот попытается найти соответствующий ему ICAO-код.
  2. Индекс метеостанции, состоящий из пяти цифр (например, 28441). 
  3. Название города (станции). Название города должно быть написано на русском языке и с сохранением всех знаков («Ростов-на-Дону», но не «ростов на дону», «Ростов на дону», «Ростов»), чтобы бот смог найти ближайший аэропорт.

Бот показывает погоду только в том случае, если указанный (найденный) аэропорт участвует в международном обмене метеоинформацией. При этом отображается последняя выпущенная сводка погоды (см. Примечание). Информация обычно обновляется раз в 30 минут (в зависимости от аэропорта может быть чаще или реже).

Для метеостанций информация обновляется раз в три часа (иногда реже), но содержит более подробную информацию о погоде (количество осадков, температура почвы, минимальная и максимальная температура, высота снежного покрова и т.д.). Из-за редкого обновления преимущество отдаётся аэропортам и если по названию города бот отображает погоду аэропорта, достаточно перед городом указать «-мс» или «мс» или указать номер станции:
 — /погода Екатеринбург – показывает данные аэропорта;
 — /погода мс Екатеринбург – показывает данные метеостанции;
 — /погода 28440 – показывает данные метеостанции.

Примечание: Некоторые аэропорты могли по тем или иным причинам прекратить международный обмен информацией, и последняя погодная сводка может быть устаревшей (вплоть до 2008 года). Если по названию города отображается устаревшая информация, можно попробовать самому найти код другого ближайшего аэропорта или добавить флаг «-мс» перед названием города для получения данных с метеостанции (если она присутствует и отправляет свои данные).