Уровни

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

Участники получают опыт за сообщения и время в голосовых каналах, растут в уровнях и получают за них роли. Команда /rank показывает карточку уровня, /top — таблицу лидеров. По желанию таблица публикуется на открытой странице сайта.

Где найти#

Кабинет → Модули → Уровни. Вкладки:

• Настройки — опыт, исключения, роли за уровни, поздравления, множители, таблица лидеров и ручное управление.
• Оформление — карточка /rank и страница таблицы лидеров.

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

1. Включите модуль переключателем «Модуль» в шапке страницы — он сохраняется сразу. Значения по умолчанию подходят большинству серверов.
2. В «Исключения» добавьте каналы, где опыт не нужен (например, #флуд или бот-каналы).
3. В «Роли за уровни» добавьте пару наград, например «Уровень 5 → Активный». Поднимите роль LOLBOT выше этих ролей.
4. При желании включите поздравления.
5. Сохраните и напишите несколько сообщений с паузой больше минуты, затем вызовите /rank.

Настройки#

Опыт за сообщения#

Сообщения в паузе опыт не дают. Боты и сам LOLBOT опыт не получают.

Опыт в голосовых каналах#

• Начислять опыт за время в голосе — раз в минуту, только когда в канале достаточно людей.
• Опыт за минуту — по умолчанию 10 (1–50).
• Людей в канале, не меньше — по умолчанию 2 (2–10). Боты не считаются.

Кривая уровней#

Уровень 1 — 100 опыта, каждый следующий требует чуть больше: переход с уровня L на L+1 стоит 5L² + 50L + 100 опыта. Второй уровень — ещё 155 опыта, третий — ещё 220.

Исключения#

• Каналы без опыта — текстовые и голосовые.
• Роли без опыта.

Роли за уровни#

Пары «уровень → роль». В «Что делать с прежними наградами»:

• Сохранять все полученные роли — участник накапливает все награды.
• Оставлять только высшую роль — прежние роли-награды снимаются.

Роль бота должна быть выше; роли с правами модерации выдавать нельзя. Пометка «бот не может выдать» означает проблему с иерархией или правами.

Поздравления#

Где поздравлять: «Не поздравлять» (по умолчанию), «В канале, где участник написал» или «В выбранном канале». Упоминание в поздравлении не присылает уведомление участнику. За опыт в голосе поздравление «в том же канале» не отправляется.

Свой Текст поздравления (Premium, до 500 символов) поддерживает переменные {user}, {level} и {server}.

Множители опыта#

Premium. Для роли или канала задаётся множитель от 0,1 до 5. Из ролей участника действует самый большой множитель, множитель канала умножается на него. Множитель меньше 1 уменьшает опыт — например, для канала мемов.

Таблица лидеров#

• Команда /rank → Публичный ответ — карточку увидят все в канале. Иначе её видит только автор.
• Открытая страница — таблицу увидит любой, у кого есть ссылка. Показываются имена и уровни, без ID.

Ручное управление#

Premium. Выдача опыта по ID участника — роли-награды пересчитаются под новый уровень, поздравления не будет. «Сбросить опыт всем» очищает таблицу лидеров; для подтверждения нужно ввести название сервера. Роли-награды при сбросе не снимаются. Отменить это действие нельзя.

Опыт за старые сообщения#

Premium. Бот один раз прочитает историю текстовых каналов и начислит опыт за сообщения, отправленные до включения уровней, — по текущим правилам: пауза между начислениями, минимальная длина, каналы и роли без опыта, множители.

1. Во вкладке «Настройки», в блоке «Опыт за старые сообщения», выберите дату «Считать сообщения до». По умолчанию это день, когда уровни впервые сохранили: более новые сообщения уже дали опыт, и второй раз они не посчитаются.
2. Выберите период: от последнего месяца до всей истории.
3. Решите, нужны ли монеты и достижения за полученные уровни. Если выключено, участники получат только опыт и роли за уровни, а монеты за эти уровни уже не начислятся и позже.
4. Нажмите «Посчитать опыт».

Бот читает историю в фоне и не мешает остальным действиям; на большом сервере это занимает от нескольких минут до пары часов. Прогресс виден в том же блоке, пока идёт чтение, подсчёт можно остановить. Затем опыт добавляется к уже набранному, уровни пересчитываются, а роли-награды выдаются постепенно. Поздравлений не будет, недели и месяцы в топе не меняются. Итог виден, пока страница открыта; после её обновления блок исчезает.

Ограничения: время в голосе не восстанавливается; опыт получают только те, кто сейчас на сервере; удалённые сообщения и каналы, которые бот не видит, не учитываются; читается не больше 3 млн сообщений. Запустить подсчёт можно один раз — после начисления повторить его нельзя.

Монеты за уровни#

Если включена Экономика, за каждый новый уровень можно начислять монеты — сумма задаётся в настройках экономики, в разделе «Связь с другими модулями». Уровень можно сделать условием для покупки в магазине и для переводов.

Роли чемпионов#

Premium вместе с топом недели и месяца: «Чемпион недели» и «Чемпион месяца». Раз в час бот закрывает прошедшую неделю и месяц по московскому времени, снимает роль с прошлого победителя и выдаёт новому.

Оформление#

Карточка /rank#

Предпросмотр строится тем же способом, что и картинка в Lolka. Бесплатно — стандартная карточка с меткой LOLBOT. С Premium — тема карточки, акцентный цвет, свой фон с положением и затемнением, выбор показываемых данных (название и иконка сервера, место в рейтинге, сообщения и минуты в голосе).

Страница таблицы лидеров#

Таблица лидеров открывается на странице сервера — вкладкой «Уровни» рядом с главной и достижениями. Сначала включите «Открытая страница» на вкладке «Настройки». Адрес: /s/ваш-сервер/top; старые ссылки /top/… продолжают работать.

Тема, обложка, фон, шрифт, описание, ссылки, кнопка «Вступить», короткий адрес и показ в поиске теперь общие для всех страниц сервера и настраиваются в разделе «Страница сервера». Во вкладке «Оформление» уровней остался конструктор самой таблицы:

• Бесплатно: таблица лидеров и витрина наград (её можно скрыть).
• Premium: вид таблицы (подиум и список, компактная таблица, сетка карточек), цвета медалей, график активности за 30 дней и блоки («О сервере», «Правила», «Команда», «Вопросы и ответы», «Галерея»).
• Premium, топ периодов: вкладки «Неделя» и «Месяц», «Зал славы» и роли чемпионов. Опыт за периоды считается на любом тарифе, поэтому после подключения Premium таблицы сразу заполнены.

Команды#

Команды доступны всем участникам. Ответ /top видит только автор; ответ /rank — тоже, если не включён «Публичный ответ».

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

• Управление ролями и роль бота выше ролей-наград и ролей чемпионов.
• Просмотр канала и отправка сообщений в канале поздравлений.

Free и Premium#

Опыт, роли за уровни (до 5), поздравления со стандартным текстом, /rank, /top и открытая страница с таблицей — бесплатно.

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

• Lolka не сообщает боту, выключен ли у участника микрофон, поэтому опыт в голосе получают все в канале. Защита от накрутки — минимальное число людей.
• Содержимое сообщений не сохраняется: учитывается только длина.
• Само повышение уровня в журнал не пишется — только изменения ролей, ручная правка, сброс и подсчёт по истории.

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

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

Роль-награда не выдаётся. Роль LOLBOT ниже награды, у бота нет управления ролями, или у роли есть права модерации. На Free действуют только первые 5 наград.

Открытая страница отвечает «не найдено». Включите «Открытая страница» во вкладке «Настройки» и проверьте, что модуль включён.

После смены ника видно старое имя. Карточки и сайт используют ник участника на этом сервере; если его нет — имя профиля. Новый ник обновляется по событию Lolka и проверяется при открытии страницы или вызове /rank. При временной недоступности Lolka остаётся последнее известное имя. Уже отправленная картинка не меняется: вызовите команду снова.