Порталы ролей
Руководство пользователя
Опубликуйте сообщение с кнопкой: участник, нажавший на неё, получает одну или несколько ролей — при условии, что у него уже есть роли, которые вы требуете. Идеально для открытия доступа к закрытому разделу после прохождения первого этапа.
Что это делает
- Публикует настраиваемый embed с кнопкой в выбранном вами канале.
- Проверяет необходимые роли до того, как что-либо выдать.
- Выдаёт назначаемые роли одним нажатием, без участия персонала.
- Отвечает приватно в канале (эфемерное сообщение): ни успех, ни отказ не засоряют переписку.
- Кнопка остаётся активной со временем: она работает и после перезапуска бота.
Этот модуль — не AutoRole, не Role Gate и не RoleRoster
С ролями работают четыре модуля, и у каждого своя задача:
| Модуль | Принцип |
|---|---|
| Порталы ролей | Условная кнопка: если у вас есть роли A и B, то вы получаете роль C. |
| AutoRole | Панели с раскрывающимися меню, где каждый берёт себе роли свободно и может их снять. Никаких условий. |
| Role Gate | Роли, выдаваемые автоматически при входе, замена ролей и снятие ролей с неактивных участников. Без нажатий. |
| RoleRoster | Справочник: показывает список участников с определённой ролью. Ничего не выдаёт. |
Итог: портал — единственный из четырёх, кто ставит условие перед выдачей роли.
Быстрый старт (админ)
- Откройте панель управления → категория Инструменты и персонал → Защищённые порталы.
- Нажмите Новый портал.
- Задайте внутреннее название (в Discord оно не отображается) и выберите канал публикации.
- Укажите назначаемые роли — это обязательно — и, при необходимости, необходимые роли.
- Настройте embed и кнопку, затем Сохраните.
- В списке нажмите значок отправки, чтобы опубликовать панель в канале.
Команды
У этого модуля нет ни одной команды Discord: всё настраивается в панели управления, а участники пользуются только кнопкой на панели.
Настройки в панели управления
Список порталов показывает для каждого из них название, канал, необходимые и назначаемые роли, а также три действия: опубликовать панель, изменить, удалить.
Окно настройки состоит из четырёх блоков:
- Основные сведения: внутреннее название (обязательно) и канал публикации (обязательно).
- Условия и награды:
- Необходимые роли — необязательно. Если оставить это поле пустым, нажать сможет любой.
- Назначаемые роли — обязательно, одна или несколько ролей.
- Внешний вид (Embed): заголовок, описание и цвет.
- Кнопка: отображаемый текст и эмодзи (с выбором эмодзи).
Количество порталов ограничено: 1 для сервера без премиума (значение по умолчанию, может быть изменено командой TennoCore).
Полезно знать
- Боту нужно право Управлять ролями, а его роль должна находиться выше тех ролей, которые он выдаёт. Иначе участник получит сообщение об ошибке с упоминанием иерархии.
- Необходимые роли проверяются по логике И: у участника должны быть все перечисленные роли. Если каких-то не хватает, бот точно укажет, каких именно.
- Участник, у которого уже есть все роли портала, получит просто информационное сообщение, без каких-либо действий.
- Портал никогда не снимает роли. Если нужно переключение (взять / вернуть), используйте AutoRole.
- Изменение портала не меняет уже опубликованное сообщение: текст, цвет и надпись на кнопке останутся прежними. Опубликуйте панель заново, чтобы получить актуальное сообщение, а затем удалите старое.
- Не оставляйте на сервере несколько экземпляров одного портала: после перезапуска бота активируется только последнее опубликованное сообщение, а прежние кнопки становятся нерабочими.
- Удаление портала в панели управления не удаляет сообщение, размещённое в Discord: кнопка останется видимой, но перестанет работать. Удалите сообщение вручную.
- Канал должен быть таким, где бот может писать; если канал был удалён, публикация завершится ошибкой.
- Порталы работают и с персональным ботом: кнопку обслуживает ваш бот, когда TennoCore на сервере отсутствует.