Ir para o conteúdo principal

Documentação

Os 51 comandos do bot: sintaxe, opções, permissões e exemplos.

Primeiros passos

Três minutos de leitura que tornam óbvio todo o resto desta página.

Ler uma sintaxe

Todos os comandos são comandos de barra: você digita / no Discord, a lista aparece, e o Discord o guia opção por opção. Nesta página, a sintaxe se lê assim:

  • <opção>: obrigatória, o comando não roda sem ela.
  • [opção]: opcional: tem um valor padrão ou simplesmente não tem efeito.
  • /comando subcomando: os comandos mais ricos são divididos em subcomandos.

Os nomes mostrados aqui são os que o bot usa neste idioma. Ele fala treze, e a tradução vai até o nome dos comandos e de suas opções: depois de um /idioma, /ban usuário: vira /ban user: em inglês.

Quem pode usar o quê

Dois caminhos levam a um comando, e basta seguir um deles:

  • A permissão do Discord indicada no cabeçalho de cada comando. Os administradores e o dono do servidor têm todas.
  • Um cargo de staff de nível suficiente, apenas para os comandos de moderação. É o que permite confiar /warn a uma equipe sem lhe dar o direito de silenciar membros no Discord.

Existem três níveis de staff, associados a cargos do seu servidor com /staff. Cada comando de moderação exige um nível mínimo, ajustável um a um:

NívelComandos abertos por padrão
Nível 1 /clear /timeout /warn /history /sanction /note /slowmode
Nível 2 /kick /ban /tempban /massmove /unwarn /lock /unlock /role
Nível 3 /unban

O nível que vale para um membro é o do seu cargo de staff mais alto. Esses níveis abrem o acesso: nunca tiram um direito de quem já tem a permissão do Discord correspondente.

Os códigos de sanção

Cada sanção aplicada pelo bot (banimento, expulsão, castigo, advertência) recebe um código público único de doze caracteres, do tipo K7Q2M9XAP4RN. Nem I, nem L, nem O, nem 0, nem 1: o código se dita em voz alta sem ambiguidade.

Esse código é a chave de todo o resto: /sanction para a ficha, /note para anexar-lhe um comentário interno, /unwarn para revogá-la. Ele aparece na mensagem privada enviada ao membro, na confirmação recebida pelo moderador e no canal de registros.

Opções comuns aos comandos de moderação

  • motivo: repetido no MP ao membro, no registro de auditoria do Discord e no histórico.
  • mp: avisar o membro ou não. Padrão: sim.
  • visibilidade: tornar a confirmação visível no canal. Padrão: não, só o moderador a vê.

Intervalo entre dois usos

Cada comando impõe um curto intervalo por membro, indicado no seu cabeçalho (de 2 a 10 segundos conforme o custo da operação). Ele protege o bot de um descontrole; nunca se aplica de um membro a outro.

Site ou Discord?

Tanto faz. O painel e os comandos escrevem no mesmo banco de dados: um ajuste feito por comando aparece imediatamente no site, e uma alteração feita no site é adotada pelo bot sem reinício. Os comandos de configuração mais ricos (/welcome, /logs, /ticket, /staff) aliás abrem um painel interativo em vez de multiplicar as opções.

Os sistemas

O que os módulos fazem depois de ativados: o detalhe que a ficha de um comando não consegue conter.

Níveis e experiência

Cada mensagem escrita num canal rende entre 15 e 25 XP, sorteados ao acaso. Só se conta um ganho por minuto e por membro: escrever dez mensagens seguidas não rende mais do que uma só. Os bots, as mensagens privadas e as mensagens de sistema (entradas, fixações) não rendem nada.

Passar do nível L para o seguinte custa 5 × L² + 50 × L + 100 XP. O custo sobe, portanto, a cada patamar, e só o XP total é guardado: o nível é deduzido dele.

PatamarXP totalCusto do nívelOrdem de grandeza
Nível 1 100 XP 100 XP ≈ 5 mensagens
Nível 2 255 XP 155 XP ≈ 13 mensagens
Nível 5 1.150 XP 380 XP ≈ 58 mensagens
Nível 10 4.675 XP 955 XP ≈ 234 mensagens
Nível 20 23.850 XP 2.855 XP ≈ 1.193 mensagens
Nível 50 268.375 XP 14.555 XP ≈ 13.419 mensagens

A última coluna supõe uma conversa comum, com o ganho médio. Ela dá a ordem de grandeza, o tempo real depende do espaçamento das mensagens, já que o contador só retém um ganho por minuto.

A cada subida de nível, o bot responde no canal onde a mensagem foi escrita. O anúncio se ajusta pelo painel: embed ou texto simples, título, descrição, cor, e as variáveis {level} e {xp} além das habituais. Um canal em que o bot não pode escrever não bloqueia nada: o nível é conquistado, só o anúncio é abandonado.

O módulo está ativo por padrão. Desligá-lo interrompe os ganhos e os anúncios sem apagar nada: a classificação permanece no banco e volta intacta quando for reativado. Para corrigir um caso pontual, /xp adiciona, retira ou fixa o XP de um membro; /rank e /leaderboard mostram o resultado.

Sanções, histórico e notas

Toda sanção aplicada pelo bot é registrada: banimento, banimento temporário, expulsão, castigo, advertência, e até as revogações (desbanimento, retirada de advertência). Cada uma recebe seu código de doze caracteres.

A ordem das operações não é casual. A mensagem privada sai antes da sanção, depois de um banimento, o bot não tem mais servidor em comum com a pessoa e não poderia escrever para ela. Já o registro precede a chamada ao Discord para dispor do código; se o Discord recusar a ação, o registro é anulado, e nenhuma sanção fantasma fica no dossiê.

Um banimento temporário programa a própria revogação. No vencimento, o bot verifica se um moderador não reaplicou o banimento nesse meio-tempo: se for o caso, ele não o revoga. Um /ban definitivo aplicado durante o prazo anula a revogação programada.

