Команда /ban
🔨 Оставь вредителя без доступа к чату!
[Содержание]
[Описание]
💁♂️ Команда выгоняет пользователя из чата на указанное время или навсегда.
💁♂️ Использовать команду можно отвечая на сообщение нарушителя или указывая в команде его Username или ID.
[Как использовать]
❗️ Необходимо ответить командой на сообщение нарушителя или указать в команде его Username или ID.
❗️ <…> — Обязательный аргумент, […] — Необязательный аргумент
/ban [time] [id123456] [@username] [причина]
❗️ Порядок аргументов не важен. Причина указывается только в следующей строке команды.
❗️ Указывая ID используйте буквы id чтобы обозначить его.
/ban id12345678 [time]
❗️ Указывая Username используйте знак @ чтобы обозначить его.
/ban @username [time]
У команды есть приоритет проверки пользователя.
- В первую очередь проверяется был ли ответ на сообщение нарушителя
- Дальше проверяется первый найденный @Username
- Дальше проверяется первый найденный id123456
❗️ Ограничить за 1 раз несколько пользователей невозможно.
💁♂️ Время [time] можно указывать несколькими способами. Поддерживается как человеческий так и машинный язык.
Если не указывать время — то наказание выдаётся навсегда.
🤵 Примеры человеческого языка:
💁♂️ Якори (буква обозначающая время) упрощают и ускоряют процесс наказания.
➡️ В ответ на сообщение нарушителя:
/ban 5 минут Нарушитель, не бушуй
➡️ Используя аргументы @Username или id123456:
/ban 5m @username Нарушитель, не бушуй
/ban 1h30m id12345678 Нарушитель, не бушуй
[Итог]
- Если бот понял команду → он отправит в чат результирующее сообщение с текстом, который содержит имя нарушителя, время наказания, ответственного админа и причину наказания.
- Если вы допустили ошибку в команде → бот отправит сообщение с документацией.