Yue Mizuki Discord Bot

• Ferramentas de moderação e logs de moderação
• Configuração do servidor via painel (AutoMod, autorole, etc.)
• Gerenciamento de sorteios (incluindo participações e rastreamento de vencedores)
• XP / níveis (rankings do servidor e globais)
• Listagem e detalhes de membros no painel
• Perfil de usuário e emblemas
• Fluxos de envio e revisão de fan arts (com listas de permissão)
• Funcionalidades de economia e jogos de cara ou coroa
• Inteligencia Artificial sem censura de conversa.

Responsabilidades:

• Moderação e automação no Discord
• Tarefas agendadas (sorteios, expiração de avisos, autorole)
• Uma API HTTP interna usada pelo backend para executar ações no contexto do Discord

Observação:

• Muitos nomes de opções estão em português (por exemplo usuario, razao) pois o bot é operado principalmente em pt-BR.
• Alguns comandos possuem nome localizado em pt-BR (por exemplo /ban também está disponível como /banir).

• /ban (pt-BR: /banir) - Banir um membro.
  • Opções: usuario (obrigatório), razao (opcional), deletar_mensagens (opcional, 0-7 dias)
  • Exemplo: /ban usuario:@User razao:"spam" deletar_mensagens:1
• /kick (pt-BR: /expulsar) - Expulsar um membro.
  • Opções: usuario (obrigatório), razao (opcional)
  • Exemplo: /kick usuario:@User razao:"violação de regras"
• /mute (pt-BR: /silenciar) - Aplicar um timeout do Discord.
  • Opções: usuario (obrigatório), duracao (obrigatório; 5m, 2h, 1d, 1w), razao (opcional)
  • Exemplo: /mute usuario:@User duracao:30m razao:"se acalmar"
• /unmute (pt-BR: /dessilenciar) - Remover um timeout.
  • Opções: usuario (obrigatório)
  • Exemplo: /unmute usuario:@User
• /warn (pt-BR: /avisar) - Adicionar um aviso.
  • Opções: usuario (obrigatório), razao (obrigatório)
  • Exemplo: /warn usuario:@User razao:"caps"
• /unwarn (pt-BR: /remover-aviso) - Remover avisos.
  • Opções: usuario (obrigatório), quantidade (opcional; omitir para remover todos)
  • Exemplo: /unwarn usuario:@User quantidade:1
• /modlog - Exibir histórico de moderação.
  • Opções: usuario (obrigatório), tipo (opcional: ban|kick|warn|mute|unmute), limite (opcional, 1-25)
  • Exemplo: /modlog usuario:@User tipo:warn limite:10
• /baninfo - Verificar se um ID está banido e exibir detalhes do banimento.
  • Opções: usuario_id (obrigatório)
  • Exemplo: /baninfo usuario_id:123456789012345678

• /limpar - Excluir mensagens em massa.
  • Requer: Gerenciar Mensagens
  • Opções: quantidade (obrigatório, 1-1000), usuario (opcional), filtro (opcional: bots|humans|links|attachments)
  • Exemplo: /limpar quantidade:50 filtro:links
• /lock (pt-BR: /trancar) - Travar um canal de texto (negar SendMessages para @everyone).
  • Requer: Gerenciar Canais
  • Opções: canal (opcional, padrão: canal atual), razao (opcional)
  • Exemplo: /lock canal:#general razao:"raid"
• /unlock (pt-BR: /destrancar) - Destravar um canal previamente travado.
  • Requer: Gerenciar Canais
  • Opções: canal (opcional, padrão: canal atual)
  • Exemplo: /unlock canal:#general
• /painel - Enviar a URL do painel de administração.
  • Exemplo: /painel
• /say - Fazer o bot enviar uma mensagem (suporta templates e JSON).
  • Requer: Gerenciar Mensagens
  • Opções: mensagem (obrigatório; texto simples ou JSON { "content": "...", "embeds": [...] }), canal (opcional)
  • Exemplo (texto): /say mensagem:"Olá!" canal:#anuncios
  • Exemplo (JSON): /say mensagem:"{\"content\":\"Olá\"}"
• /ticket - Configurar o sistema de tickets.
  • Requer: Gerenciar Servidor
  • Subcomandos:
    • setup - Opções: canal (obrigatório), categoria (opcional), log (opcional), cargo_suporte (opcional), ativar (opcional)
      • Exemplo: /ticket setup canal:#tickets categoria:"Suporte" log:#logs cargo_suporte:@Suporte ativar:true
