Временные роли — документация LOLBOT

Что делает модуль#

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

Выдать временную роль можно тремя способами:

командой /temprole give;
в кабинете, кнопкой «Выдать роль»;
кнопкой панели ролей, если у кнопки задан срок.

Срок можно продлить или снять роль раньше времени. Участник проверяет свои сроки командой /temproles, модераторы видят все сроки в кабинете.

Где найти#

Кабинет → Модули → Временные роли. Вкладки «Действующие», «История» и «Настройки».

Быстрый старт#

В Lolka перетащите роль LOLBOT выше ролей, которые бот будет выдавать на время.
Включите модуль переключателем «Модуль» в шапке страницы — он сохраняется сразу.
Выдайте роль: /temprole give user:@участник role:@Гость preset:Гость (или duration:1д) либо кнопкой «Выдать роль» на вкладке «Действующие».
Проверьте срок командой /temproles user:@участник или в списке «Действующие».

Настройки#

Модуль#

Переключатель «Модуль» в шапке страницы, сохраняется сразу. По умолчанию выключен. Пока модуль выключен, новые временные роли не выдаются, а уже выданные всё равно снимаются в срок.

Временные роли можно продавать в магазине экономики (Premium). Купленные роли видны в списке действующих с источником «Покупка в магазине» и снимаются в срок, даже если этот модуль выключен.

Так же работает роль победителям в розыгрышах: такие роли видны с источником «Победа в розыгрыше».

Если участник вышел и вернулся#

Вариант	Что происходит
Вернуть роль до конца срока	По умолчанию. Если участник вернётся до окончания срока, бот выдаст роль снова. Срок продолжает идти, пока участника нет, поэтому перезаход не сбрасывает и не продлевает его
Завершить временную роль	Выход с сервера завершает временную роль; после возвращения её нет

Выдача в кабинете#

В окне «Выдать роль» начните вводить ник или юзернейм участника и выберите его из списка. Можно также вставить ID пользователя Lolka. Список ищет по началу ника, до 10 совпадений.

Пресеты сроков#

Пресет — название, срок и необязательная причина, например «Гость — 1 день» или «Победитель турнира — 7 дней». На новом сервере уже есть три примера; их можно переименовать, изменить или удалить. Всего до 25 пресетов.

Где используются пресеты:

в окне «Выдать роль» и «Продлить роль» — поле «Пресет» подставляет срок и причину, их можно поправить;
в командах — параметр preset у /temprole give и /temprole extend; список названий — /temprole presets;
у кнопок панели ролей — в поле «Срок роли».

Если изменить срок пресета, кнопки с этим пресетом сразу начнут выдавать роль на новый срок. Уже выданные роли не меняются. Если пресет удалить, кнопка продолжит выдавать роль на последний известный срок.

Действующие роли#

Список показывает участника, роль, дату окончания по Москве, сколько осталось, способ выдачи и кто выдал. Кнопка с календарём продлевает роль: новый срок прибавляется к текущему окончанию. Кнопка с корзиной снимает роль досрочно.

Статус «Требует внимания» значит, что бот не смог выдать или снять роль: причина видна в строке. Обычно дело в правах или положении роли бота. Снятие повторяется автоматически каждую минуту.

История#

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

Срок у кнопки панели ролей#

В конструкторе эмбедов у каждой кнопки панели ролей есть поле «Срок роли»: «Без срока», пресет сервера, готовый срок от часа до 30 дней или «Своё значение…» — любой срок от минуты до 365 дней, например 2д12ч. Участник, нажавший такую кнопку, получает временную роль. Повторное нажатие снимает её досрочно, если панель в режиме «Переключение».

Команды#

Команда	Что делает
`/temprole give`	Выдать роль на срок или по пресету; можно указать причину
`/temprole extend`	Продлить роль: срок прибавляется к текущему окончанию
`/temprole remove`	Снять временную роль досрочно
`/temprole list`	Действующие временные роли сервера
`/temprole presets`	Пресеты сроков и их названия
`/temproles`	Свои временные роли и сроки; с параметром `user` — чужие, только для модераторов

Срок пишется как 30м, 12ч, 1д, 1н или 1д12ч, от минуты до 365 дней. Полный список параметров — в справочнике команд.

Командой /temprole могут пользоваться участники со штатным правом «Управление ролями». В режиме матрицы доступа нужны назначения «Выдавать и продлевать роли» или «Снимать роли досрочно» в разделе «Временные роли» (Команда). Модератор может выдать только роль ниже своей высшей роли; владельца сервера и администраторов это не касается.

Какие права нужны боту#

Управление ролями.
Роль LOLBOT выше каждой временной роли.

Как и в авторолях, можно выдавать только обычные роли без прав модерации и управления.

Free и Premium#

Premium. Временные роли доступны с Premium по умолчанию. После окончания Premium новые роли не выдаются и не продлеваются, а уже выданные снимаются в срок. Снять роль досрочно можно и без Premium.

Ограничения#

Ограничение Лолки. Lolka не показывает срок роли в профиле участника. Срок можно узнать командой /temproles, в кабинете и в журнале.

Роль снимается в течение минуты после окончания срока.
Если роль уже есть у участника без срока, временно выдать её нельзя: иначе бот снял бы постоянную роль. Сначала снимите её.
Одну и ту же роль одному участнику можно выдать только одной временной записью. Чтобы изменить срок, продлите её.
Ботам временные роли не выдаются.

Частые проблемы#

Роль не выдаётся. Проверьте, что модуль включён, роль LOLBOT выше выдаваемой роли и у бота есть «Управление ролями». Если у роли есть права модерации, бот её не выдаст.

Роль сняли вручную, а срок остался в списке. Бот замечает ручное снятие роли и завершает временную роль со статусом «Снята вручную». Если бот был недоступен в момент снятия, запись завершится, когда наступит срок.

Команда /temprole не видна. Её видят только участники со штатным правом «Управление ролями» — см. кто видит команды. Выдать роль можно и в кабинете.

Участник вернулся, а роли нет. Проверьте настройку «Если участник вышел и вернулся» и не закончился ли срок. Возврат выполняется, только если на сервере действует Premium и модуль включён.