🎉 Sorteios (Giveaways)
Descrição
Guia do Usuário
Lança sorteios, gere múltiplos prêmios, exige cargos/pontos, re-sorteia vencedores e exibe participantes — sem complicações.
🔎 O que faz
- Cria sorteios de 1 ou múltiplos prêmios.
- Botões de participação persistentes (o contador se atualiza).
- Condições de entrada: cargos necessários, pontos (opcional).
- Peso das chances: acúmulo de cargos + cargos bônus.
- Fim automático ⏱️, sorteio dos vencedores 🏆, reroll fácil.
🚀 Início Rápido
- Lança um sorteio simples (prêmio único):
/giveaway duration:1h winners:1 role_1:@Membro cumul_roles:Não varios_items:Não gain_multiple:Não - Ou um sorteio multi-prêmios: o bot pedirá a lista de prêmios (um por linha).
- (Opcional) Exigir/consumir pontos:
required_points:100•consume_points:Sim
🧩 Opções Importantes
| Opção | Descrição |
|---|---|
duration | ex. 10m, 2h, 3d1h10m. |
winners | nº de vencedores por prêmio. |
role_1 | cargo obrigatório. role_2 opcional. |
cumul_roles | soma role_1 + role_2 para mais chances. |
bonus_roles | cargos que dão chances extras. |
plusieurs_items | ativar multi-prêmios (o bot pedirá a lista). |
gain_multiple | a mesma pessoa pode ganhar vários prêmios? |
required_points | exigir pontos para participar. |
consume_points | deduzir pontos para participar. |
message_id | reutilizar um embed existente (uma seção "⏰ Fin" é adicionada autom.). |
🧰 Gestão Rápida (Admin)
| Comando | Descrição |
|---|---|
/giveaway | Criar (prêmio único ou multi-prêmios). |
/giveaway_lister | Ver sorteios ativos. |
/giveaway_participants | Listar inscritos por prêmio. |
/giveaway_terminer | Terminar agora e sortear. |
/giveaway_annuler | Cancelar sem sorteio. |
/giveaway_relancer | Prolongar/modificar a duração. |
/giveaway_reroll | Re-sortear (um ou vários prêmios). |
👥 Participação (Usuário)
- Clique no botão 🎉 Participer (Participar) ou no botão do prêmio desejado.
- Se já estiver inscrito, um mini menu propõe desinscrever-se (reembolso de pontos se aplicável 💸).
- A etiqueta
📊 Participantes (N)atualiza sozinha.
🛟 Solução de Problemas
- 🚫 Impossível participar: falta cargo necessário, ou não há pontos suficientes.
- 🧮 Contador bloqueado: aguarde 1–2 s, atualiza após escrita no banco de dados.
- 🎛️ Multi-prêmios: cada prêmio tem seu próprio botão e lista de participantes.
- 🔁 Reroll: se "vencedores múltiplos" estiver desativado, um vencedor não pode levar dois prêmios.
❓ FAQ
Perguntas Frequentes
Pode-se reutilizar um embed já postado?
Sim: passe message_id e (opcional) channel. O bot adiciona a linha ⏰ Fim.
Os pontos são reembolsados se eu me desinscrever? Sim, se a opção "consumir pontos" estava ativa, o reembolso é automático ao desinscrever.
Como escrever a duração?
Encadeie as unidades: 3d1h10m (dias/horas/minutos).