• /config - Configurar módulos do servidor.
  • Requer: Gerenciar Servidor
  • Grupos de subcomandos:
    • channels - Definir/limpar canais (modlog, boas-vindas, saída, anúncio, sorteio)
      • Exemplo: /config channels modlog canal:#modlog
    • templates - Definir/limpar templates (boas-vindas, saída, modlog)
      • Exemplo: /config templates welcome template:"Bem-vindo {user.mention}!"
    • automod - Configurar filtros (palavras, links, caps, domínios, limites de aviso)
      • Exemplo: /config automod link ativar:true block_all:false acao:delete
    • xp - Configurar ativação e parâmetros de XP
      • Exemplo: /config xp enabled ativar:true
• /reactionroles - Gerenciar painéis de reaction roles.
  • Requer: Gerenciar Servidor
  • Subcomandos: create, list, show, publish, delete, add-item, remove-item, set, sync
  • Exemplo (criar): /reactionroles create name:"Cargos" role:@Cargo mode:multiple enabled:true
  • Exemplo (publicar): /reactionroles publish panel_id:<id> channel:#cargos
• /evento - Eventos e lembretes do servidor.
  • Requer: Gerenciar Servidor
  • Subcomandos:
    • criar - Opções: titulo (obrigatório), data_hora (obrigatório), canal (obrigatório), descricao (opcional)
      • Exemplo: /evento criar titulo:"Noite de Filme" data_hora:"2026-01-03 20:00" canal:#anuncios descricao:"Sessão do filme"
    • listar - Sem opções
      • Exemplo: /evento listar
    • cancelar - Opções: event_id (obrigatório)

• /sorteio - Gerenciar sorteios baseados em reações.
  • Requer: Gerenciar Servidor
  • Subcomandos:
    • criar - Opções: titulo, descricao, vencedores (1-20), duracao (1h, 3d, 1w), canal (opcional), cargo (opcional)
      • Exemplo: /sorteio criar titulo:"Nitro" descricao:"Boa sorte" vencedores:1 duracao:3d
    • finalizar - Opções: id
      • Exemplo: /sorteio finalizar id:abc123
    • reroll - Opções: id
      • Exemplo: /sorteio reroll id:abc123
• /sorteio-lista - Sorteio com lista de itens e escolha de preferência.
  • Requer: Gerenciar Servidor
  • Opções: titulo, descricao, itens, vencedores (1-50), duracao, min-escolhas (opcional), max-escolhas (opcional), canal (opcional), cargo-obrigatorio (opcional)
  • Exemplo: /sorteio-lista titulo:"Skins" descricao:"Escolha" itens:"A,B,C" vencedores:2 duracao:2d
• /sorteio-wizard - Assistente passo a passo para criação de sorteios.
  • Requer: Gerenciar Servidor
  • Exemplo: /sorteio-wizard

• /rank - Exibir ranking de XP.
  • Opções: global (opcional), usuario (opcional)
  • Exemplo: /rank usuario:@User
• /leaderboard - Exibir lista dos melhores em XP.
  • Opções: global (opcional), limite (opcional, 1-25)
  • Exemplo: /leaderboard limite:10

• /profile (pt-BR: /perfil) - Exibir o perfil e os emblemas visíveis de um usuário.
  • Opções: usuario (opcional)
  • Exemplo: /profile usuario:@User
• /badges - Listar e gerenciar emblemas.
  • Subcomandos:
    • list (pt-BR: listar) - Opções: usuario (opcional)
      • Exemplo: /badges list usuario:@User
    • grant (pt-BR: conceder) - Somente administradores. Opções: usuario (obrigatório), badge (obrigatório)
      • Exemplo: /badges grant usuario:@User badge:early_supporter
    • revoke (pt-BR: remover) - Somente administradores. Opções: usuario (obrigatório), badge (obrigatório)
      • Exemplo: /badges revoke usuario:@User badge:early_supporter
    • holders - Somente administradores. Opções: badge (obrigatório), limite (opcional), offset (opcional)
      • Exemplo: /badges holders badge:early_supporter limite:10 offset:0

• /fanart - Enviar e revisar fan arts.
  • Subcomandos:
    • submit (pt-BR: enviar) - Opções: imagem (obrigatório), titulo (opcional), descricao (opcional), tags (opcional)
      • Exemplo: /fanart submit imagem:<upload> titulo:"minha arte" tags:"yue,fanart"
    • review (pt-BR: revisar) - Somente revisores. Opções: id (obrigatório), status (obrigatório: approved|rejected), nota (opcional)
      • Exemplo: /fanart review id:fa_123 status:approved nota:"ótimo"