As notas (/note, 25 por sanção) nunca são mostradas ao membro em questão: servem ao diálogo entre moderadores, meses depois, quando ninguém se lembra do contexto.

Proteção na entrada

Três mecanismos independentes, que se somam ou se usam sozinhos:

  • O captcha: ao chegar, o membro deve resolver um desafio para obter seu cargo. Por padrão: 3 tentativas, 5 minutos, expulsão em caso de falha. O pedido passa por mensagem privada; se o membro fechou as suas, o bot cria um canal de verificação temporário na categoria que você indicou, visível só para ele e apagado depois.
  • A verificação pelo site: o membro clica num botão, termina no site e recupera seu cargo na volta. Aqui o bot não concede nada por conta própria: é o site que verifica a identidade junto ao Discord e depois atribui o cargo.
  • O anti-raid: não mira o indivíduo, mas o fluxo. Acima de 8 entradas em 10 segundos (valores padrão), ele alerta, coloca em quarentena ou expulsa. O filtro de idade da conta deixa passar os habituais apanhados na onda.

O cargo de quarentena é o ponto comum dos três: colocado na chegada, ele limita o que o recém-chegado pode ver e fazer, e é retirado depois da verificação. Enquanto ele estiver lá, você mantém o controle, nada impede desbloquear alguém à mão.

Tickets

Um painel publicado num canal, no máximo 25 tipos de pedido (o limite de um menu suspenso do Discord), e para cada um: seu emoji, sua cor, sua mensagem de boas-vindas, seu formulário de abertura e a equipe que tem acesso. A abertura cria um canal privado entre quem pede e essa equipe. No fechamento, a conversa é arquivada em HTML no canal de arquivos, a troca continua consultável depois que o canal é apagado.

Música e cargos DJ

A reprodução se apoia numa infraestrutura de áudio dedicada. Se ela estiver indisponível, os comandos de música dizem isso e todo o resto do bot continua funcionando.

Os comandos que controlam uma reprodução em curso (/pause, /resume, /stop, /loop, /volume) são reservados aos DJs. É DJ: o dono do servidor, um administrador, um membro com “Gerenciar servidor”, ou um membro que tenha um cargo adicionado por /dj add. Enquanto nenhum cargo DJ estiver configurado, esses comandos respondem portanto apenas a esses três perfis. Os cargos de staff são uma lista distinta: não concedem o status de DJ.

Os comandos de consulta (/queue, /nowplaying, /lyrics) e a adição de faixas (/play) continuam abertos a todos.

Sorteios

Duração aceita: de 10 segundos a 28 dias, escrita livremente (30m, 1h30m, 2d). Até 20 sorteios em curso e 20 vencedores por sorteio.

O sorteio é sempre feito pelo bot, nunca pelo site: só ele pode verificar, no momento do sorteio, que os vencedores ainda estão no servidor e têm o cargo exigido na inscrição. Se ninguém se manifestar, /giveaway reroll sorteia de novo.

Registros

21 tipos de eventos, repartidos em 5 categorias (Mensagens, Membros, Moderação, Voz, Servidor), ativáveis um a um. Cada categoria pode apontar para seu próprio canal: a moderação de um lado, as mensagens do outro.

O conteúdo das mensagens nunca é armazenado no banco. Quando uma mensagem é apagada, o bot publica um embed no canal que você indicou, é tudo o que acontece. Uma ação feita pelo próprio bot (um banimento via /ban) é registrada uma única vez, pelo registro de moderação que nomeia o moderador.

Backups

Um backup fotografa a estrutura do servidor (cargos, canais, permissões) e devolve um código privado, enviado por mensagem privada. São mantidos 3 backups por dono. Ele não contém nenhuma mensagem: não é um histórico de conversa. O código permite restaurar essa estrutura no servidor atual, e portanto também clonar um servidor importando-o em outro lugar.

Canais de voz temporários

Entrar no canal de disparo cria um canal do qual o membro é dono: ele pode renomeá-lo, limitar seu acesso ou fixar sua capacidade. O canal desaparece assim que se esvazia, nada a limpar.

Moderação

Sancionar, deixar rastro, voltar atrás. Cada sanção aplicada por um destes comandos recebe um código público e entra no histórico do membro.

16 comandos

/ban

Banir membros Staff nível 2 3 s Bot: Banir membros

Bane um membro do servidor.

Banimento definitivo. O membro é retirado do servidor e não pode voltar enquanto não for desbanido.

/ban <usuário> [motivo] [mp] [visibilidade]

OpçãoTipoExigidaDescrição
usuário membro obrigatória O usuário alvo.
motivo texto opcional O motivo desta ação.no máximo 400 caracteres
mp texto opcional Enviar uma DM ao usuário (padrão: sim).Escolhas: ✅ Sim, ❌ Não
visibilidade texto opcional Tornar a confirmação visível para todos (padrão: não).Escolhas: ✅ Sim, ❌ Não
  • A mensagem privada sai antes do banimento: uma vez banido, o bot não tem mais servidor em comum com o membro e não conseguiria falar com ele.
  • A sanção é registrada antes da chamada ao Discord. Se o banimento falhar (hierarquia de cargos, permissão faltando), o registro é anulado: nenhuma sanção fantasma fica no histórico.
  • Um banimento definitivo anula o desbanimento automático eventualmente programado por /tempban.
  • Você não pode banir a si mesmo, nem o bot, nem um membro cujo cargo mais alto seja superior ou igual ao seu.

Exemplos

/ban usuário:@kylian_ motivo:Divulgação repetida

Banimento com motivo, MP enviado, confirmação privada.

/ban usuário:@kylian_ mp:❌ Não visibilidade:✅ Sim

Sem avisar o membro, mas com uma confirmação visível no canal.

/tempban

Banir membros Staff nível 2 3 s Bot: Banir membros

Banir temporariamente um membro (desban automático ao expirar)

Banimento por prazo determinado. O desbanimento é programado e executado pelo bot no vencimento.

/tempban <usuário> <duração> [motivo] [mp] [visibilidade]

