AutoMod

Premium
Voltar à documentação

Comandos personalizados

Crie seus próprios comandos de barra do servidor com opções, respostas e ações personalizadas.

Como funciona

Cada comando personalizado vira um comando de barra real do Discord, criado, atualizado e removido pela API do Discord, com argumentos próprios que as pessoas preenchem ao digitar /seucomando.

Ações

Um comando executa suas ações em ordem, de cima para baixo, quando alguém o usa:

TipoEfeito
ResponderA resposta visível do comando. Só uma ação Responder é permitida por comando
Enviar mensagem no canalEnvia uma mensagem para um canal de sua escolha
Enviar DMEnvia uma mensagem direta ao alvo do comando
Resposta aleatóriaResponde com uma resposta escolhida aleatoriamente a cada vez
Adicionar cargoDá um cargo ao alvo do comando
Remover cargoRemove um cargo do alvo do comando
Alternar cargoAdiciona ou remove um cargo dependendo de o alvo já ter ou não

Opções

As opções viram os argumentos que o Discord mostra quando alguém digita o seu comando. O Discord exige que todas as opções obrigatórias venham antes das opcionais.

TipoEfeito
TextoTexto livre, opcionalmente com tamanho mínimo/máximo
NúmeroUm número inteiro, opcionalmente com valor mínimo/máximo
Sim/NãoUma escolha simples de verdadeiro ou falso
UsuárioDeixa quem usa o comando escolher um membro do servidor
CanalDeixa quem usa o comando escolher um canal
CargoDeixa quem usa o comando escolher um cargo
AnexoDeixa quem usa o comando enviar um arquivo

Variáveis

Responder, Enviar mensagem no canal, Enviar DM e Resposta aleatória aceitam estas variáveis integradas nos campos de texto e de embed:

  • {user_name} o nome de usuário no Discord de quem usou o comando
  • {user_mention} uma @menção que o notifica
  • {user_id} o ID de usuário dele no Discord
  • {user_tag} a tag antiga dele no formato usuario#0000
  • {user_avatar} um link para o avatar dele
  • {server_name} o nome deste servidor
  • {server_avatar} um link para o ícone deste servidor
  • {time} a hora atual (ex.: 14:32)
  • {time_12} a hora atual no formato de 12 horas (ex.: 2:32 PM)
  • {date} a data atual
  • {datetime} a data e a hora atuais
  • {datetime_12} a data e a hora atuais no formato de 12 horas
  • {random_2} um número inteiro aleatório de 1 a 2
  • {random_6} um número inteiro aleatório de 1 a 6
  • {random_10} um número inteiro aleatório de 1 a 10
  • {random_100} um número inteiro aleatório de 1 a 100
  • {count} quantas vezes este comando já foi usado

Variáveis das opções

Cada opção que você adiciona também vira sua própria variável, com o nome da opção. Adicione uma opção de Texto chamada reason, por exemplo, e {reason} na sua Resposta é preenchido com o que quem usou o comando digitou. Opções de Usuário, Canal e Cargo liberam ainda algumas subvariáveis:

Tipo de opçãoVariáveis disponíveis
Texto, Número, Sim/Não, Anexo{optionName}: o valor informado pelo usuário
Usuário{optionName}, {optionName.id}, {optionName.mention}, {optionName.avatar}, {optionName.display_name}
Canal{optionName}, {optionName.id}, {optionName.mention}
Cargo{optionName}, {optionName.id}, {optionName.mention}

Restrições e limites

LimiteFreePremium
Comandos personalizados550
Ações por comando310
Opções por comando325

Os grupos são limitados a 20 em qualquer caso, e os tempos de espera podem ir de 0 a 86400 segundos.

Grupos, sincronização e compartilhamento

Organize os comandos em até 20 grupos arrastando e soltando, exporte qualquer comando como JSON para levá-lo a outro servidor e importe um que alguém compartilhar com você. Se a lista de comandos do Discord parecer desatualizada, Sincronizar agora registra tudo de novo de uma vez (limitado a uma vez a cada poucos minutos).