🎉 Розіграші
Опис
Посібник користувача
Запускайте розіграші, керуйте кількома призами, вимагайте ролі/очки, перевибирайте переможців та відображайте учасників — без головного болю.
🔎 Що це робить
- Створює розіграші з 1 або кількома призами.
- Постійні кнопки участі (лічильник оновлюється).
- Умови входу: вимагані ролі, очки (опціонально).
- Вага шансів: накопичення ролей + бонусні ролі.
- Автоматичне завершення ⏱️, вибір переможців 🏆, легкий reroll.
🚀 Швидкий старт
- Запустіть простий розіграш (один приз):
/giveaway duration:1h winners:1 role_1:@Учасник cumul_roles:Ні plusieurs_items:Ні gain_multiple:Ні - Або розіграш з кількома призами: бот попросить список призів (по одному на рядок).
- (Опція) Вимагати/витрачати очки:
required_points:100•consume_points:Так
🧩 Важливі опції
| Опція | Опис |
|---|---|
duration | наприклад 10m, 2h, 3d1h10m. |
winners | кількість переможців на приз. |
role_1 | обов'язкова роль. role_2 опціонально. |
cumul_roles | сумує role_1 + role_2 для більшого шансу. |
bonus_roles | ролі, що дають бонус до шансів. |
plusieurs_items | увімкнути кілька призів (бот попросить список). |
gain_multiple | чи може одна людина виграти кілька призів? |
required_points | вимагати очки для участі. |
consume_points | списувати очки за участь. |
message_id | використовувати існуючий embed (секція "⏰ Кінець" додається автоматично). |
🧰 Швидке керування (Адмін)
| Команда | Опис |
|---|---|
/giveaway | Створити (один або кілька призів). |
/giveaway_lister | Переглянути активні розіграші. |
/giveaway_participants | Список учасників за призами. |
/giveaway_terminer | Завершити зараз та вибрати переможців. |
/giveaway_annuler | Скасувати без вибору переможців. |
/giveaway_relancer | Продовжити/змінити тривалість. |
/giveaway_reroll | Перевибір (один або кілька призів). |
👥 Участь для учасників
- Натисніть кнопку 🎉 Участь або кнопку потрібного призу.
- Якщо ви вже записані, міні-меню запропонує відписатися (повернення очок, якщо застосовно 💸).
- Мітка
📊 Учасники (N)оновлюється автоматично.
🛟 Усунення неполадок
- 🚫 Неможливо участвувати: відсутня вимагана роль або недостатньо очок.
- 🧮 Лічильник застряг: почекайте 1–2 сек, він оновлюється після запису в базу.
- 🎛️ Кілька призів: кожен приз має свою кнопку та свій список учасників.
- 🔁 Reroll: якщо "кілька виграшів" вимкнено, переможець не може виграти два призи.
❓ FAQ
Часті запитання
Чи можна використовувати вже опублікований embed?
Так: вкажіть message_id та (опція) channel. Бот додасть рядок ⏰ Кінець.
Очки повертаються при відписці? Так, якщо опція "витрачати очки" була активна, повернення відбувається автоматично при відписці.
Як написати тривалість?
З'єднайте одиниці: 3d1h10m (дні/години/хвилини).