OpçãoTipoExigidaDescrição
usuário membro obrigatória O usuário alvo.
duração texto obrigatória A duração do castigo.Escolhas: 60 segundos, 5 minutos, 10 minutos, 30 minutos, 1 hora, 3 horas, 12 horas, 1 dia, 3 dias, 1 semana, 28 dias
motivo texto opcional O motivo desta ação.no máximo 400 caracteres
mp texto opcional Enviar uma DM ao usuário (padrão: sim).Escolhas: ✅ Sim, ❌ Não
visibilidade texto opcional Tornar a confirmação visível para todos (padrão: não).Escolhas: ✅ Sim, ❌ Não
  • No vencimento, o bot verifica se um moderador não reaplicou o banimento nesse meio-tempo: se for o caso, ele não o revoga.
  • Um /ban aplicado durante o prazo anula o desbanimento automático.

Exemplos

/tempban usuário:@kylian_ duração:1 semana motivo:Spam

Reintegração automática daqui a uma semana.

/unban

Banir membros Staff nível 3 3 s Bot: Banir membros

Desbane um usuário pelo seu identificador.

Revoga um banimento. Como a pessoa não está mais no servidor, ela é indicada pelo seu ID do Discord.

/unban <id>

OpçãoTipoExigidaDescrição
id texto obrigatória O ID do Discord do usuário banido a desbanir.no máximo 20 caracteres
  • O ID se copia da lista de banidos do Discord (Configurações do servidor → Banimentos), com o modo desenvolvedor ativado.
  • É o único comando de moderação cujo nível de staff padrão é 3.

Exemplos

/unban id:428917364520394752

/kick

Expulsar membros Staff nível 2 3 s Bot: Expulsar membros

Expulsa um membro do servidor.

Expulsa um membro. Nada o impede de voltar com um novo convite.

/kick <usuário> [motivo] [mp] [visibilidade]

OpçãoTipoExigidaDescrição
usuário membro obrigatória O usuário alvo.
motivo texto opcional O motivo desta ação.no máximo 400 caracteres
mp texto opcional Enviar uma DM ao usuário (padrão: sim).Escolhas: ✅ Sim, ❌ Não
visibilidade texto opcional Tornar a confirmação visível para todos (padrão: não).Escolhas: ✅ Sim, ❌ Não
  • A mensagem privada sai antes da expulsão, pela mesma razão do /ban.

Exemplos

/kick usuário:@marin motivo:Provocação na voz

/timeout

Castigar membros Staff nível 1 3 s Bot: Castigar membros

Silencia temporariamente um membro.

Castigo temporário nativo do Discord: o membro continua no servidor mas não pode mais escrever, reagir nem falar na voz.

/timeout <usuário> <duração> [motivo] [mp] [visibilidade]

OpçãoTipoExigidaDescrição
usuário membro obrigatória O usuário alvo.
duração texto obrigatória A duração do castigo.Escolhas: 60 segundos, 5 minutos, 10 minutos, 30 minutos, 1 hora, 3 horas, 12 horas, 1 dia, 3 dias, 1 semana, 28 dias
motivo texto opcional O motivo desta ação.no máximo 400 caracteres
mp texto opcional Enviar uma DM ao usuário (padrão: sim).Escolhas: ✅ Sim, ❌ Não
visibilidade texto opcional Tornar a confirmação visível para todos (padrão: não).Escolhas: ✅ Sim, ❌ Não
  • A duração máxima é de 28 dias: é um limite do Discord, não do bot.
  • O castigo se encerra sozinho no vencimento, sem intervenção do bot.

Exemplos

/timeout usuário:@marin duração:1 hora motivo:Insultos

/warn

Castigar membros Staff nível 1 3 s

Adverte um membro.

Advertência registrada. Nenhuma sanção técnica é aplicada: é um rastro, consultável depois.

/warn <usuário> [motivo] [mp] [visibilidade]

OpçãoTipoExigidaDescrição
usuário membro obrigatória O usuário alvo.
motivo texto opcional O motivo desta ação.no máximo 400 caracteres
mp texto opcional Enviar uma DM ao usuário (padrão: sim).Escolhas: ✅ Sim, ❌ Não
visibilidade texto opcional Tornar a confirmação visível para todos (padrão: não).Escolhas: ✅ Sim, ❌ Não
  • A advertência recebe um código de sanção como qualquer outra entrada: aparece com /history ou /sanction, e se revoga com /unwarn.

Exemplos

/warn usuário:@marin motivo:Segundo aviso sobre a linguagem

/unwarn

Castigar membros Staff nível 2 3 s

Revogar uma advertência pelo seu código

Revoga uma advertência específica a partir do seu código.

/unwarn <id>

OpçãoTipoExigidaDescrição
id texto obrigatória O identificador da sanção (ex.: K7Q2M9XA).no máximo 16 caracteres
  • A revogação não faz a entrada sumir do histórico: marca-a como revogada.

Exemplos

/unwarn id:K7Q2M9XAP4RN

/history

Castigar membros Staff nível 1 3 s

Mostra todas as sanções de um membro.

Dossiê completo de um membro: todas as suas sanções, da mais recente à mais antiga.

/history <usuário>

OpçãoTipoExigidaDescrição
usuário membro obrigatória O usuário alvo.
  • A lista se percorre página por página com os botões da mensagem; cada entrada mostra seu código, seu tipo, seu motivo e seu autor.

Exemplos

/history usuário:@kylian_

/sanction

Castigar membros Staff nível 1 3 s

Mostra os detalhes de uma sanção pelo seu identificador.

Ficha detalhada de uma sanção: tipo, motivo, moderador, data, notas internas anexadas.

/sanction <id>

OpçãoTipoExigidaDescrição
id texto obrigatória O identificador da sanção (ex.: K7Q2M9XA).no máximo 16 caracteres

Exemplos

/sanction id:K7Q2M9XAP4RN

/note

Castigar membros Staff nível 1 3 s

Gerencia as notas associadas a uma sanção.

Notas internas anexadas a uma sanção. Nunca são mostradas ao membro em questão: servem ao diálogo entre moderadores.

