Награды участников
Команда -награда - выдача, снятие и просмотр наград в чате, название с описанием и номера в списке.
Награда - это строчка признания в профиле участника, у которой есть название и, если нужно, короткое описание. Условий у неё нет, вы сами решаете, за что её выдать, будь то конкурс, помощь чату или старая шутка, которую тут все помнят. Этим награды и отличаются от достижений чата.
Сам бот награждает пока только за уровни: дойдя до ключевого уровня, участник получает медаль автоматически, без вашего участия. Со временем автовыдача может появиться и за другое.
Всё управление собрано в одной команде с указанием действия.
-наградаНаграды участников: выдача, снятие и просмотр
-медаль-наградить/award<параметр> — обязательный[параметр] — необязательныйБез действия и без участника бот пришлёт короткую памятку с тем, что умеет команда.
| Действие | Что делает |
|---|---|
| Выдаёт участнику награду с названием и описанием. | |
| <номер> | Забирает у участника одну награду по её номеру в списке. |
| Показывает награды участника или ваши собственные. |
Иерархия здесь не проверяется, поэтому выдать награду или снять её можно у любого участника, даже у тех, кто выше вас по роли.
Не путайте -награда в единственном числе с -награды. Первая управляет наградами и доступна модераторам, вторая просто открывает список и работает у всех участников.
Выдать награду
-награда датьВыдаёт участнику награду с названием и описанием
-награда выдать-награда give<параметр> — обязательный[параметр] — необязательный<параметр> — обязательный[параметр] — необязательныйСлово дать можно писать, а можно и опустить, бот понимает оба варианта одинаково.
Название занимает первую строку и вмещает до 64 символов. Всё, что написано со следующей строки, становится описанием, его предел 255 символов. Описание необязательное.
Награда появляется в профиле сразу. В карточке видны последние пять, остальные открываются кнопкой, а весь список целиком показывает команда -награды.
Снять награду
-награда снятьЗабирает у участника одну награду по её номеру
-награда убрать-награда remove<параметр> — обязательный<параметр> — обязательныйНомер - это позиция награды в списке, а не какой-то отдельный код, так что сначала откройте список, а потом снимайте. Если такого номера у участника нет, бот об этом скажет и ничего не тронет.
После снятия номера пересчитываются: список стал короче, и всё, что было ниже, поднялось на позицию выше. Когда снимаете несколько наград подряд, сверяйтесь со списком заново перед каждой, иначе уйдёт не та.
Участник может отказаться от своей награды и сам, командой -награды снять.
Посмотреть награды
[параметр] — необязательныйБез участника команда покажет ваши награды, а с участником его. Это тот же список, что открывает -награды, с общим количеством наград, датой получения у каждой и описанием, если оно есть. Когда наград много, список разбивается на страницы с кнопками.
Что должно быть включено
Команда работает только в группах и только пока в настройках включён модуль «Награды». С выключенным модулем бот на команду не отвечает.
Там же включаются уведомления в админ-чат, и на каждую выдачу и снятие туда уходит отдельная запись с участником, названием награды и тем, кто это сделал. Для уведомлений нужен подключённый админ-чат.