Conteúdo
Guia do módulo de sorteios do Levlix
O módulo de sorteios do Levlix permite que os admins publiquem sorteios com tempo definido que pagam pontos do servidor. Os membros participam com um clique e os vencedores são sorteados automaticamente.
Veja também: Automação de sorteios.
Como funciona um sorteio
- Um admin define um título, um prêmio em pontos, o número de vencedores e a duração. O Levlix publica o sorteio no canal escolhido com um botão Participar do sorteio.
- Os membros clicam no botão para participar. Cada membro pode participar uma vez, e o contador de participações na publicação é atualizado a cada nova participação.
- Quando o tempo acaba, o Levlix escolhe os vencedores ao acaso, credita o prêmio no saldo de cada vencedor e publica um anúncio dos vencedores no mesmo canal. A publicação original mostra o resultado e perde o botão.
- A publicação do sorteio e o anúncio dos vencedores são cartões no idioma do servidor. O botão No meu idioma mostra o mesmo cartão no seu idioma, visível só para você.
- Os sorteios em andamento sobrevivem a uma reinicialização do bot: os botões são reconectados e os temporizadores de término são reagendados. Um sorteio cujo horário de término passou enquanto o bot estava offline é sorteado assim que o bot volta.
Criando um sorteio
/giveaway create channel: #giveaways
O canal é opcional; sem ele, o Levlix usa o canal padrão das configurações ou o canal atual. O comando abre um formulário:
| Campo | Descrição |
|---|---|
| Título do sorteio | Título da publicação, com até 255 caracteres |
| Descrição | Texto opcional, com até 1.000 caracteres. O padrão é "Boa sorte a todos os participantes!" |
| Prêmio em pontos | Pontos creditados a cada vencedor. Precisa ser um número positivo |
| Número de vencedores | Entre 1 e 20 (padrão 1) |
| Duração | 60m, 1h, 1d, 2d12h e formatos parecidos. Um número sozinho conta como minutos. Padrão 60m |
/giveaway create-advanced abre o mesmo formulário com uma opção extra require_game_id, que substitui o padrão do servidor para este sorteio: só membros com um Game ID registrado podem participar.
Pelo painel web
Na página Sorteios, clique em Novo sorteio e preencha Título, Descrição, Prêmio em pontos, Vencedores, Canal e Duração (horas). Exigir Game ID limita as participações a membros com um Game ID registrado. Criar sorteio passa o sorteio ao bot, que o publica no canal exatamente como /giveaway create: mesma publicação, mesmo botão Participar do sorteio, mesmo sorteio e pagamento automáticos.
Os limites são os mesmos do comando: até 20 vencedores e de 1 a 720 horas. Você precisa ter permissão para enviar mensagens no canal, e o bot também.
Gerenciando sorteios
Cada publicação de sorteio mostra seu ID no rodapé; os comandos de admin usam esse ID:
| Comando | Descrição |
|---|---|
/giveaway end giveaway_id: <id> |
Encerra o sorteio agora, sorteia os vencedores e paga o prêmio. Encerrar antes no painel faz o mesmo |
/giveaway cancel giveaway_id: <id> |
Fecha o sorteio sem vencedores. A publicação é marcada como CANCELADO e um aviso é enviado ao canal |
/giveaway stats giveaway_id: <id> |
Status, prêmio, participações, vencedores, horário de criação, tempo restante e um link direto. O ID é completado automaticamente a partir dos sorteios recentes. Sem giveaway_id, você recebe uma visão geral dos sorteios do servidor |
Criar, encerrar, cancelar e ver estatísticas exige Gerenciar servidor (ou Administrador), ou o cargo de admin definido nas configurações. /giveaway settings exige Gerenciar servidor.
Configurações
/giveaway settings default_channel: #giveaways admin_role: @Giveaway Team enabled: True require_game_id: False
Só as opções que você informar são alteradas. Sem opções, o comando mostra as configurações atuais. As mesmas configurações também estão em /setup, em Engajamento e depois Sorteios.
| Opção | Descrição |
|---|---|
default_channel |
Canal usado quando /giveaway create é executado sem canal |
admin_role |
Cargo autorizado a criar e gerenciar sorteios, além de Administrador e Gerenciar servidor |
enabled |
Ativa ou desativa a criação de sorteios. Quando desativada, os comandos de criação respondem "Sorteios estão desativados neste servidor." |
require_game_id |
Padrão para todo o servidor: só membros com um Game ID registrado podem participar |
Para membros
/giveaway prizes
Abre um hub privado com três abas:
| Aba | Descrição |
|---|---|
| Em andamento | Todos os sorteios em andamento, com prêmio, horário de término e participações. Participar inscreve você em um sorteio direto do hub |
| Minhas participações | Os sorteios em andamento dos quais você participa |
| Meus prêmios | Quantos sorteios e quantos pontos você ganhou, com suas vitórias recentes |
O hub só é visível para você.
Painel web
Abra seu servidor no painel e escolha Sorteios na barra lateral (cargo de moderador ou superior). A página mostra contadores de sorteios ativos, total de participações, total de prêmios e sorteios concluídos, um cartão por sorteio ativo com um botão Encerrar antes e os últimos 50 sorteios anteriores com prêmio, vencedores, participações e data de término.
Novo sorteio inicia um sorteio (veja Pelo painel web). Encerrar antes pede uma confirmação e depois o bot sorteia os vencedores, paga o prêmio e os anuncia no canal do sorteio, igual ao /giveaway end.
Perguntas frequentes
E se houver menos participações do que vencedores? O Levlix sorteia tantos vencedores quantas forem as participações. Sem nenhuma participação, ele anuncia que não houve participantes suficientes.
Um membro pode participar duas vezes? Não. Um segundo clique responde "Você já está participando deste sorteio!" As participações também são recusadas depois que o horário de término passou.
Sorteios funcionam em mensagens diretas? Não. Os sorteios só funcionam em servidores.