/note add <id> <texto>

Adiciona uma nota a uma sanção.

OpçãoTipoExigidaDescrição
id texto obrigatória O identificador da sanção (ex.: K7Q2M9XA).no máximo 16 caracteres
texto texto obrigatória O conteúdo da nota.no máximo 1000 caracteres

/note list <id>

Mostra as notas de uma sanção.

OpçãoTipoExigidaDescrição
id texto obrigatória O identificador da sanção (ex.: K7Q2M9XA).no máximo 16 caracteres

/note remove <id> <número>

Remove uma nota de uma sanção.

OpçãoTipoExigidaDescrição
id texto obrigatória O identificador da sanção (ex.: K7Q2M9XA).no máximo 16 caracteres
número número inteiro obrigatória A posição da nota na lista (ver /note list).Mínimo 1
  • Até 25 notas por sanção. Além disso, a ficha ultrapassaria o tamanho máximo de uma mensagem do Discord.

Exemplos

/note add id:K7Q2M9XAP4RN texto:Admitiu os fatos no MP

/note remove id:K7Q2M9XAP4RN número:2

O número é a posição mostrada por /note list.

/clear

Gerenciar mensagens Staff nível 1 3 s Bot: Gerenciar mensagens

Apaga um número de mensagens.

Apaga de uma vez as últimas mensagens de um canal.

/clear <quantidade>

OpçãoTipoExigidaDescrição
quantidade número inteiro obrigatória Número de mensagens a apagar (1-100).De 1 a 100
  • O Discord recusa a exclusão em massa de mensagens com mais de 14 dias: essas são ignoradas, e o bot informa quantas foram realmente apagadas.
  • A exclusão é atribuída ao moderador nos registros, e não ao autor das mensagens.

Exemplos

/clear quantidade:50

/slowmode

Gerenciar canais Staff nível 1 3 s Bot: Gerenciar canais

Define o modo lento de um canal.

Impõe um intervalo mínimo entre duas mensagens de um mesmo membro.

/slowmode <seconds> [channel]

OpçãoTipoExigidaDescrição
seconds número inteiro obrigatória Atraso do modo lento em segundos (0 = desativa).De 0 a 21600
channel canal opcional Canal alvo (padrão: canal atual).Tipo: canal de texto, canal de anúncios
  • 0 desativa o modo lento. O máximo, 21 600 segundos, corresponde às 6 horas permitidas pelo Discord.

Exemplos

/slowmode seconds:30

No canal atual.

/slowmode seconds:0 channel:#geral

Volta ao normal em outro canal.

/lock

Gerenciar canais Staff nível 2 3 s Bot: Gerenciar canais

Bloqueia um canal (membros não podem enviar mensagens).

Retira do cargo @everyone o direito de escrever no canal. As mensagens continuam legíveis.

/lock [channel] [motivo]

OpçãoTipoExigidaDescrição
channel canal opcional Canal alvo (padrão: canal atual).Tipo: canal de texto, canal de anúncios
motivo texto opcional O motivo desta ação.no máximo 400 caracteres

Exemplos

/lock motivo:Debate saindo do controle, seguimos amanhã

/unlock

Gerenciar canais Staff nível 2 3 s Bot: Gerenciar canais

Desbloqueia um canal previamente bloqueado.

Devolve a palavra ao canal bloqueado.

/unlock [channel] [motivo]

OpçãoTipoExigidaDescrição
channel canal opcional Canal alvo (padrão: canal atual).Tipo: canal de texto, canal de anúncios
motivo texto opcional O motivo desta ação.no máximo 400 caracteres

Exemplos

/unlock channel:#geral

/role

Gerenciar cargos Staff nível 2 3 s Bot: Gerenciar cargos

Adiciona ou remove um cargo de um membro.

Adiciona ou retira um cargo sem passar pelas configurações do servidor.

/role add <usuário> <role>

Adiciona um cargo a um membro.

OpçãoTipoExigidaDescrição
usuário membro obrigatória O usuário alvo.
role cargo obrigatória O cargo a adicionar ou remover.

/role remove <usuário> <role>

Remove um cargo de um membro.

OpçãoTipoExigidaDescrição
usuário membro obrigatória O usuário alvo.
role cargo obrigatória O cargo a adicionar ou remover.
  • O bot só pode manipular os cargos situados abaixo do seu na hierarquia.
  • Você nunca distribui um cargo acima do seu. E se estiver passando por um nível de staff em vez da permissão “Gerenciar cargos”, os cargos com uma permissão sensível (Administrador, Gerenciar cargos, Banir membros...) são recusados: uma dispensa nunca vale mais do que a permissão que substitui.

Exemplos

/role add usuário:@sofia role:@Membro confirmado

/massmove

Mover membros Staff nível 2 5 s Bot: Mover membros

Move todos de um canal de voz para outro.

Move de uma só vez todos os membros presentes num canal de voz.

/massmove <origem> <destino> [visibilidade]

OpçãoTipoExigidaDescrição
origem canal obrigatória O canal de voz de onde mover todos.Tipo: canal de voz, canal de palco
destino canal obrigatória O canal de voz para onde mover todos.Tipo: canal de voz, canal de palco
visibilidade texto opcional Tornar a confirmação visível para todos (padrão: não).Escolhas: ✅ Sim, ❌ Não
  • Útil para reunir um evento, ou para esvaziar um canal de voz sem desconectar ninguém.

Exemplos

/massmove origem:Sala 1 destino:Palco

Configuração

Os módulos do servidor. Todos vêm desligados, e tudo o que se ajusta aqui também se ajusta pelo painel. É o mesmo banco de dados.

15 comandos

/welcome

Gerenciar servidor 3 s Bot: Ver canais, Enviar mensagens, Inserir links

Configurar as mensagens de boas-vindas e de despedida

Abre um painel interativo: mensagem de boas-vindas, mensagem de despedida, canais, banner gerado e cores se ajustam ali, sem subcomandos a decorar.

