🎉 Розыгрыши
Описание
Руководство пользователя
Запускайте розыгрыши, управляйте несколькими призами, требуйте роли/очки, перевыбирайте победителей и отображайте участников — без головной боли.
🔎 Что это делает
- Создаёт розыгрыши с 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 (дни/часы/минуты).