Валюта сервера (Мультивалюты)

Описание

Руководство пользователя

Создайте одну или несколько собственных валют сервера, которые участники зарабатывают в переписке и голосовых каналах, а затем тратят в магазине, казино или мини-играх. Для администраторов, которым нужна экономика под себя, с несколькими взаимно конвертируемыми валютами.

Что это делает

• Создаёт сколько угодно валют, у каждой своё название и эмодзи.
• Начисляет доход за активность: за сообщение, за время в голосовом канале или за то и другое.
• Ограничивает начисления определёнными каналами или категориями и задаёт предел заработка.
• Публикует интерактивные панели в Discord: баланс, магазин, инвентарь, казино, обмен.
• Открывает отдельный магазин для каждой валюты (цена, запас, дата истечения срока).
• Предлагает простое казино для каждой валюты (фиксированная или свободная ставка, настраиваемый шанс, задержка).
• Связывает валюты между собой курсом обмена (производная валюта → основная валюта).
• Показывает рейтинг самых богатых.

Быстрый старт (админ)

1. Создайте валюту: /monnaie creer id:gold nom:Золото emoji:💰 (идентификатор должен состоять только из строчных латинских букв и цифр).
2. Настройте начисления: /monnaie config_gain — выберите способ (сообщения, голосовой канал, оба), размер начисления, интервал и порог по количеству символов.
3. Необязательно: ограничьте начисления несколькими каналами командой /monnaie restriction.
4. Наполните магазин: /monnaie boutique_objet или вкладка Магазин в панели управления.
5. Необязательно: настройте казино командой /monnaie casino и назначьте роль управления командой /monnaie staff_role.
6. Опубликуйте панели в канале: /monnaie panneau type:👤 Panneau Utilisateur для участников и type:🛠 Panneau Staff в канале, доступном только команде.

Команды

Для участников

Команда	Описание
/monnaie liste	Показывает все валюты, настроенные на сервере.
/monnaie classement	Рейтинг самых богатых участников по валюте.
/monnaie conversions	Показывает связанные валюты и их курс обмена.
/monnaie convertir	Обменивает производную валюту на её основную валюту.

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

Для администраторов

Команда	Описание
/monnaie creer	Создать валюту (идентификатор, название, эмодзи).
/monnaie config_gain	Настроить начисления: способ, сумма, интервал, порог по символам, предел.
/monnaie restriction	Ограничить начисления каналом или категорией.
/monnaie boutique_objet	Добавить товар в магазин валюты.
/monnaie casino	Настроить казино валюты (режим, ставка, выигрыш, шанс, задержка).
/monnaie staff_role	Назначить роль, которой разрешено пользоваться панелью персонала.
/monnaie lier	Связать производную валюту с основной по курсу.
/monnaie panneau	Опубликовать интерактивную панель (участника или персонала) в канале.

Настройки в панели управления

Модуль «Мультивалюты» состоит из четырёх вкладок:

• Валюты — создание и полное изменение валюты: название, эмодзи, способ начисления, сумма и интервал за сообщение, порог по символам, суточный предел, сумма и интервал в голосовом канале, разрешённые каналы и категории, настройки казино (режим, задержка, ставка, выигрыш, шанс в виде числителя и знаменателя) и связь обмена с основной валютой.
• Магазин — товары конкретной валюты: название, описание, эмодзи, цена, запас (пусто = без ограничений), дата истечения срока.
• Балансы — сто крупнейших балансов валюты с возможностью корректировать баланс каждого участника (заменить значение либо добавить или снять сумму).
• Параметры — роль персонала, которой разрешено пользоваться кнопками панели персонала.

Публикация панелей Discord по-прежнему выполняется из Discord командой /monnaie panneau: панель управления не отправляет сообщение за вас.

Связь с магазином

Не путайте две разные системы:

• Магазин этого модуля встроенный: у каждой валюты свой список товаров, покупка совершается кнопкой «🛒 Магазин» на панели участника, цена списывается сразу, а товар попадает в инвентарь участника. Ни тикета, ни подтверждения нет.
• Модуль «ShopDiscord» — отдельная система со своей валютой под названием «очки», бонусными ролями, бустами и подтверждением через тикет при каждой покупке. Если вам нужен такой порядок работы, откройте страницу ShopDiscord (Магазин и Очки) этой документации.

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

Валюты этого модуля также используются в мини-играх Activity и в модуле Испытания и карточки.

Полезно знать

• Панель управления показывает предупреждение «Модуль нестабилен — в разработке». Проверьте свои настройки, прежде чем запускать экономику, на которую будут рассчитывать ваши участники.
• Без порога по символам начисления за сообщения не выплачиваются. Этот порог используется в расчёте как делитель: сообщение длиной ровно в порог приносит полное начисление, более длинное — пропорционально больше, более короткое — пропорционально меньше. Если порог равен 0, начисление всегда равно 0. Задайте разумное значение (например, 20 символов).
• «Суточный предел» сравнивается с текущим балансом, а не с заработком за день: превысив это значение, участник больше ничего не получает по данной валюте. То есть он работает как потолок баланса. Оставьте 0, если потолок вам не нужен.
• Интервал — это защита от спама: участник получает начисление не чаще одного раза за интервал (в минутах) по каждой валюте. Этот счётчик хранится в памяти и обнуляется при перезапуске бота.
• Начисления в голосовых каналах проверяются раз в минуту. Голосовое начисление срабатывает только если заданы и сумма, и голосовой интервал.
• Идентификатор валюты нельзя изменить после создания (название и эмодзи — можно). Выбирайте его коротким и говорящим: он появляется в списках выбора всех остальных модулей.
• Удаление валюты удаляет всё, что с ней связано: балансы участников, товары магазина, историю казино. Это необратимо.
• Казино нужно настраивать отдельно для каждой валюты, иначе участники получат сообщение с просьбой обратиться к администратору. В режиме «фиксированная» ставка задана и обязательна; в режиме «свободная» игрок выбирает сумму сам.
• Обмен работает только в одну сторону: из производной валюты в её основную. Валюту нельзя связать с самой собой.
• Панель персонала даёт доступ к начислению и списанию валюты. Публикуйте её в закрытом канале и выдавайте роль персонала только тем, кому доверяете: у администраторов доступ есть в любом случае.
• Товары магазина с истёкшей датой удаляются автоматически (проверка каждые десять минут).