/welcome

  • Variáveis disponíveis nos textos: {user}, {username}, {displayname}, {tag}, {id}, {server}, {membercount}.
  • A mensagem de despedida é independente da de boas-vindas: canal diferente, ativação diferente.
  • Um banner é gerado a cada chegada, com as cores escolhidas para o servidor.

/logs

Gerenciar servidor 3 s Bot: Ver canais, Enviar mensagens, Inserir links

Configure e personalize o sistema de registros do servidor.

Painel de configuração dos registros: 21 tipos de eventos, ativáveis um a um.

/logs setup

Abre o painel de configuração de registros.

/logs disable

Desativa os registros e limpa a configuração.

  • Os eventos são repartidos em 5 categorias: Mensagens, Membros, Moderação, Voz, Servidor.
  • Cada categoria pode apontar para seu próprio canal: a moderação de um lado, as mensagens do outro.
  • O conteúdo das mensagens nunca é armazenado no banco: aparece no embed publicado, nada mais.
  • /logs disable apaga a configuração, não se limita a pausá-la.

/ticket

Gerenciar servidor 3 s Bot: Gerenciar canais

Configura e personaliza o sistema de tickets.

Painel de configuração do sistema de tickets: tipos, formulários, equipes, transcrições.

/ticket setup

Abre o painel de configuração de tickets.

/ticket disable

Desativa o sistema de tickets e remove o painel.

  • Até 25 tipos de ticket, o limite de um menu suspenso do Discord. Cada um tem seu emoji, sua cor, sua mensagem de boas-vindas e seu formulário de abertura.
  • No fechamento, a conversa é arquivada em HTML no canal de arquivos escolhido.

/verify

Gerenciar servidor 3 s Bot: Gerenciar cargos

Configura a verificação pelo site (botão + cargo).

Verificação pelo site: o membro clica num botão no Discord, termina em omniaze.com e recebe seu cargo na volta.

/verify enable <role> [quarantine] [log]

Ativa a verificação e escolhe o cargo concedido depois.

OpçãoTipoExigidaDescrição
role cargo obrigatória O cargo concedido quando o membro se verifica no site.
quarantine cargo opcional Cargo removido após a verificação (opcional).
log canal opcional Canal onde registrar cada verificação bem-sucedida (opcional).Tipo: canal de texto, canal de anúncios

/verify panel [channel]

Publica (ou atualiza) o painel de verificação e seu botão.

OpçãoTipoExigidaDescrição
channel canal opcional Canal onde publicar o painel de verificação.Tipo: canal de texto, canal de anúncios

/verify disable

Desativa a verificação pelo site neste servidor.

/verify status

Mostra a configuração atual da verificação.

  • O cargo de quarentena é opcional: sem ele, a verificação só adiciona um cargo; com ele, também tira o membro da antessala.
  • /verify panel republica o painel se a mensagem foi apagada, ou o atualiza depois de uma mudança de texto.

Exemplos

/verify enable role:@Membro quarantine:@Não verificado log:#chegadas

/verify panel channel:#verificação

/captcha

Gerenciar servidor 3 s Bot: Gerenciar cargos, Gerenciar canais

Configura o captcha que verifica os novos membros.

Verificação na entrada: o recém-chegado deve resolver um captcha para obter seu cargo.

/captcha enable <cargo> <categoria> [quarentena]

Ativa o captcha e escolhe o cargo de verificação.

OpçãoTipoExigidaDescrição
cargo cargo obrigatória O cargo concedido aos membros após passarem no captcha.
categoria canal obrigatória Categoria onde criar os canais de verificação temporários (DMs fechadas).Tipo: categoria
quarentena cargo opcional Cargo restritivo atribuído ao entrar e removido após o membro se verificar.

/captcha disable

Desativa o captcha neste servidor.

/captcha status

Mostra a configuração atual do captcha.

  • A categoria é obrigatória: se o membro fechou suas mensagens privadas, o bot cria ali um canal de verificação temporário, visível só para ele e apagado depois.
  • Ajustes padrão: 3 tentativas, 5 minutos para responder, expulsão em caso de falha. O prazo, o número de tentativas e a sanção se alteram pelo painel.
  • Enquanto a verificação não for concluída, o membro fica no cargo de quarentena: você mantém a possibilidade de desbloqueá-lo à mão.

Exemplos

/captcha enable cargo:@Membro categoria:Verificação quarentena:@Recém-chegado

/antiraid

Gerenciar servidor 3 s

Configura a proteção anti-raid.

Detecção de uma onda de entradas anormal, e reação automática.

/antiraid enable [threshold] [window] [action] [channel] [quarentena] [criacao-auto]

Ativa o anti-raid e ajusta seus limites.

OpçãoTipoExigidaDescrição
threshold número inteiro opcional Número de entradas que dispara o alerta.De 2 a 50
window número inteiro opcional Janela de detecção em segundos.De 3 a 120
action texto opcional O que fazer com novos membros durante um raid.Escolhas: Apenas alertar, Quarentena, Expulsar
channel canal opcional Canal onde os alertas de raid são enviados.Tipo: canal de texto, canal de anúncios
quarentena cargo opcional Cargo restritivo aplicado a quem entra durante um raid.
criacao-auto sim / não opcional Criar o cargo de quarentena se ainda não houver um.

/antiraid disable

Desativa a proteção anti-raid.

/antiraid status

Mostra a configuração anti-raid atual.

  • Por padrão: 8 entradas em 10 segundos disparam a proteção, e os recém-chegados vão para a quarentena.
  • Três reações possíveis: apenas alertar, colocar em quarentena, ou expulsar.
  • A idade da conta pode servir de filtro (168 horas por padrão): as contas antigas atravessam a onda sem serem incomodadas. Esse ajuste se faz pelo painel.

Exemplos

/antiraid enable threshold:10 window:15 action:Quarentena channel:#alertas

/reactionrole

Gerenciar servidor 3 s Bot: Gerenciar cargos

Cria botões de cargo autoatribuíveis.

Painéis de cargos self-service: uma mensagem, botões, um cargo por botão.

/reactionrole create <channel> [title] [description] [mode] [color]

