Роли

У каждой роли есть свой набор прав и уровень. Права решают, что участник умеет делать, а уровень определяет, кто в чате старше и кого можно повышать, понижать и наказывать. Всё это настраивается одной командой -роль, ей же можно посмотреть, кто есть кто, выдать роль или создать свою.

1-роль

1-роль<@юзер>

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

1-роль список

В профиле видно каждую роль участника, её уровень, кто её выдал и когда. Под сообщением есть кнопки: выдать роль, снять роль, открыть все роли чата и перейти к правам. Кнопки слушаются только того, кто вызвал команду.

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

1-роль выдать<@юзер><роль>

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

1-роль снять<@юзер><роль>

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

Роль указывается кодом: moderator, admin, vip. Выдать можно только роль ниже своего уровня и только тому, кто ниже вас. Свою роль этой командой не изменить.

Роли складываются: если выдать модератору ещё одну роль, старая останется, а доступ будет по самой высокой. Роль Участник этой командой не выдать и не снять, её каждый получает автоматически, как только заходит в чат. А вот её права настраиваются как у любой другой роли, через -роль право выдать member <право> и -роль право снять member <право>.

Роли уровня 80 и выше открывают почти весь чат, поэтому бот не выдаёт их молча: сначала придёт предупреждение и выдачу нужно будет подтвердить кнопкой. Подтверждать придётся каждый раз, даже если роль создали вы сами, и отключить это нельзя.

Назначение и снятие ролейСкопировать ссылку

1-повысить<@юзер>[роль]

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

Без указания роли участник поднимается на одну ступень вверх по уровням. С ролью - сразу до неё, если она выше текущей и ниже вашей.

1-понизить<@юзер>

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

1-разжаловать<@юзер>

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

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

1-роль создать

2<название>

3<код>

4<уровень>

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

Каждое значение с новой строки. Название участники увидят в профиле, код нужен для команд, уровень задаёт место в иерархии. Код пишется латиницей от 2 до 63 символов, начинается с буквы, внутри допустимы цифры и _.

Уровень должен быть больше нуля, ниже вашего и не занят другой ролью: два разных уровня с одним номером бот не примет. Максимум - 999, тысяча зарезервирована под владельца.

1-роль изменить<код><название><новое название>

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

1-роль изменить<код><уровень><число>

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

Слова название и уровень тут ключевые, бот по ним понимает, что вы правите. Можно менять что-то одно, а можно оба сразу: -роль изменить vip название Очень важный уровень 30. Название пишется как есть, из нескольких слов, кавычки не нужны. Вместо название понимается и заголовок, а короткий путь для переименования - -роль переименовать vip Очень важный.

Новый уровень подчиняется тем же правилам, что и при создании: больше нуля, не выше 999, ниже вашего и не занят другой ролью. Код роли не меняется никогда, он остаётся таким, каким вы его придумали при создании.

Переименовать и переставить по уровню можно даже системные роли, так что Модератор в вашем чате может называться как угодно. Исключение одно: роль Владелец правит только создатель чата.

1-роль удалить<код>

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

Бот покажет, сколько у роли участников и прав, и попросит подтверждение кнопкой. После удаления роль снимается со всех, кто её носил. Шесть системных ролей удалить нельзя.

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

1-роль право выдать<роль><право>

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

1-роль право снять<роль><право>

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

1-роль право список<роль>

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

Изменения действуют сразу на всех участников с этой ролью. Нельзя редактировать права роли, уровень которой равен вашему или выше, и нельзя выдать право, которого нет у вас самих.

Коды прав перечислены в справочнике, а личные права одного участника настраиваются через -права. Если код роли или права написан с опечаткой, бот подскажет похожие варианты.

Прежде чем добавлять роли доступ к настройкам, банам или управлению правами, посмотрите памятку по безопасности: такие права меняют чат целиком.