Как пользоваться командами

Как устроена командаСкопировать ссылку

Команда состоит из префикса, ключевого слова и параметров. Бот поддерживает префиксы -, /, ., !. Регистр букв значения не имеет: -профиль и -ПРОФИЛЬ работают одинаково.

В примерах документации параметры оформлены так:

• <параметр> в угловых скобках - обязательное поле, без него команда не выполнится.
• [параметр] в квадратных скобках - необязательное поле, его можно пропустить.
• Параметры с длинным текстом (например, причина или заметка) пишутся с новой строки.

1-команда<участник>[срок]

2[причина]

<параметр> — обязательный[параметр] — необязательный

Как указать участникаСкопировать ссылку

Если команду нужно применить к другому пользователю, есть несколько способов:

• Ответ на сообщение: отправьте команду ответом на любое сообщение пользователя в чате. Это самый быстрый и безошибочный способ.
• Упоминание: упоминание через юзернейм, например -профиль @юзер.
• Цифровой ид: укажите числовой ид пользователя, например -профиль 123456789. Узнать ид любого участника можно командой -ид в ответ на его сообщение.
• Пересылка: перешлите сообщение пользователя в чат вместе с текстом команды.

Если не указывать пользователя, команда по умолчанию применяется к вам.

Указание времени и сроковСкопировать ссылку

В командах, где нужно задать срок (например, для реста или модерации), можно указывать точное время или интервал дат. Бот принимает как русские, так и английские обозначения.

Единицы измерения времениСкопировать ссылку

Составные срокиСкопировать ссылку

Единицы времени можно комбинировать в одной команде:

• 1д 12ч - один день и 12 часов
• 2ч 30м - два с половиной часа
• 1нед 3д - десять дней
• 1мес 10д - один месяц и десять дней

Разделителем может быть пробел, запятая или знак плюса: варианты 2ч 30м, 2ч, 30м и 2ч+30м сработают одинаково.

Диапазоны датСкопировать ссылку

Для длительных периодов (например, при запросе реста) удобно задавать точные календарные границы в формате ДД.ММ-ДД.ММ:

• 01.09-10.09 - с 1 по 10 сентября
• 25.12-10.01 - с 25 декабря по 10 января (бот сам учтет переход на следующий год)

Примеры использования в командахСкопировать ссылку

• -мрест 7д - запросить рест на неделю.
• -мрест 01.09-15.09 - оформить рест на определенные даты.
• -мут @юзер 30м - выдать ограничение на полчаса.
• -мут @юзер 1д 12ч - выдать ограничение на полтора дня.

Автоудаление и паузы между вызовамиСкопировать ссылку

Чтобы не засорять переписку в группе большими картинками и служебными кнопками, бот автоматически чистит свои сообщения:

• Карточки профиля и уровня удаляются сами через 45 секунд после отправки.
• Меню выбора фонов исчезает через 20 секунд.
• Для вызова профиля или смены фона действует небольшая пауза (обычно 10 секунд), чтобы защитить чат от случайного спама.

Если бот не отвечает на командуСкопировать ссылку

Если после отправки команды ничего не происходит или бот не присылает ожидаемый ответ:

• Проверьте статус бота: отправьте команду -пинг. Если бот молчит, возможно, у него нет прав на чтение и отправку сообщений в этом чате или теме.
• Убедитесь в префиксе: проверьте, что перед командой стоит один из символов (-, /, ., !) и нет лишнего пробела перед ним.
• Подождите пару секунд: если вы только что запрашивали карточку профиля или открывали меню фонов, бот может временно игнорировать частые повторные вызовы из-за кулдауна.
• Обратите внимание на уведомления: если команда требует прав администратора, модуль отключен в чате или введен неверный формат, бот пришлет сообщение с подсказкой.