• /luazinhas - Saldo e transferências.
  • Subcomandos:
    • saldo - Opções: usuario (opcional)
      • Exemplo: /luazinhas saldo
    • transferir - Opções: usuario (obrigatório), quantia (obrigatório), motivo (opcional)
      • Exemplo: /luazinhas transferir usuario:@User quantia:100 motivo:"presente"
    • admin_add - Somente dono. Opções: usuario (obrigatório), quantia (obrigatório), motivo (opcional)
    • admin_remove - Somente dono. Opções: usuario (obrigatório), quantia (obrigatório), motivo (opcional)

• /coinflip - Cara ou coroa.
  • Subcomandos:
    • flip - Sem opções.
      • Exemplo: /coinflip flip
    • bet - Opções: usuario (obrigatório), quantia (obrigatório), lado (obrigatório: heads|tails)
      • Exemplo: /coinflip bet usuario:@User quantia:250 lado:heads
    • stats - Opções: usuario (opcional)
      • Exemplo: /coinflip stats usuario:@User
    • info - Sem opções.

• /waifu - Sortear uma waifu (reivindicar pelo botão).
• /husbando - Sortear um husbando (reivindicar pelo botão).
• /casar - Sortear um personagem (reivindicar pelo botão).
  • Opções: genero (opcional: any|female|male)
  • Exemplo: /casar genero:female
• /marry - Alias de /casar (mesmas opções).
• /reroll - Refazer o último sorteio no canal atual (sujeito a cooldown).
• /meuharem - Exibir seu harém.
  • Opções: pagina (opcional)
  • Exemplo: /meuharem pagina:2
• /harem - Alias de /meuharem.
• /divorciar - Divorciar um personagem do seu harém.
  • Opções: nome (obrigatório)
  • Exemplo: /divorciar nome:"Asuna"
• /divorce - Alias de /divorciar.
• /infocasamento - Exibir informações do personagem e quem o possui no servidor.
  • Opções: nome (obrigatório)
• /desejos - Gerenciamento de lista de desejos.
  • Subcomandos: adicionar, remover, listar
  • Exemplo: /desejos adicionar nome:"Asuna"
• /wishlist - Alias de /desejos.
• /waifupontos - Sistema de pontos.
  • Subcomandos: meu, rank (opção: pagina)

• /verificarmensagem - Verificar a imagem de uma mensagem autenticada.
  • Subcomandos:
    • url - Opções: url (obrigatório), json (opcional)
    • arquivo - Opções: arquivo (obrigatório), json (opcional)

Disponível em Apps no menu de contexto da mensagem:

• Salvar mensagem (Enviar aqui) - Gera uma imagem assinada da mensagem e responde no canal.
• Salvar mensagem (Enviar na DM) - Gera uma imagem assinada da mensagem e a envia por DM.

• /anime - Busca e recomendações.
  • Subcomandos:
    • search (pt-BR: buscar) - Opções: titulo (obrigatório), tipo (opcional: anime|manga)
      • Exemplo: /anime search titulo:"Fullmetal Alchemist" tipo:anime
    • trending - Opções: tipo (opcional: anime|manga), quantidade (opcional, 1-10)
      • Exemplo: /anime trending tipo:anime quantidade:5
    • recommend (pt-BR: recomendar) - Opções: genero (obrigatório), tipo (opcional), quantidade (opcional, 1-10)
      • Exemplo: /anime recommend genero:"Romance" tipo:anime quantidade:10
  • Grupo de subcomandos watchlist:
    • add/remove/list - Gerenciar lista de acompanhamento do usuário
      • Exemplo: /anime watchlist add titulo:"Frieren" tipo:anime
    • dm - Ativar/desativar lembretes por DM
      • Exemplo: /anime watchlist dm ativar:true
    • channel-set/channel-clear - Configurar canal de lembretes para o servidor atual

• /loja - Comprar itens usando luazinhas.
  • Subcomandos:
    • listar - Sem opções
      • Exemplo: /loja listar
    • comprar - Opções: item_id (obrigatório), quantidade (opcional), motivo (opcional)
      • Exemplo: /loja comprar item_id:<id> quantidade:1 motivo:"boost"
    • admin_criar - Somente administradores. Criar/ativar itens da loja
• /inventario - Gerenciar itens do inventário.
  • Subcomandos:
    • listar - Sem opções
      • Exemplo: /inventario listar
    • usar - Opções: item_id (obrigatório)
      • Exemplo: /inventario usar item_id:<id>