Desafios & Cartas

Descrição

Guia do Usuário

Anime sua comunidade com desafios semanais validados pela equipe, cartas colecionáveis, caixas de recompensa, um cofre com código secreto e aparições surpresa no chat. Destinado a administradores que querem dar um objetivo à moeda do seu servidor.

O que ele faz

• Publica desafios semanais que os membros escolhem e depois valida suas provas em um canal dedicado.
• Permite colecionar cartas (6 raridades) agrupadas em coleções, sorteadas em boosters pagos.
• Vende caixas de recompensa cujo conteúdo é sorteado conforme probabilidades.
• Abre um cofre que os membros tentam destrancar com um código secreto.
• Aciona eventos reativos: uma recompensa aparece aleatoriamente no chat, para os primeiros que clicarem.
• Gerencia o prestígio, os emblemas e os itens raros, todos visíveis em um perfil.

Início rápido (Admin)

1. Crie primeiro uma moeda no módulo "Multi-Moedas": todo este módulo depende dela (veja Moeda do servidor).
2. Abra o módulo Desafios & Cartas no dashboard.
3. Aba Desafios: crie um desafio (título, critério, recompensa, moeda) e declare o canal de validação dessa moeda — é lá que as provas chegarão.
4. Aba Cartas: crie uma coleção e algumas cartas; aba Boosters: crie um booster e ajuste suas probabilidades por raridade.
5. Aba Cofres: crie um cofre (código secreto, tentativas por dia, prêmio).
6. Aba Eventos: ajuste a chance de aparição, a duração e a recompensa — depois adicione pelo menos um canal autorizado, senão nada aparecerá.
7. Anuncie aos membros /challengesystem defi liste e /challengesystem profil voir.

Comandos

Todos os comandos ficam sob /challengesystem, seguidos de um grupo e de uma ação.

Para os membros

Comando	Descrição
/challengesystem defi liste	Exibe os desafios disponíveis, agrupados por moeda.
/challengesystem defi choisir	Escolher um desafio semanal.
/challengesystem defi soumettre_preuve	Enviar um arquivo como prova de conclusão.
/challengesystem profil voir	Seu perfil completo (moedas, emblemas, itens, cartas, prestígio).
/challengesystem profil recompenses	Ver as recompensas configuradas no servidor.
/challengesystem carte moi	Ver sua coleção de cartas.
/challengesystem collection lister	Ver as coleções do servidor.
/challengesystem booster ouvrir	Abrir um booster de cartas (pago).
/challengesystem lootbox ouvrir	Abrir uma caixa de recompensa e descobrir seu prêmio.
/challengesystem lootbox voir	Ver o conteúdo anunciado de uma caixa de recompensa.
/challengesystem coffre tenter	Tentar abrir o cofre digitando o código.
/challengesystem coffre actif	Ver o cofre em andamento.
/challengesystem coffre stats	Ver suas tentativas restantes no dia.
/challengesystem prestige voir	Ver seu nível de prestígio.
/challengesystem badge voir	Ver seus emblemas.
/challengesystem objet voir	Ver seus itens raros.

Para a equipe

Comando	Descrição
/challengesystem defi ajouter	Criar um desafio semanal.
/challengesystem defi config_validation	Definir o canal de validação das provas para uma moeda.
/challengesystem carte creer · carte modifier · carte supprimer	Gerenciar as cartas (com prévia antes de publicar).
/challengesystem collection creer	Criar uma coleção de cartas.
/challengesystem booster creer · booster config_proba	Criar um booster e ajustar suas probabilidades por raridade.
/challengesystem lootbox ajouter · lootbox ajouter_item	Criar uma caixa de recompensa e colocar prêmios nela.
/challengesystem coffre creer · coffre fermer	Abrir ou fechar um cofre.
/challengesystem prestige configurer	Definir o limite de prestígio e o cargo atribuído.
/challengesystem badge ajouter	Criar um emblema disponível.
/challengesystem objet ajouter	Criar um item raro.
/challengesystem event configurer · event onoff	Configurar e ativar os eventos reativos.
/challengesystem event channels_add · channels_remove · channels_list	Gerenciar os canais em que os eventos podem aparecer.
/challengesystem event forcer	Acionar um evento imediatamente (teste).
/challengesystem chaos ajouter · chaos ajouter_effet · chaos liste · chaos ouvrir	Gerenciar os Cofres do Caos e seus efeitos.

