Серверна валюта (Мультивалюти)

Опис

Посібник користувача

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

Що це робить

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

Швидкий старт (Адмін)

1. Створіть валюту: /monnaie creer id:gold nom:Or 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, якщо не хочете жодних обмежень.
• Інтервал є захистом від спаму: учасник заробляє максимум один раз за інтервал (у хвилинах) на кожну валюту. Цей лічильник тримається в пам'яті й обнуляється при перезапуску бота.
• Заробіток у голосових каналах перевіряється раз на хвилину. Голосовий заробіток нараховується лише якщо задано і суму, і голосовий інтервал.
• Ідентифікатор валюти не можна змінити після створення (назву та емодзі — можна). Виберіть його коротким і зрозумілим: він з'являється в селекторах усіх інших модулів.
• Видалення валюти видаляє все, що з нею пов'язане: баланси учасників, товари магазину, історію казино. Це невідворотно.
• Казино потрібно налаштувати для кожної валюти окремо, інакше учасники отримають повідомлення з проханням звернутися до адміністратора. У режимі «фіксована» ставка задана й обов'язкова; у режимі «вільна» гравець сам вибирає суму.
• Конвертація працює лише в одному напрямку: з похідної валюти в її основну валюту. Валюту не можна прив'язати до самої себе.
• Панель персоналу дає доступ до додавання та вилучення валюти. Публікуйте її в закритому каналі та надавайте роль персоналу лише довіреним людям: адміністратори мають доступ у будь-якому разі.
• Товари магазину, дата закінчення яких минула, видаляються автоматично (перевірка кожні десять хвилин).