Documentação

Guia da Hikari

Tudo o que cada módulo faz, como configurá-lo e a lista completa de comandos.

✦Primeiros passos

Clique em Adicionar bot, escolha o servidor e autorize as permissões pedidas.
Garanta que o cargo da Hikari fique acima dos cargos que ela vai moderar.
Entre no Dashboard com o Discord para configurar os módulos.
Use /status para conferir se tudo está funcionando.

◉Dashboard

O acesso exige login com o Discord. Você vê todos os servidores em que é administrador e pode alternar entre eles a qualquer momento pelo seletor Servidor — não há limite de servidores.

O sub-menu lateral leva a cada módulo: Membros, Moderação e denúncias, Tickets, XP e níveis, Automoderação, Anti-raid, Auditoria, Relatórios, Moderação IA, Laboratório e Configurações. O menu principal continua no topo.

⚑Moderação

Punições registradas com motivo, autor e duração. Tudo fica no histórico do membro e na Auditoria.

/warn

Advertir um membro com um motivo.

/mute

Silenciar um membro (timeout) por um tempo definido.

/unmute

Remover o silenciamento de um membro.

/kick

Expulsar um membro do servidor.

/ban

Banir um usuário por 1 dia, 7 dias, 30 dias ou permanentemente.

/unban

Remover o banimento de um usuário.

/historico

Ver o histórico de punições de um usuário.

Configurações

Opção	O que faz
Canal de logs	Onde cada punição é registrada.
Cargos de moderação	Quem pode usar os comandos de moderação.
Aviso por mensagem privada	Avisa o membro quando ele é punido.

🔒Trancamento

Tranca a escrita, a criação de tópicos públicos e privados e as reações com emoji. Antes de trancar, a Hikari salva as permissões antigas; ao destrancar, elas voltam exatamente como eram, sem mudar nada além disso.

/lock NOVO

Tranca o canal atual (ou o canal escolhido). Bloqueia mensagens, tópicos públicos, tópicos privados e reações.

/unlock NOVO

Destranca o canal e restaura as permissões salvas pelo /lock.

/lockdown NOVO

Tranca todos os canais do servidor de uma vez, com os mesmos bloqueios do /lock.

/unlockdown NOVO

Destranca todos os canais e restaura as permissões salvas pelo /lockdown.

Dica: se um canal já estava trancado por /lock, o /unlockdown mantém ele trancado — cada comando só desfaz o que ele mesmo fez.

⚠Denúncias

Membros denunciam pelo comando; a equipe acompanha pelo Dashboard com os status Aberta, Em revisão, Resolvida e Arquivada.

/denunciar

Denunciar um membro para a equipe (categorias: Spam, Links suspeitos, Outros).

✉Tickets

Canais privados de atendimento abertos por um painel com botão. Cada ticket tem prioridade, estado e atendente responsável.

/ticket adicionar

Adicionar uma pessoa ao ticket.

/ticket remover

Remover uma pessoa do ticket.

/ticket transferir

Passar o ticket para outro atendente.

/ticket prioridade

Mudar a prioridade: Baixa, Normal, Alta ou Urgente.

/ticket estado

Marcar como Em atendimento ou Aguardando resposta.

/ticket resposta

Enviar uma resposta rápida pronta.

Configurações

Opção	O que faz
Categoria dos tickets	Onde os canais de atendimento são criados.
Cargos de atendimento	Quem vê e responde os tickets.
Respostas rápidas	Mensagens prontas para o /ticket resposta.

★XP e níveis

Membros ganham XP ao conversar. Níveis podem dar cargos automaticamente.

/rank

Mostra seu nível, posição, XP e progresso (ou de outro membro).

/top

Ranking de XP do servidor.

Configurações

Opção	O que faz
XP por mensagem e intervalo	Quanto XP cada mensagem vale e o tempo mínimo entre ganhos.
Canais e cargos ignorados	Onde não se ganha XP.
Recompensas por nível	Cargos entregues ao alcançar cada nível.

⚙Automoderação

Regras que agem sozinhas contra spam, links suspeitos, menções em massa e palavras proibidas. Cada regra define a ação (apagar, avisar, silenciar) e as exceções de canais e cargos. Configurada pelo Dashboard.

⛨Anti-raid

Monitora entradas em massa. Quando o limite é passado, ativa a contenção automaticamente e avisa a equipe.

/antiraid status

Mostra o estado atual da proteção.

/antiraid contencao

Ativar ou encerrar a contenção manualmente.

☰Auditoria e relatórios

Toda ação da equipe e do painel fica registrada na Auditoria. Os Relatórios mostram gráficos de punições, denúncias, tickets e atividade ao longo do tempo.

🛡Moderação IA

O módulo Moderation Intelligence reúne sinais de spam, flood e possível evasão em ocorrências com evidências, contexto e recomendações. A análise é assistiva e pode errar; a equipe acompanha e revisa cada ocorrência.

Abas do painel

Aba	Conteúdo
Ocorrências	Filtros por estado, categoria, gravidade e usuário; evidências, avaliação da IA, histórico e linha do tempo. Permite marcar em revisão, confirmar, descartar e reabrir.
Resumos de 30 min	Resumos históricos por período, categoria, gravidade e estado. Alertas importantes chegam ao Discord sem esperar a consolidação.
Configuração	Ativação por servidor, canal de alertas, regras, limites de detecção, canais e cargos ignorados, consentimento para IA, retenção de evidências e política de reincidência.
Estado	Último batimento do ciclo de detecção, disponibilidade da IA, chamadas recentes e erros registrados.

Proteções e automação

O padrão é apenas recomendar. A IA exige consentimento para enviar o texto das evidências ao provedor. A execução automática exige aceite separado e só permite advertência ou timeout dentro dos limites configurados, nunca expulsão ou banimento.

A recomendação final é a mais branda entre a sugestão da IA e a política de reincidência. Sem texto capturado, a automação não executa. O módulo mantém limites diários, intervalo por usuário e disjuntor por falsos positivos.

Aplicar uma recomendação é feito pelos botões do alerta no Discord ou pelos comandos de moderação existentes. Este módulo não adiciona comandos de barra próprios.

Abrir Moderação IA

⚗Laboratório

Recursos avançados em teste: investigação de incidentes com exportação de evidências, controle de vários servidores ao mesmo tempo (Frota) e simulação de regras antes de aplicar.

◎Sistema

/ping

Latência do bot e do banco de dados.

/status

Status geral: tempo ligado, servidores, conexão e banco.

⌘Todos os comandos

Comando	Módulo
/warn · /mute · /unmute · /kick · /ban · /unban · /historico	Moderação
/lock · /unlock · /lockdown · /unlockdown	Trancamento
/denunciar	Denúncias
/ticket adicionar · remover · transferir · prioridade · estado · resposta	Tickets
/rank · /top	XP e níveis
/antiraid status · contencao	Anti-raid
/ping · /status	Sistema