Кастомные роли
Личная роль с собственным именем, цветом и иконкой — за буст сервера или в аренду за валюту
Кастомная роль — это личная косметика уровня «своя роль на сервере, которую ты сам придумал»: своё название, свой цвет (или градиент, или голограмма), своя иконка. У каждого участника — не больше одной такой роли на сервер.
TL;DR для нетерпеливых. /кастом-роль открывает панель с текущим статусом и меню действий. Получить роль можно за буст сервера (бесплатно, пока бустишь) или в аренду за валюту (платно, на фиксированный срок) — зависит от того, что разрешил админ. Сложные стили (градиент, голограмма, PNG-иконка) настраиваются в личном кабинете на сайте, а не в Discord.
✨ Как получить роль
Команда /кастом-роль открывает единую панель — embed с текущим статусом роли и select-меню, набор пунктов в котором зависит от ситуации: «Показать мою роль», «Создать роль», «Арендовать/продлить», «Удалить» — появляются и исчезают в зависимости от того, есть ли у тебя уже роль, есть ли доступ и включена ли аренда.
Простые правки — в Discord, сложные — на сайте. Имя и обычный цвет можно поменять прямо через меню панели. А вот градиент, голографический стиль, PNG-иконка или иконка серверным эмодзи — только через личный кабинет (ссылка есть прямо в описании панели), там для этого удобный визуальный редактор.
🔑 Как получить доступ
Админ выбирает один из трёх режимов:
| Режим | Как получить |
|---|---|
| 🌟 Только буст | Роль бесплатна, пока ты бустишь сервер |
| 🛒 Только аренда | Роль покупается за валюту сервера на фиксированный срок |
| 🌟🛒 Оба варианта | Бустеры — бесплатно, остальные — за валюту |
🎨 Стили и иконки
Три стиля оформления: обычный цвет, градиент (два цвета) и голографический (фирменный переливающийся Discord-стиль, цвета фиксированы). Плюс иконка — Unicode-эмодзи или своя картинка.
Это не прихоть Маяри — так устроен сам Discord. Градиент и голография требуют, чтобы у сервера был активен перк Enhanced Role Styles (нужно 3 буста сервера), а любые иконки ролей (даже обычный эмодзи) требуют Boost Level 2 (7 бустов). Если у сервера нет нужного уровня буста — Маяри прямо скажет об этом и не даст применить стиль, даже если админ разрешил его в настройках. Админ может донастроить, какие стили в принципе предлагать (например, выключить градиент отдельно от голограммы) — но выше уровня буста сервера не прыгнуть.
📍 Где роль встаёт в списке
Админ выбирает, как позиционировать кастомные роли относительно остальных:
- От опорной роли — кастомная роль всегда встаёт сразу под выбранной «опорной» ролью (например, под ролью «Бустер»), одинаково для всех.
- Выше самой высокой роли участника — кастомная роль всегда на 1 позицию выше любой другой роли конкретного человека (но не выше самой Маяри) — из-за этого у разных людей роль может оказаться на разной высоте списка.
Чтобы это вообще работало, у Маяри должно быть право «Управлять ролями», а её собственная роль — стоять выше опорной (или просто быть не в самом низу списка, для режима «выше самой высокой»).
💔 Что будет, если перестать бустить
Роль, полученную за буст, при потере буста не удаляют сразу — даётся grace-период (по умолчанию 7 дней, настраивается 0–30). Если за это время буст не вернуть — Discord-роль удаляется, но дизайн (имя, цвет, иконка) сохраняется в архиве. Вернулся к бусту или оформил аренду — роль пересоздаётся с тем же видом одним действием, ничего настраивать заново не нужно.
Арендованная роль не зависит от буста вообще. Если роль получена за валюту — она живёт до конца оплаченного срока независимо от того, бустишь ли ты сервер. Потеря буста тут ни на что не влияет.
🛒 Аренда
Стоимость и срок аренды задаёт админ (buyPrice монет за rentDays дней). Если аренда уже активна — новое действие продлевает срок (прибавляет дни к текущему дедлайну, а не начинает заново). Если у тебя уже есть архивный дизайн — аренда восстанавливает именно его, а не создаёт роль с нуля.
🧹 Автоматическая чистка
Раз в сутки (в 04:30 UTC) фоновая задача проходит по всем просроченным ролям: если grace-период или аренда истекли, а человек всё ещё бустит и режим это разрешает — роль превращается в бесплатную буст-роль; если нет — архивируется. Отдельно подчищаются случаи, когда участник перестал бустить, а Маяри почему-то не успела поставить grace-дедлайн (например, из-за рестарта в нужный момент).
🛠️ Что настраивается в панели
Раздел «Кастомные роли» в веб-панели:
- режим доступа (буст / аренда / оба) и опорная роль или режим позиционирования;
- длительность grace-периода после потери буста;
- ограничение на длину имени и кулдаун между переименованиями (по умолчанию раз в 60 минут);
- какие стили и типы иконок вообще предлагать (в рамках того, что позволяет буст-уровень сервера);
- цена и срок аренды.
Куда дальше
- Экономика — валюта, за которую оформляется аренда роли.
- Тэги конструктора сообщений — переменные для кастомных сообщений в других модулях.