March 11, 2022

Команда /mute

🤫 Заглуши вредителя!


[Содержание]


[Описание]

💁‍♂️ Команда запрещает пользователю писать в чате на указанное время или навсегда.

💁‍♂️ Использовать команду можно отвечая на сообщение нарушителя или указывая в команде его Username или ID.


[Как использовать]

❗️ Необходимо ответить командой на сообщение нарушителя или указать в команде его Username или ID.

🤓 Синтаксис команды:

❗️ <…> — Обязательный аргумент, […] — Необязательный аргумент

/mute [time] [id123456] [@username]
[причина]

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

❗️ Указывая ID используйте буквы id чтобы обозначить его.

/mute id12345678 [time]

❗️ Указывая Username используйте знак @ чтобы обозначить его.

/mute @username [time]

❗️ Важно:

У команды есть приоритет проверки пользователя.

  1. В первую очередь проверяется был ли ответ на сообщение нарушителя
  2. Дальше проверяется первый найденный @Username
  3. Дальше проверяется первый найденный id123456

❗️ Ограничить за 1 раз несколько пользователей невозможно.

💁‍♂️ Время [time] можно указывать несколькими способами. Поддерживается как человеческий так и машинный язык.

Если не указывать время — то наказание выдаётся навсегда.

🤵 Примеры человеческого языка:

  • 5 минут
  • 1 час и 30 минут
  • 1 неделя 2 дня 12 часов 30 минут

🤖 Примеры машинного языка:

  • 5m
  • 1h30m
  • 1w2d12h30m

💁‍♂️ Якори (буква обозначающая время) упрощают и ускоряют процесс наказания.

📝 Существуют такие якори:

  • s - секунды
  • m - минуты
  • h - часы
  • d - дни
  • w - недели

📝 Примеры:

➡️ В ответ на сообщение нарушителя:

/mute 5 минут
Нарушитель, не бушуй

➡️ Используя аргументы @Username или id123456:

/mute 5m @username
Нарушитель, не бушуй
/mute 1h30m id12345678
Нарушитель, не бушуй

[Итог]

  • Если бот понял команду → он отправит в чат результирующее сообщение с текстом, который содержит имя нарушителя, время наказания, ответственного админа и причину наказания.
  • Если вы допустили ошибку в команде → бот отправит сообщение с документацией.

[⬆️⬆️⬆️]