Cria um novo painel de cargos por reação.

OpçãoTipoExigidaDescrição
channel canal obrigatória Canal onde publicar o painel.Tipo: canal de texto, canal de anúncios
title texto opcional Título do painel.no máximo 256 caracteres
description texto opcional Descrição do painel.no máximo 2000 caracteres
mode texto opcional Acumular (vários cargos) ou único (um cargo por vez).Escolhas: Acumular, Único
color texto opcional Cor do embed (hex, ex.: #5865F2).no máximo 7 caracteres

/reactionrole addrole <panel> <role> [label] [emoji]

Adiciona um botão de cargo a um painel.

OpçãoTipoExigidaDescrição
panel texto obrigatória Qual painel (escolha da lista).
role cargo obrigatória O cargo concedido pelo botão.
label texto opcional Rótulo do botão (padrão: nome do cargo).no máximo 80 caracteres
emoji texto opcional Emoji do botão (opcional).no máximo 40 caracteres

/reactionrole removerole <panel> <role>

Remove um botão de cargo de um painel.

OpçãoTipoExigidaDescrição
panel texto obrigatória Qual painel (escolha da lista).
role cargo obrigatória O cargo concedido pelo botão.

/reactionrole delete <panel>

Exclui um painel de cargos por reação.

OpçãoTipoExigidaDescrição
panel texto obrigatória Qual painel (escolha da lista).

/reactionrole list

Lista os painéis de cargos por reação.

  • Até 25 painéis por servidor e 25 cargos por painel.
  • Modo Acumular: o membro pega e devolve os cargos que quiser. Modo Único: um só cargo do painel por vez, o anterior é retirado automaticamente.
  • O painel se constrói em dois tempos: create para a mensagem, depois um addrole por botão.

Exemplos

/reactionrole create channel:#cargos title:Suas notificações mode:Acumular

/reactionrole addrole panel:Suas notificações role:@Anúncios emoji:📣

/tempvoice

Gerenciar servidor 3 s Bot: Gerenciar canais, Gerenciar cargos, Mover membros

Configura os canais de voz temporários (entre para criar).

Canais de voz sob demanda: entrar no canal de disparo cria um canal do qual o membro é dono.

/tempvoice enable <canal> <categoria>

Ativa os canais temporários e escolhe o canal acionador.

OpçãoTipoExigidaDescrição
canal canal obrigatória O canal de voz que cria um canal temporário ao entrar.Tipo: canal de voz
categoria canal obrigatória Categoria onde os canais de voz temporários são criados.Tipo: categoria

/tempvoice disable

Desativa os canais de voz temporários neste servidor.

/tempvoice status

Mostra a configuração atual dos canais temporários.

  • O canal temporário é apagado assim que se esvazia: sem rastro, sem nada a limpar.
  • Seu dono pode renomeá-lo, limitar seu acesso ou fixar sua capacidade.

Exemplos

/tempvoice enable canal:➕ Criar um canal categoria:Voz

/giveaway

Gerenciar servidor 3 s

Criar e gerenciar sorteios.

Sorteio com extração automática no vencimento.

/giveaway start <prêmio> <duração> [vencedores] [canal] [cargo]

Iniciar um novo sorteio.

OpçãoTipoExigidaDescrição
prêmio texto obrigatória O que está sendo sorteado.no máximo 256 caracteres
duração texto obrigatória Duração do sorteio (ex.: 1h, 30m, 2d).no máximo 50 caracteres
vencedores número inteiro opcional Quantos vencedores sortear (padrão: 1).De 1 a 20
canal canal opcional Canal onde publicar o sorteio (padrão: canal atual).Tipo: canal de texto, canal de anúncios
cargo cargo opcional Restringir a participação a membros com este cargo.

/giveaway end <sorteio>

Encerrar um sorteio agora e sortear os vencedores.

OpçãoTipoExigidaDescrição
sorteio texto obrigatória Qual sorteio (escolha na lista).

/giveaway reroll <sorteio>

Sortear novos vencedores de um sorteio encerrado.

OpçãoTipoExigidaDescrição
sorteio texto obrigatória Qual sorteio (escolha na lista).

/giveaway cancel <sorteio>

Cancelar um sorteio sem sortear um vencedor.

OpçãoTipoExigidaDescrição
sorteio texto obrigatória Qual sorteio (escolha na lista).

/giveaway list

Listar os sorteios ativos deste servidor.

  • Duração aceita: de 10 segundos a 28 dias. Formato livre: 30m, 2h, 1h30m, 3d.
  • Até 20 sorteios em curso por servidor, e 20 vencedores por sorteio.
  • reroll sorteia um novo vencedor depois, se o primeiro não se manifestar.

Exemplos

/giveaway start prêmio:Um mês de Nitro duração:2d vencedores:3 canal:#sorteios

/giveaway start prêmio:Chave de jogo duração:1h30m cargo:@Booster

Participação reservada aos boosters.

/xp

Gerenciar servidor 3 s

Gerencia o XP dos membros.

Ajuste manual da experiência de um membro, sem tocar no resto da classificação.

/xp give <usuário> <quantidade>

Dá XP a um membro.

OpçãoTipoExigidaDescrição
usuário membro obrigatória O usuário alvo.
quantidade número inteiro obrigatória Quantidade de XP.De 1 a 10000000

/xp remove <usuário> <quantidade>

Remove XP de um membro.

OpçãoTipoExigidaDescrição
usuário membro obrigatória O usuário alvo.
quantidade número inteiro obrigatória Quantidade de XP.De 1 a 10000000

/xp set <usuário> <quantidade>

Define o XP de um membro em um valor exato.

OpçãoTipoExigidaDescrição
usuário membro obrigatória O usuário alvo.
quantidade número inteiro obrigatória Quantidade de XP.De 0 a 10000000
  • give e remove trabalham em relativo, set em absoluto.
  • A subida de nível que decorre do ajuste é anunciada como qualquer outra.

Exemplos

/xp give usuário:@sofia quantidade:500

/live

Gerenciar servidor 3 s

Anuncia automaticamente as lives da Twitch e do YouTube.

/live enable <channel> [mention]

Ativa os anúncios e escolhe o canal onde serão publicados.

OpçãoTipoExigidaDescrição
channel canal obrigatória O canal onde os anúncios de live são publicados.Tipo: canal de texto, canal de anúncios
mention cargo opcional Cargo notificado em cada anúncio (@everyone também funciona).

/live add <platform> <streamer> [channel]

Segue um canal da Twitch ou do YouTube.

OpçãoTipoExigidaDescrição
platform texto obrigatória A plataforma do canal.Escolhas: Twitch, YouTube
streamer texto obrigatória Nome do canal, o @identificador ou o endereço da página.no máximo 200 caracteres
channel canal opcional O canal onde os anúncios de live são publicados.Tipo: canal de texto, canal de anúncios

/live remove <platform> <streamer>

Deixa de seguir um canal.

OpçãoTipoExigidaDescrição
platform texto obrigatória A plataforma do canal.Escolhas: Twitch, YouTube
streamer texto obrigatória Nome do canal, o @identificador ou o endereço da página.no máximo 200 caracteres

/live list

Mostra os canais seguidos neste servidor.

/live disable

Desativa os anúncios de lives neste servidor.

/live status

Mostra a configuração atual dos anúncios.

/staff

Gerenciar servidor 3 s

Gerencia os cargos de staff autorizados a usar a moderação.

Coração do controle de acesso: três níveis de staff associados a cargos do seu servidor, e um nível mínimo por comando de moderação.

/staff manage

Abre um painel interativo para configurar os cargos de staff e o nível dos comandos.

/staff clear

Remove todos os cargos de staff.

/staff command <command> <level>

Define o nível de staff necessário para usar um comando de moderação.

OpçãoTipoExigidaDescrição
command texto obrigatória O comando de moderação a configurar.Escolhas: clear, timeout, warn, history, sanction, note, slowmode, clearqueue, kick, ban, tempban, massmove, unwarn, lock, unlock, role, unban
level número inteiro obrigatória Nível de staff (1 a 3).Escolhas: Nível 1, Nível 2, Nível 3

/staff levels

Mostra o nível de staff necessário para cada comando de moderação.

  • Um membro que tenha a permissão nativa do Discord passa de qualquer forma: os níveis de staff abrem o acesso, nunca o fecham.
  • /staff manage abre o painel completo; os subcomandos cobrem os gestos rápidos.
  • O nível que vale para um membro é o do seu cargo de staff mais alto.

Exemplos

/staff command command:ban level:Nível 3

Reserva /ban aos moderadores de nível 3.

/staff levels

Tabela dos níveis em vigor no servidor.

/dj

Gerenciar servidor 3 s

Gerencia os cargos de DJ autorizados a controlar a música.

Cargos autorizados a controlar a reprodução em curso.

/dj add <role> [role-2] [role-3] [role-4] [role-5]

Adiciona um ou mais cargos de DJ.

OpçãoTipoExigidaDescrição
role cargo obrigatória O cargo a definir como cargo de DJ.
role-2 cargo opcional Um cargo de DJ adicional.
role-3 cargo opcional Um cargo de DJ adicional.
role-4 cargo opcional Um cargo de DJ adicional.
role-5 cargo opcional Um cargo de DJ adicional.

/dj remove <role> [role-2] [role-3] [role-4] [role-5]

Remove um ou mais cargos de DJ.

OpçãoTipoExigidaDescrição
role cargo obrigatória O cargo a definir como cargo de DJ.
role-2 cargo opcional Um cargo de DJ adicional.
role-3 cargo opcional Um cargo de DJ adicional.
role-4 cargo opcional Um cargo de DJ adicional.
role-5 cargo opcional Um cargo de DJ adicional.

/dj list

Mostra os cargos de DJ configurados.

/dj clear

Remove todos os cargos de DJ.

  • É DJ: o dono do servidor, um administrador, um membro com “Gerenciar servidor”, ou um membro que tenha um dos cargos adicionados aqui.
  • Sem nenhum cargo DJ configurado, os comandos reservados aos DJs respondem portanto apenas a esses três perfis. Nem por isso ficam abertos a todo mundo.
  • Os cargos de staff (/staff) são uma lista distinta: não concedem o status de DJ.

Exemplos

/dj add role:@DJ role-2:@Moderador

/idioma

Gerenciar servidor 3 s

Altera o idioma do bot para este servidor.

Idioma do bot para todo o servidor: embeds, menus, erros, mas também nomes e descrições dos comandos.

/idioma <idioma>

OpçãoTipoExigidaDescrição
idioma texto obrigatória O idioma a usar.
  • Treze idiomas completos. A mudança se aplica no mesmo segundo, sem reinício.
  • O idioma de um membro não entra em jogo: é um ajuste do servidor.

Exemplos

/idioma idioma:Português

/backup

Administrador 10 s

Salva e restaura a estrutura do seu servidor.

Fotografa a estrutura do servidor (cargos, canais, permissões) e a restitui mais tarde.

/backup create

Salva a estrutura deste servidor (cargos, canais, permissões).

/backup import <code>

Restaura um dos seus backups neste servidor.

OpçãoTipoExigidaDescrição
code texto obrigatória O código do backup (enviado na DM).no máximo 16 caracteres

/backup list

Lista seus backups de servidor e seus códigos.

/backup delete <code>

Exclui um dos seus backups de servidor.

OpçãoTipoExigidaDescrição
code texto obrigatória O código do backup (enviado na DM).no máximo 16 caracteres
  • 3 backups mantidos por dono. Além disso, apague um com delete.
  • O código é enviado por mensagem privada: é ele que permite a restauração, não deve circular num canal.
  • Um backup não contém nenhuma mensagem: não é um histórico de conversa.
  • A restauração recria a estrutura no servidor atual, então você pode clonar um servidor importando o código em outro lugar.

Exemplos

/backup create

O código chega no MP.

/backup import code:M9XAP4RNK7

Comunidade

Abertos a todos os membros, sem nenhuma permissão especial.

9 comandos

/help

Aberto a todos MD 5 s

Lista todos os comandos disponíveis.

Menu interativo de todos os comandos disponíveis, filtrado conforme o que você tem direito de usar.

/help

  • Utilizável em mensagem privada.

/rank

Aberto a todos 5 s

Mostra o nível e o cartão de rank de um membro.

Cartão de rank gerado na hora: nível, XP acumulado, posição na classificação do servidor.

/rank [user]

OpçãoTipoExigidaDescrição
user membro opcional O usuário alvo.

Exemplos

/rank user:@sofia

Sem opção, o comando mostra o seu próprio cartão.

/leaderboard

Aberto a todos 5 s

Mostra o ranking de XP do servidor.

Classificação do servidor por experiência, página por página.

/leaderboard

/userinfo

Aberto a todos 3 s

Mostra informações sobre um usuário.

Ficha de um membro: entrada no servidor, criação da conta, cargos, ID.

/userinfo [user]

OpçãoTipoExigidaDescrição
user membro opcional O usuário alvo.

/serverinfo

Aberto a todos 5 s

Mostra informações sobre este servidor.

Ficha do servidor: membros, canais, cargos, nível de impulso, data de criação.

/serverinfo

/avatar

Aberto a todos MD 3 s

Mostra o avatar de um usuário.

Mostra o avatar em tamanho grande, com os links de download.

/avatar [user]

OpçãoTipoExigidaDescrição
user membro opcional O usuário alvo.
  • Utilizável em mensagem privada.

/ping

Aberto a todos MD 3 s

Mostra a latência do bot.

Latência do gateway do Discord e tempo de resposta do bot.

/ping

  • Utilizável em mensagem privada.

/hug

Aberto a todos 3 s

Dê um abraço em alguém.

Comando de diversão, sem efeito sobre a configuração.

/hug <user>

OpçãoTipoExigidaDescrição
user membro obrigatória O usuário alvo.

/slap

Aberto a todos 3 s

Dê um tapa em alguém (só por diversão).

Comando de diversão, sem efeito sobre a configuração.

/slap <user>

OpçãoTipoExigidaDescrição
user membro obrigatória O usuário alvo.

Música

O módulo de música se apoia numa infraestrutura de áudio dedicada. Se ela não estiver disponível, estes comandos respondem «serviço indisponível» e o resto do bot continua funcionando normalmente.

11 comandos

/play

Aberto a todos 2 s Bot: Conectar, Falar

Toca uma música ou a adiciona à fila.

Lança uma busca ou aceita um link, e empilha o resultado na fila de espera.

/play <query> [source]

OpçãoTipoExigidaDescrição
query texto obrigatória Nome da música ou link.
source texto opcional Plataforma de busca (padrão: YouTube).Escolhas: YouTube, Spotify
  • Você precisa estar conectado a um canal de voz; o bot se junta a você lá.
  • Um link de playlist adiciona todas as suas faixas de uma vez.
  • A reprodução se apoia numa infraestrutura de áudio dedicada: se ela estiver indisponível, o comando avisa e nada mais é afetado.

Exemplos

/play query:daft punk one more time

/play query:https://open.spotify.com/track/... source:Spotify

/skip

Aberto a todos 2 s

Pula a música atual.

Passa para a próxima faixa da fila.

/skip

/pause

Reservado aos DJ 2 s

Pausa a música atual.

Suspende a reprodução mantendo o ponto exato.

/pause

  • Reservado aos DJs: o dono do servidor, um administrador, um membro com “Gerenciar servidor”, ou quem tenha um cargo adicionado por /dj add. Ver /dj.

/resume

Reservado aos DJ 2 s

Retoma a reprodução.

Retoma uma reprodução suspensa.

/resume

  • Reservado aos DJs: o dono do servidor, um administrador, um membro com “Gerenciar servidor”, ou quem tenha um cargo adicionado por /dj add. Ver /dj.

/stop

Reservado aos DJ 2 s

Para a música e limpa a fila.

Para a reprodução, esvazia a fila e libera o canal de voz.

/stop

  • Reservado aos DJs: o dono do servidor, um administrador, um membro com “Gerenciar servidor”, ou quem tenha um cargo adicionado por /dj add. Ver /dj.

/queue

Aberto a todos 3 s

Mostra a fila atual.

Fila de espera completa, página por página, com a duração acumulada.

/queue

/nowplaying

Aberto a todos 3 s

Mostra a música tocando agora.

Faixa em curso, com sua barra de progresso.

/nowplaying

/loop

Reservado aos DJ 2 s

Define o modo de repetição.

Repetição da faixa atual, de toda a fila, ou nada.

/loop <mode>

OpçãoTipoExigidaDescrição
mode texto obrigatória O modo de repetição a aplicar.Escolhas: Desligado, Faixa, Fila
  • Reservado aos DJs: o dono do servidor, um administrador, um membro com “Gerenciar servidor”, ou quem tenha um cargo adicionado por /dj add. Ver /dj.

Exemplos

/loop mode:Fila

A fila recomeça do início depois de esgotada.

/volume

Reservado aos DJ 2 s

Altera o volume de reprodução.

Volume de reprodução, de 1 a 150.

/volume [volume]

OpçãoTipoExigidaDescrição
volume número inteiro opcional Nível do volume (1-150).De 1 a 150
  • Reservado aos DJs: o dono do servidor, um administrador, um membro com “Gerenciar servidor”, ou quem tenha um cargo adicionado por /dj add. Ver /dj.
  • Acima de 100, a qualidade se degrada rapidamente.

/clearqueue

Aberto a todos 3 s

Esvazia todas as próximas músicas da fila.

Esvazia as faixas seguintes sem interromper a que está tocando.

/clearqueue

/lyrics

Aberto a todos 5 s

Mostra a letra da música atual.

Letra da faixa em curso, quando está disponível.

/lyrics

Falta um comando?

O painel explica cada ajuste ao lado do seu interruptor, e a FAQ responde ao resto.