Módulo de eventos: guia de configuração para admins

Este guia mostra aos administradores como ativar o módulo de eventos, iniciar um evento sazonal, definir as recompensas e conduzir eventos pelo Discord, pelo hub /setup e pelo painel web. Para saber como os eventos são vistos pelos membros (drops, mensagens temáticas, caças, pontuação), veja a página de recursos dos eventos da comunidade.

Ativando ou desativando o módulo

O módulo de eventos vem ativado por padrão, então /event para membros e o cartão de administração de eventos em /setup ficam disponíveis desde o início. Para desativá-lo (ou ativá-lo de novo):

1. Abra o painel do Levlix e selecione seu servidor.
2. Vá em Módulos e mude o módulo Eventos. Você também pode fazer isso no /setup, em Comunidade, Eventos.
3. A mudança chega ao Discord em até um minuto.

Um evento por vez

Um servidor tem no máximo um evento em andamento por vez. Um evento começa de uma de duas formas:

• Manualmente: um admin escolhe qualquer um dos nove temas e um último dia. O evento termina às 23:59:59 UTC desse dia.
• Temporada automática: depois de ativada, o Levlix confere o calendário todos os dias às 00:05 UTC e quando o bot é iniciado. Se um tema estiver na época e nenhum evento estiver em andamento, ele inicia esse tema e o encerra junto com o período do tema.

A temporada automática respeita as suas decisões. Um tema que já começou no período atual não é iniciado de novo, então um evento que você encerrou antes da hora continua encerrado. Um evento que você iniciou manualmente bloqueia a temporada automática até terminar.

Para iniciar, o Levlix precisa de pelo menos um canal de texto em que possa ver o canal, enviar mensagens, adicionar reações e ler o histórico de mensagens, e que não esteja excluído. Caso contrário, o início é recusado com uma mensagem avisando isso. Se a publicação em um canal falhar durante o evento, o Levlix ignora esse canal até o fim do evento.

O cartão de admin no Discord

Admins com a permissão Gerenciar servidor abrem o cartão de administração de eventos em /setup: escolha Comunidade, depois Eventos e depois Abrir administração de eventos.

O cartão tem quatro abas, escolhidas em um menu na parte de baixo:

• Status: se há um evento em andamento, quando ele termina e quantos membros, drops e capturas ele teve até agora. Prorrogar muda a data de término, Encerrar evento o encerra após uma confirmação e faz a rodada de vencedores na hora. Sem evento em andamento, escolha um tema em Tema para iniciar e informe a data de término (YYYY-MM-DD, UTC).
• Recompensas: a taxa de pagamento, o bônus para os lugares 1 a 3 e o cargo de vencedor. Editar valores abre um formulário para o pagamento (0 a 200%), os três bônus e quantos membros do topo recebem o cargo de vencedor (1 a 10). Escolha o cargo em Cargo de vencedor (opcional); Remover cargo de vencedor o remove.
• Anúncios: o canal de anúncios, o cargo a mencionar e o botão da temporada automática (Ativar temporada automática ou Desativar temporada automática).
• Ranking: o top 10 do evento atual e os últimos cinco eventos anteriores com seus vencedores.

Canais excluídos, nível de atividade e tempo de espera são definidos no painel web; o cartão tem um link para lá.

Recompensas

• Pagamento: cada ganho de pontuação paga score × payout / 100 pontos do servidor, arredondado para baixo. O padrão é 100%, e o intervalo vai de 0 a 200%. Com 0%, o evento vale só pelo ranking e pelos bônus.
• Pontos de bônus: os lugares 1, 2 e 3 recebem por padrão 500, 300 e 150 pontos do servidor (de 0 a 100.000 cada). Os bônus são sempre pagos integralmente, seja qual for a taxa de pagamento.
• Cargo de vencedor: opcional. No fim de cada evento, o Levlix o dá aos membros do topo (o top 3 por padrão). Eles o mantêm até o próximo evento começar; então o Levlix o retira deles.
• Empates: com a mesma pontuação, fica à frente o membro cuja última ação que pontuou aconteceu antes.

Anúncios

O Levlix publica três mensagens por evento: o início (com as recompensas em jogo), um aviso 24 horas antes do fim e a rodada de vencedores com o top 10. Elas vão para o canal de anúncios ou, se nenhum estiver definido, para o canal de sistema do servidor; sem nenhum dos dois, são puladas. O cargo a mencionar só é mencionado nas publicações de início e de vencedores.

O hub de configuração

No /setup, a página Eventos em Comunidade ativa ou desativa o módulo e reúne o básico: Iniciar eventos pelo calendário (temporada automática), Canal de anúncios e Cargo a mencionar. Abrir administração de eventos abre o cartão de admin descrito acima, Abrir painel web a página de administração na web.

O painel web

• Página de eventos do servidor (/server/{id}/events, visível para todos os membros): o evento em andamento com participantes, drops, capturas e a sua própria pontuação, o ranking, os últimos vencedores e o calendário dos próximos doze meses.
• Página de administração de eventos (/server/{id}/events/admin, para gerentes): iniciar um evento com um tema e um último dia, alterar o término ou encerrá-lo agora, as recompensas e o cargo de vencedor, o canal de anúncios, o cargo a mencionar e Começar com a temporada (temporada automática), o ranking e o arquivo dos eventos encerrados com seus vencedores.

Três configurações existem só na página de administração na web:

• Nível de atividade: Baixo (metade dos drops), Normal ou Alto (uma vez e meia mais). No Normal, um chat ativo recebe cerca de 6 drops de emoji, 2 mensagens temáticas e 1 caça por hora.
• Tempo de espera: segundos entre dois drops ou mensagens que pontuam de um mesmo membro, de 0 a 600 (60 por padrão). As caças não têm tempo de espera.
• Canais excluídos: canais e categorias inteiras onde nada aparece e onde as mensagens não contam para a atividade do chat.

Referência de comandos para membros

Este comando está disponível para todos quando o módulo está ativado:

Sair vale para todos os eventos em todos os servidores que usam o Levlix: reações e palpites de caça de membros que saíram não contam, e as mensagens deles não contam para a atividade do chat.

Lista de verificação da configuração

• Escolha um canal de anúncios, senão as publicações vão para o canal de sistema ou são puladas.
• Decida se vai ativar a temporada automática ou iniciar os temas manualmente.
• Confira as recompensas: taxa de pagamento, os três bônus e, se quiser, um cargo de vencedor.
• No painel web, exclua os canais onde os drops atrapalhariam (regras, anúncios, suporte).
• Garanta que o Levlix possa enviar mensagens, adicionar reações e ler o histórico de mensagens nos seus canais de chat.