Автоматические роли
Модуль выдаёт роли новым участникам при входе на сервер — сразу или с задержкой, навсегда или на срок. Больше не нужно вручную выдавать каждому новичку базовую роль.
- В панели
- Автоматизация → Автоматические роли
- Команды
/autoroles status- Права бота
- Управлять ролями
Как это работает
- Участник заходит на сервер.
- Бот выдаёт ему роли из списка — сразу или после задержки: общей или своей у каждой роли.
- Роль со сроком бот снимет сам, когда срок выйдет: например, «Новичок» — через 7 дней.
Роль бота должна быть выше
Бот выдаёт только роли ниже своей. Роли, которые он не сможет выдать, панель помечает, а /autoroles status отмечает значком ⚠️. Про иерархию ролей.
Роли для участников и ботов
- Роли пользователей — выдаются людям при входе. Можно выбрать несколько.
- Роли ботов — отдельный набор для ботов, которых добавляют на сервер. Удобно, чтобы сразу выдавать ботам нужные права. По умолчанию ботам роли не выдаются.
Задержка и срок
Общая задержка — в секундах, для всех ролей, у которых нет своей. 0 — сразу после входа. Задержка полезна, если другие модули должны сработать первыми — например, верификация.
В блоке «Задержка и срок ролей» у каждой роли может быть своя задержка и свой срок:
- своя задержка заменяет общую: при общей задержке 5 минут роль с задержкой 0 выдаётся сразу;
- срок — сколько роль держится после выдачи, потом бот её снимает. Пустой срок — навсегда;
- задержка — в секундах, минутах, часах или днях, до 30 дней; срок — в минутах, часах или днях, до 365 дней;
- под каждой ролью написано, что с ней будет: например, «Сразу после входа, снимается через 7 дн после выдачи».
Роль должна быть и в списке «Роли пользователей» или «Роли ботов» — иначе она не выдаётся, и блок об этом предупредит.
Временные роли
- Срок отсчитывается от выдачи, а не от входа: роль с задержкой 10 минут и сроком 7 дней снимется через 7 дней после выдачи.
- Выдали роль заново — например, участник вышел и вернулся, — срок начинается заново.
- Роль снимается, даже если модуль к тому времени выключили.
- Если участник ушёл, его отложенные выдачи отменяются.
Повторный вход
| Вариант | Что происходит |
|---|---|
| Всегда | Роли выдаются при каждом входе |
| Только первый раз | Не выдавать, если участник уже получал эти роли |
| Если роли нет — по умолчанию | Выдать только те роли, которых у участника нет |
Восстановление ролей. При повторном входе бот может вернуть роли, которые были у участника раньше. Роли ушедших хранятся 30 дней (настраивается), отдельные роли можно исключить. Временные роли не восстанавливаются — вернувшийся получит их заново по правилу повторного входа.
Повтор при ошибке. Если роль выдать не удалось, бот повторит попытку — по умолчанию до 3 раз.
Ожидают и история выдачи
На странице модуля, под блоком «Задержка и срок ролей»:
- Ожидают — у кого есть временная роль и когда её снимут, кому и когда выдадут отложенную роль.
- История выдачи — выдачи, отказы с причиной, снятия по сроку, отложенные выдачи, отмены и пропуски. Можно оставить один вид событий или одного участника — для этого нажмите на его имя.
Историю видят роли с правом «Просмотр журнала» или «Управление» этого раздела на странице Права; владелец сервера и участники с правом «Управление сервером» видят всё.
Команда /autoroles status
/autoroles status (/автороли статус) — сводка прямо в Discord. Её видите только вы:
- какие роли получат участники и боты — сразу или после задержки, на какой срок;
- какие роли бот не выдаст: роль удалена, выше роли бота или управляется интеграцией;
- нет ли у бота проблем с правом «Управлять ролями»;
- сколько временных ролей и отложенных выдач ждут и когда ближайшие;
- что было за сутки: выдано, не выдано, снято по сроку.
Команду видят участники с правом «Управлять ролями»; ответит она и роли с доступом к разделу «Автоматические роли» в панели. Работает, когда модуль включён. Роли и сроки меняются только в панели.
Логи
В канал логов бот пишет о выданных ролях и отказах; пропуски в лог не попадают. У временной роли в сообщении о выдаче указано, когда она снимется, а когда срок выйдет — что роль снята или что снять её не удалось. С настройкой «Уведомлять админов» сообщение об отказе упоминает администраторов.
Настройки
| Настройка | По умолчанию | Что делает |
|---|---|---|
| Выдавать пользователям / Роли пользователей | включено / — | Роли для людей |
| Выдавать ботам / Роли ботов | выключено / — | Роли для ботов |
| Задержка перед выдачей | 0 сек | Для ролей без своей задержки; до 30 дней |
| Задержка и срок отдельных ролей | — | Своя задержка и срок у роли |
| При повторном входе | Если роли нет | Или «Всегда», «Только первый раз» |
| Повтор при ошибке / Макс. попыток | включено / 3 | Повторные попытки выдачи |
| Восстанавливать роли при повторном входе | выключено | Вернуть роли ушедшего |
| Роли-исключения для восстановления | — | Какие роли не возвращать |
| Сколько дней хранить роли ушедших | 30 | От 1 до 365 |
| Канал логов | — | Выдачи, отказы, снятия |
| Уведомлять админов | выключено | Упоминать администраторов в сообщениях об отказе |