Wiki / Core Features / Стат-роли

Стат-роли

Обновлено Maxime_48 · 3 часа назад · Просмотры: 118

Языки: English Français Deutsch Español Português (Brasil) Italiano Nederlands Polski Türkçe Русский 日本語 한국어 中文

Стат-роли автоматически награждают участников ролями на основе их активности за всё время на вашем сервере: сколько сообщений они отправили, сколько времени провели в голосе, сколько игр выиграли или как давно они состоят на сервере. В отличие от наград Leveling, стат-роли основаны на сырых накопленных суммах, а не на формуле XP.

Откройте Панель → ваш сервер → Стат-роли, чтобы их настроить.

Страница Stat Roles с тремя правилами (сообщения, голосовые минуты и стаж на сервере), каждое из которых выдаёт роль после порога


🎯 Как это работает

Каждая стат-роль сопоставляет роль с порогом активности:

Метрика Роль выдаётся, когда…
Отправлено сообщений участник отправил всего не менее N сообщений
Время в голосе участник провёл в голосе всего не менее N минут
Побед в играх участник выиграл не менее N игр в центре Games
Стаж на сервере участник вошёл на сервер не менее N дней назад

Когда участник пересекает порог, бот автоматически выдаёт ему роль. При желании роль можно снимать снова, если участник когда-либо опустится ниже порога.

Каждая из этих сумм только растёт, поэтому снятие важно в основном тогда, когда вы также используете затухание или сброс XP.


➕ Создание стат-роли

  1. Выберите роль для выдачи (убедитесь, что роль бота YAWBDB находится выше неё в списке ролей, иначе он не сможет её назначить).
  2. Выберите метрику: сообщения, время в голосе, победы в играх или стаж на сервере.
  3. Задайте порог (например, 1000 сообщений, 600 минут в голосе, 50 побед, 30 дней).
  4. При желании отметьте «Удалять роль, если участник опускается ниже порога».

Вы можете создать несколько стат-ролей, в том числе больше одной для одной и той же роли (например, разные уровни): каждая пара «роль + метрика» уникальна.


⏱ Когда роли применяются

Каждая метрика проверяется там, где она действительно меняется:

  • Стат-роли по сообщениям и голосу проверяются по мере активности участников: роль выдаётся при следующем сообщении участника или получении им голосового XP после пересечения порога.
  • Стат-роли по победам в играх проверяются в момент победы, так что роль приходит вместе с победой, которая её заслужила, а не при следующем сообщении.
  • Стат-роли по стажу на сервере выравниваются периодическим обходом (несколько раз в день), поскольку эта метрика не зависит от активности участников.

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

⚠️ Стат-ролям по сообщениям и голосу нужна включённая функция Leveling: именно так бот отслеживает активность в сообщениях и голосе. Стат-ролям по победам в играх нужна функция Games, поскольку именно она записывает победы. Метрика «Стаж на сервере» работает сама по себе, с любой из них или без.

Счётчик сообщений учитывает сообщения, приносящие XP (не более одного за окно перезарядки Leveling), а не каждое сообщение. Поэтому порог «1000 сообщений» отражает устойчивую активность, а не простой подсчёт сообщений, и быстрый спам его не накрутит.


🎮 Что считается выигранной игрой

Стат-роль по победам в играх учитывает каждую победу участника в центре Games на вашем сервере:

  • Победы в мини-играх - Hangman, Trivia, камень-ножницы-бумага (включая дуэли) и Bingo.
  • Решённые Wordle - каждый день, когда участник разгадал слово.

/8ball и /love никогда не считаются: у них нет победителя, так что это партии, а не победы.

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

Это естественно сочетается с XP за победу в настройках Games: XP награждает каждую отдельную победу, а стат-роль отмечает рубеж. Роль «Game Champion» за 50 побед даёт постоянным игрокам цель, которую не вручит один удачный раунд.


🆚 Стат-роли и награды Leveling

Обе могут назначать роли, но отвечают на разные вопросы:

  • Награды Leveling срабатывают по уровням, престижу и XP, то есть зависят от ваших темпов XP, множителей, серий и затухания.
  • Стат-роли срабатывают по сырым суммам: плоский рубеж вроде «отправил 1000 сообщений», «100 часов в голосе» или «50 выигранных игр», независимо от кривой XP.

Используйте то, что подходит, или обе. Для стат-ролей не нужно строить граф наград, но каждой метрике нужна питающая её функция: Leveling для сообщений и голоса, Games для побед в играх. Метрика «стаж на сервере» работает без них.


🔑 Доступ

Стат-роли доступны владельцам серверов и участникам команды как минимум с ролью Модератор в панели YAWBDB. Сначала включите функцию Стат-роли на вашем сервере: её отключение прекращает новые выдачи, не удаляя ваши правила.