Configuração pelo dashboard

O módulo se apresenta em dez abas e cobre tudo o que fazem os comandos da equipe — em geral de forma mais confortável (tabelas, formulários, seletores de cargos e de canais):

• Desafios — lista dos desafios (título, tipo, critério, tipo e valor da recompensa, moeda associada, prova obrigatória ou não) e tabela dos canais de validação por moeda.
• Cartas — cartas (nome, descrição, imagem por URL, raridade, coleção) e coleções.
• Boosters — preço, moeda, número de cartas sorteadas (mín./máx.) e tabela de sorteio por tipo e raridade, com peso.
• Lootbox — caixas (preço, moeda, estoque) e seus prêmios com um peso de sorteio.
• Cofres — código secreto, dica, tentativas por dia, prêmio e a opção "desativar os outros cofres ativos".
• Prestígio — limite (total das moedas), cargo atribuído, multiplicador exibido na ficha de prestígio.
• Emblemas — nome, emoji, imagem e cargo do Discord atribuído junto com o emblema (opcional).
• Itens raros — nome, descrição, emoji, imagem.
• Eventos — chance por mensagem (0 a 1), tempo de espera, número de vencedores, duração, recompensa.
• Caos — Cofres do Caos e seus efeitos: perda global, boost de cassino, bônus global, fechamento da loja, inversão dos ganhos.

Bom saber

• O dashboard exibe um aviso "Módulo instável — em desenvolvimento". Ele é recente e pode mudar sem aviso: teste em um canal discreto antes de anunciar um evento a todo o servidor.
• Nada funciona sem moeda. Desafios, boosters, caixas de recompensa, cofres e eventos estão todos vinculados a uma moeda do módulo Multi-Moedas. Sem uma moeda criada, os formulários ficarão vazios.
• Os desafios não se validam sozinhos. O "tipo" e o "critério" são texto livre: o bot não mede nenhum progresso. O membro escolhe o desafio, envia um arquivo como prova, e um integrante da equipe aprova ou recusa com os botões da mensagem publicada no canal de validação. Sem canal de validação configurado para a moeda do desafio, a prova não chega a lugar algum.
• Um desafio só pode ser escolhido uma vez por membro: não existe "jogar de novo".
• O prestígio zera os contadores. Quando o total das moedas de um membro atinge o limite, todos os seus saldos voltam a 0, seu nível de prestígio aumenta em 1 e o cargo configurado lhe é atribuído. Anuncie isso claramente, senão seus membros vão sentir como uma perda.
• Cofre: o código é armazenado de forma criptografada (ninguém consegue lê-lo no banco de dados), as tentativas são limitadas por dia (de 1 a 100, 5 por padrão) e zeradas todos os dias. Criar um cofre desativa os anteriores por padrão.
• Os eventos reativos só aparecem nos canais que você listar. Enquanto nenhum canal for adicionado, a chance de aparição não serve para nada. O bot também precisa da permissão de escrever nesses canais.
• As compras são debitadas antes do sorteio: abrir uma caixa de recompensa ou um booster verifica o saldo, reserva o estoque e então sorteia o prêmio. Estoque esgotado impede a abertura.
• Não todos os comandos da equipe são protegidos da mesma forma. A maioria exige "Gerenciar servidor" ou "Administrador", mas alguns comandos de criação (os desafios e as caixas de recompensa em especial) não verificam nada do lado do bot. Restrinja /challengesystem aos seus cargos de confiança em Configurações do servidor → Integrações.
• O módulo tem mais de quarenta subcomandos: prefira o dashboard para a configuração e deixe aos membros apenas os comandos de consulta e de jogo.