Портали ролей
Посібник користувача
Опублікуйте повідомлення з кнопкою: учасник, який її натисне, отримає одну або кілька ролей за умови, що він уже має ролі, які ви вимагаєте. Ідеально, щоб відкрити доступ до закритої секції після першого етапу.
Що це робить
- Публікує персоналізований embed із кнопкою в каналі на ваш вибір.
- Перевіряє необхідні ролі, перш ніж щось видати.
- Видає ролі до видачі одним кліком, без участі персоналу.
- Відповідає приватно в каналі (тимчасове повідомлення): ні успіх, ні відмова не забивають розмову.
- Кнопка залишається активною з часом: вона працює навіть після перезапуску бота.
Цей модуль — це не AutoRole, не Role Gate і не RoleRoster
Чотири модулі працюють з ролями, і в кожного своя роль:
| Модуль | Принцип |
|---|---|
| Портали ролей | Умовна кнопка: якщо у вас є ролі A та B, то ви отримуєте роль C. |
| AutoRole | Панелі з випадними меню, де кожен обирає вільно і може забрати те, що взяв. Без жодних умов. |
| Role Gate | Ролі, що видаються автоматично при приєднанні, обмін ролями та вилучення ролей у відсутніх учасників. Без кліків. |
| RoleRoster | Довідник: показує список учасників певної ролі. Нічого не видає. |
Підсумок: портал — єдиний з чотирьох, який ставить умову перед видачею ролі.
Швидкий старт (Адмін)
- Відкрийте дашборд → категорія Інструменти та Персонал → Захищені портали.
- Натисніть Новий портал.
- Задайте внутрішню назву (вона не показується в Discord) та виберіть канал розгортання.
- Заповніть ролі до видачі — це обов'язково — і, за потреби, необхідні ролі.
- Налаштуйте вигляд embed та кнопки, потім натисніть Зберегти.
- У списку натисніть іконку надсилання, щоб опублікувати панель у каналі.
Команди
Цей модуль не має жодної команди Discord: усе налаштовується з дашборду, а учасники користуються лише кнопкою панелі.
Налаштування з дашборду
Список порталів показує для кожного його назву, канал, необхідні ролі та ролі, що видаються, з трьома діями: опублікувати панель, редагувати, видалити.
Вікно конфігурації складається з чотирьох блоків:
- Основна інформація: внутрішня назва (обов'язково) та канал розгортання (обов'язково).
- Умови та Винагороди:
- Необхідні ролі — необов'язково. Якщо ви залишите це поле порожнім, натиснути зможе будь-хто.
- Ролі до видачі — обов'язково, одна або кілька ролей.
- Вигляд (Embed): заголовок, опис і колір.
- Кнопка: текст, що відображається, та емодзі (з селектором емодзі).
Кількість порталів обмежена до 1 для непреміум-сервера (значення за замовчуванням, яке команда TennoCore може змінити).
Корисно знати
- Боту потрібен дозвіл Керувати ролями, і його роль мусить бути вище за ролі, які він має видавати. Інакше учасник отримає повідомлення про помилку зі згадкою про ієрархію.
- Необхідні ролі перевіряються за принципом І: учасник мусить мати всі перелічені ролі. Якщо якоїсь бракує, бот точно вказує, якої саме.
- Учасник, який уже має всі ролі порталу, отримує просте інформаційне повідомлення без жодних наслідків.
- Портал ніколи не забирає роль. Для перемикача (взяти / повернути) використовуйте AutoRole.
- Редагування порталу не змінює вже опубліковане повідомлення: текст, колір і надпис кнопки залишаються початковими. Опублікуйте панель заново, щоб отримати оновлене повідомлення, потім видаліть старе.
- Не залишайте кілька копій того самого порталу на сервері: після перезапуску бота знову активується лише останнє опубліковане повідомлення, а старі кнопки стають неробочими.
- Видалення порталу в дашборді не видаляє повідомлення, опубліковане в Discord: кнопка залишиться видимою, але не працюватиме. Видаліть повідомлення вручну.
- Канал мусить бути таким, де бот може писати; якщо канал було видалено, публікація не вдасться.
- Портали також працюють із персоналізованим ботом: кнопку обробляє ваш бот, коли TennoCore відсутній на сервері.