Как устроена модерация
Общие правила всех команд наказаний - кого можно наказать, как указать участника, какие сроки и причины понимает бот.
Команды модерации устроены похожим образом. Участника можно указать несколькими способами, срок записывается в одном формате, а причина начинается со второй строки. Здесь собраны общие правила, которые помогут быстро разобраться с любой командой из раздела.
Все команды работают только в группах и требуют роли или отдельного разрешения, которое выдаётся в доступе и правах. Права можно раздавать точечно: например, разрешить модератору муты, но не баны.
Что нужно боту
Для мута, варна, бана, кика и закрытия чата бот должен быть администратором группы с правом блокировать участников. Если прав нет, бот скажет об этом.
Команды просмотра - списки, история, проверка статуса, -причина - работают и без прав администратора.
Кого наказать не получится
Бот откажется применить наказание:
- к вам самим;
- к самому Moonrise;
- к администратору телеграма в этой группе;
- к участнику с равной или более высокой ролью, чем у вас.
Последнее правило работает и в обратную сторону: снять чужой бан может только тот, кто выше выдавшего его администратора, или он сам.
Из ботов Moonrise защищает только себя: посторонний бот в чате для команд - такой же участник, как все.
Как указать участника
Три способа, они взаимозаменяемы почти во всех командах:
- ответом на сообщение участника, тогда сам участник в команде не нужен;
- по юзернейму:
-мут @юзер 2ч; - по цифровому ид:
-мут 123456789 2ч.
Если вы отвечаете на сообщение и при этом указали @юзер, бот выберет того,
кто написан в команде. Ид пригодится, когда участник уже вышел из чата или
скрыл юзернейм. Узнать его можно командой -ид.
Форматы срока
Срок пишется числом и буквой, регистр и язык не важны:
| Единица | Как писать | Пример |
|---|---|---|
| Минуты | м, мин, m | 30м |
| Часы | ч, час, h | 2ч |
| Дни | д, дн, d | 7д |
| Недели | н, нед, w | 2н |
| Месяцы | мес, mo | 3мес |
| Годы | г, год, y | 1г |
Части срока складываются: 1ч30м, 1д 12ч, 2н 3д. Вместо срока можно написать
- тогда наказание бессрочное.
Ограничения по длительности разные: мут и варн живут максимум год, бан от 366 дней превращается в вечный, а закрытие чата дольше года бот не примет. С баном тут нет никакой потери: если вы закрываете вход дольше чем на год, возвращения участника вы явно не ждёте, и вечный бан говорит об этом прямо.
Причина
Причину пишите со второй строки, после переноса:
[параметр] — необязательныйБез причины бот запишет «не указана». В настройках можно сделать причину обязательной для бана и для варна, тогда команда без второй строки не сработает и бот напомнит формат.
Причина видна в списках, в истории и в карточке участника, поэтому пишите её так, будто её будут читать через месяц.
Номер записи
Каждый мут, варн и бан получает короткий номер. Он есть в ответе бота и в списках, и по нему можно открыть полную карточку наказания через -причина. Длинные причины в списках обрезаются, и бот сам подсказывает номер, по которому можно прочитать текст целиком.
