Экономика
Экономика сервера использует очки активности — внутреннюю валюту, которую участники могут получать за активность и тратить на награды.
Очки можно заработать за:
- ежедневные и еженедельные бонусы;
- выполнение миссий;
- места в топе активности;
- завершение достижений;
- переводы от других участников;
- ручную выдачу администратором.
Потратить очки можно на:
- XP-бустеры;
- роли из магазина кастомных ролей.
На странице экономики администраторы могут просматривать балансы участников, историю операций и настраивать бонусы.
Как открыть и включить
Откройте страницу «Экономика».
Для работы большинства экономических команд должен быть включён общий модуль Рейтинг:
- Откройте «Обзор сервера».
- Найдите раздел Модули.
- Убедитесь, что модуль Рейтинг включён.
По умолчанию он уже включён. Подробнее о его настройках можно прочитать в разделе «Рейтинг».
От модуля Рейтинг зависят команды:
/activity;/booster;/missions.
Исключение — подгруппа /activity shop, которая относится к магазину ролей и зависит от модуля Кастомные роли.
Как заработать очки
| Источник | Награда | Условия |
|---|---|---|
/activity daily | Случайно от 50 до 150 очков | Можно получать раз в 24 часа. Диапазон настраивается. |
/activity weekly | Случайно от 300 до 700 очков | Можно получать раз в 7 дней. Диапазон настраивается. |
| Ежедневные миссии | От 50 до 100 очков | Набор миссий обновляется раз в сутки. |
| Топ активности | Настраивается отдельно | Награды выдаются участникам, занявшим места с 1-го по 3-е. |
| Достижения | Зависит от достижения | Начисляется после его завершения. |
/activity transfer | Сумма перевода за вычетом комиссии | Очки переводит другой участник. |
| Ручная выдача | Указывается администратором | Через панель управления или команду Discord. |
Серия ежедневных бонусов
Если участник получает ежедневный бонус каждый день подряд, размер награды увеличивается на 5% за каждый день серии.
Максимальный бонус серии — 100%.
Если между получениями проходит больше 48 часов, серия сбрасывается.
Учёт активности
Для топов активности учитываются сообщения, отправленные при включённом модуле Рейтинг.
При подсчёте применяются:
- белые и чёрные списки каналов;
- белые и чёрные списки ролей;
- исключения из топа.
Сообщения ботов не учитываются.
Подсчёт сообщений для экономики и начисление опыта работают отдельно. Настройки одной системы не всегда влияют на другую.
Основные настройки
| Параметр | Где настраивается | Значение по умолчанию | Описание |
|---|---|---|---|
| Диапазон ежедневного бонуса | Панель или /activity reward daily-range | 50–150 | Минимальная и максимальная случайная награда за /activity daily. |
| Диапазон еженедельного бонуса | Панель или /activity reward weekly-range | 300–700 | Минимальная и максимальная случайная награда за /activity weekly. |
| Задержка повторной выдачи | Только панель | 0, выключена | Ограничивает повторную ручную выдачу очков одному участнику через панель. |
| Награды за топ-места | /activity reward setrank | 0, не выдаются | Определяет награды за места с 1-го по 3-е для каждого периода. |
| Интервал выплат | /activity reward interval | 1 день | Определяет, как часто выдаются награды лидерам активности. |
| Канал статистики | /activity set_channel | Не задан | Канал, в котором бот публикует и обновляет сообщение с топами. |
| Роли топ-1, топ-2 и топ-3 | /activity setroles и /activity delroles | Не заданы | Роли, выдаваемые лидерам общего топа за всё время. |
| Списки каналов | /activity add и /activity remove | Пусто | Определяют, в каких каналах сообщения учитываются или игнорируются. |
| Списки ролей | /activity addrole и /activity remrole | Пусто | Определяют, сообщения каких участников учитываются или игнорируются. |
| Исключения из топа | /activity drop и /activity back | Пусто | Убирают участника или роль из таблиц лидеров и автоматических наград. |
Общие настройки можно посмотреть командой /activity show.
Текущие награды за места показываются командой /activity reward show.
Ежедневный бонус
Команда:
/activity daily
выдаёт случайное количество очков из настроенного диапазона.
По умолчанию это от 50 до 150 очков.
Получить бонус можно раз в 24 часа.
Размер награды может быть увеличен серией ежедневных получений.
Еженедельный бонус
Команда:
/activity weekly
выдаёт случайное количество очков из настроенного диапазона.
По умолчанию это от 300 до 700 очков.
Получить бонус можно раз в 7 дней.
Переводы между участниками
Команда:
/activity transfer user:<участник> amount:<сумма>
позволяет перевести очки другому участнику.
Ограничения:
- минимальная сумма перевода — 10 очков;
- переводить очки самому себе нельзя;
- переводить очки ботам нельзя;
- комиссия составляет 10%;
- минимальная комиссия — 1 очко.
Например, если отправить 100 очков, получатель получит 90, а 10 очков составят комиссию.
Команды участников
| Команда | Описание |
|---|---|
/activity info | Показывает вашу статистику сообщений и текущий баланс. |
/activity info member:<участник> | Показывает статистику выбранного участника. |
/activity leaders <период> | Показывает 10 лидеров по сообщениям или балансу. |
/activity daily | Получить ежедневный бонус. |
/activity weekly | Получить еженедельный бонус. |
/activity transfer | Перевести очки другому участнику. |
/booster shop | Открыть магазин XP-бустеров. |
/booster buy | Купить бустер. |
/booster status | Проверить активный бустер. |
/missions list | Посмотреть сегодняшние миссии. |
/missions progress | Посмотреть прогресс выполнения миссий. |
/activity reward show | Посмотреть награды за места в топах. |
Параметр member в команде /activity info необязателен. Без него бот покажет вашу статистику.
Административные команды
| Команда | Кто может использовать | Описание |
|---|---|---|
/activity reward add | Только участник с разрешением Discord Администратор | Добавляет от 1 до 150 000 очков. |
/activity reward remove | Только участник с разрешением Discord Администратор | Снимает от 1 до 150 000 очков. |
/activity reward set | Администратор или право reward.set | Устанавливает точный баланс участника. |
/activity reward setrank | Администратор или право reward.set | Настраивает награды за места в топах. |
/activity reward daily-range | Администратор или право reward.set | Настраивает диапазон ежедневного бонуса. |
/activity reward weekly-range | Администратор или право reward.set | Настраивает диапазон еженедельного бонуса. |
/activity reward interval | Администратор или право reward.set | Настраивает интервал автоматических выплат. |
/activity reward reset | Администратор или право reward.set | Обнуляет балансы участников и настройки наград за топ-места. |
/activity set_channel | Администратор или право reward.set | Выбирает канал статистики. |
/activity setroles | Администратор или право reward.set | Назначает роли для лидеров общего топа. |
/activity delroles | Администратор или право reward.set | Удаляет настройки ролей лидеров. |
/activity addrole | Администратор или право reward.set | Добавляет роль в список учёта или исключений. |
/activity remrole | Администратор или право reward.set | Удаляет роль из списка. |
/activity drop | Администратор или право reward.set | Исключает участника или роль из топов. |
/activity back | Администратор или право reward.set | Возвращает участника или роль в топы. |
/activity show | Администратор или право reward.set | Показывает настройки активности. |
/activity add | Только участник с разрешением Discord Администратор | Добавляет канал в белый или чёрный список. |
/activity remove | Только участник с разрешением Discord Администратор | Удаляет канал из списка. |
Дополнительные права вида reward.set настраиваются в разделе «Права для команд».
Таблицы лидеров
Команда /activity leaders показывает 10 участников с наибольшими показателями.
Период «неделя» здесь означает последние 7 дней на момент вызова команды.
Это rolling-период, поэтому он может отличаться от завершённой календарной
недели, за которую выдаётся недельный XP-бустер.
Участники, исключённые командой /activity drop, и текущие участники
исключённых ролей не попадают в таблицы Activity, роли лидеров, обычные
награды активности и недельную выплату топ-10.
Доступные варианты зависят от реализации команды и могут включать:
- сообщения за день;
- сообщения за неделю;
- сообщения за месяц;
- сообщения за всё время;
- баланс очков.
Канал статистики
Команда /activity set_channel позволяет выбрать канал, в котором бот будет поддерживать сообщение со статистикой.
В сообщении отображаются топы:
- за день;
- за неделю;
- за месяц;
- за всё время.
Сообщение обновляется примерно раз в минуту.
Боту необходимы права:
- Просматривать канал;
- Отправлять сообщения;
- Встраивать ссылки;
- Читать историю сообщений.
Роли лидеров
Команда /activity setroles позволяет назначить роли участникам, занимающим места с 1-го по 3-е в общем топе за всё время.
При смене лидера бот переносит роль новому участнику.
Чтобы бот мог управлять такими ролями:
- у него должно быть разрешение Управлять ролями;
- роль бота должна находиться выше ролей топ-1, топ-2 и топ-3.
Награды за топ-места
Для каждого периода можно настроить награды за первое, второе и третье место.
Награды выдаются автоматически через установленный интервал.
По умолчанию они выключены, поскольку их размер равен нулю.
Бот проверяет необходимость выплаты примерно раз в час. Поэтому фактическое начисление может произойти немного позже установленного срока.
Лидеры определяются по количеству сообщений на момент выплаты.
Белые и чёрные списки каналов
Списки каналов определяют, где сообщения учитываются в статистике активности.
Если белый список не пуст, сообщения учитываются только в добавленных в него каналах.
Чёрный список исключает выбранные каналы из подсчёта.
Перед изменением настроек рекомендуется проверить результат командой /activity show.
Белые и чёрные списки ролей
Списки ролей определяют, сообщения каких участников должны учитываться.
Настройки применяются к статистике активности и топам, но не обязательно влияют на начисление опыта.
Исключение из топов
Команда /activity drop исключает участника или роль из:
- таблиц лидеров;
- автоматических наград за места.
При этом сообщения участника продолжают учитываться в его личной статистике /activity info.
Команда /activity back возвращает участника или роль в топы.
XP-бустеры
XP-бустер временно увеличивает количество опыта, получаемого за сообщения и миссии.
Одновременно может быть активен только один бустер.
Пока бустер действует, купить новый нельзя.
| Бустер | Бонус к опыту | Длительность | Цена |
|---|---|---|---|
| Малый | +5% | 1 час | 700 очков |
| Средний | +15% | 6 часов | 2000 очков |
| Большой | +30% | 1 день | 4500 очков |
| Супер | +30% | 7 дней | 7000 очков |
| Топ-10 недельный | +20% | 7 дней | Не продаётся |
Это набор по умолчанию. Администратор сервера может изменить название, множитель, длительность и цену любого бустера в веб-панели, а также выключить бустер целиком — тогда его не будет в магазине.
Поэтому таблица выше описывает бустеры только на сервере, где настройки не меняли. Актуальный список всегда показывает команда /booster shop.
Топ-10 недельный бустер
После завершения недели бот автоматически выдаёт этот бустер участникам с наибольшим числом сообщений за прошлую календарную неделю: с понедельника 00:00 включительно до следующего понедельника 00:00 исключительно по локальному времени бота. Выплата планируется после 00:05.
Если несколько участников делят десятое место, награду получают все участники с тем же количеством сообщений. При одинаковом результате порядок отображения стабилен: сначала меньший Discord ID.
Награда выдаётся только участнику, который остаётся на сервере в момент выплаты. Исключённые через Activity участники и роли в расчёт не входят.
Если у участника уже действует бустер, он не заменяется и не сокращается. Недельная награда сохраняется в очереди и автоматически активируется после окончания текущего бустера. Для отложенной награды сохраняются название, множитель и длительность, действовавшие в момент подведения итогов.
После выдачи бот пытается отправить участнику личное сообщение.
Истечение бустера
Срок действия активных бустеров проверяется примерно раз в минуту.
После завершения действия бот пытается уведомить участника в личных сообщениях.
Уведомление может не дойти, если пользователь запретил личные сообщения от участников сервера или заблокировал бота.
Команды /activity shop buyboost и /booster buy покупают одинаковые бустеры. Можно использовать любую из них.
Миссии
Каждый день бот создаёт три миссии для участников, уже учтённых в статистике активности сервера.
| Миссия | Условие | Награда |
|---|---|---|
| Сообщения | Отправить 100 сообщений | 50 очков |
| Голосовая активность | Провести 1 час в голосовых каналах | 75 очков |
| Повышение уровня | Получить новый уровень | 100 очков и малый бустер |
Малый бустер за повышение уровня выдаётся только в том случае, если у участника ещё нет активного бустера.
Прогресс сообщений
В миссии учитываются только сообщения, за которые был начислен опыт.
Если сообщение было отправлено во время задержки между начислениями опыта, оно не увеличит прогресс миссии.
Что показывает панель
Диапазоны бонусов
Здесь можно настроить:
- минимальную и максимальную награду
/activity daily; - минимальную и максимальную награду
/activity weekly; - задержку между ручными выдачами одному участнику через панель.
Богатство
Раздел показывает участников с наибольшим балансом.
В нём доступны:
- поиск участника;
- ручное начисление очков;
- снятие очков;
- установка точного баланса.
Операции, выполненные в этом разделе, записываются в историю и журнал событий.
Бустеры
Панель показывает таблицу с параметрами бустеров:
- название;
- множитель опыта;
- длительность;
- цену;
- переключатель «Вкл».
Изменения применяются к боту. После сохранения бот использует новые значения без перезапуска: /booster shop показывает новую цену, а покупка списывает именно её.
Выключенный бустер полностью исчезает: его не видно в магазине, его нельзя купить и его не выдаст автоматическая награда.
На сервере, где бустеры ещё не настраивали, таблица показывает встроенный набор бота. Первое сохранение делает эти значения настройками сервера.
Строки таблицы можно только изменять — добавить новый бустер или удалить встроенный из панели нельзя. Чтобы убрать бустер, выключите его переключателем.
История
История показывает начисления и списания очков.
В ней могут отображаться типы операций:
daily_bonus;transfer_send;booster_purchase;auto;- другие системные типы.
Доступна фильтрация по типу операции.
На одной странице отображается до 50 записей.
История операций
Не все изменения баланса записываются в историю.
Например, очки за достижения попадают на общий баланс, но отдельная запись в истории может не создаваться.
Поэтому текущий баланс участника может не всегда полностью совпадать с суммой видимых операций.
Сброс экономики
Команда:
/activity reward reset
после подтверждения:
- обнуляет балансы всех участников;
- сбрасывает настройки наград за топ-места.
Операция необратима.
История начислений и списаний при этом не очищается.
Перед выполнением команды рекомендуется сохранить необходимые данные отдельно.
Ограничения
Задержка ручной выдачи
Задержка, настроенная в панели, действует только на операции, выполненные через панель управления.
На команду /activity reward add в Discord она не распространяется.
Независимый подсчёт опыта и активности
Подсчёт сообщений для экономики и начисление опыта используют разные настройки.
Команды /activity add и /activity addrole не влияют на опыт.
Команда /ranking ignore не влияет на топы активности.
Исключение из топа
Исключённый участник не отображается в топах и не получает награды за места.
При этом его сообщения продолжают учитываться в личной статистике.
Задержка выплаты наград
Проверка автоматических выплат выполняется примерно раз в час.
Поэтому награда может быть начислена позже указанного интервала.
Не все операции попадают в историю
Все источники используют один общий баланс, но отдельные события могут не создавать запись в истории.
Названия бустеров в команде покупки
Список вариантов у команды /booster buy задан в Discord один раз и не меняется вместе с настройками сервера.
Поэтому переименованный в панели бустер выбирается в команде по старому названию. Бот понимает такой выбор и покупает нужный бустер по актуальной цене — новое название видно в /booster shop и в сообщении о покупке.