Comandos personalizados no Discord: crie seus próprios comandos sem programar

Em quase todo servidor, os membros fazem as mesmas perguntas o tempo todo: onde estão as regras? Qual é o IP do servidor? Onde eu acho a live de vocês? Em vez de digitar o mesmo texto toda vez, você cria comandos personalizados. Um membro digita /ip e recebe na hora a resposta certa, sempre com as mesmas palavras e sempre atualizada.

O próprio Discord não oferece comandos de texto personalizados. Os comandos de barra sempre vêm de um aplicativo, ou seja, de um bot. Neste guia você cria comandos personalizados com o Lizbot sem escrever uma linha de código: com placeholders, como embed, só para certos cargos ou canais e, se quiser, importados de um bot que você usava antes.

Para que servem os comandos personalizados

Um comando personalizado vale a pena sempre que uma resposta é pedida com frequência e muda pouco. Ideias que funcionam bem:

São menos indicados os conteúdos que mudam todo dia e textos longos que, na verdade, deveriam ficar em um canal próprio. Um comando deve dar uma resposta rápida, não substituir um manual. Para a moderação em si você não precisa de comandos personalizados: advertência, castigo, expulsão e banimento já vêm com o Lizbot, e o resumo está no guia comandos de moderação do Discord.

Comando personalizado ou resposta automática?

O Lizbot tem dois jeitos de responder automaticamente. A escolha costuma ser simples:

• Comando personalizado: o membro pede a resposta de propósito com /nome. O Discord sugere o comando quando a pessoa digita /, junto com a sua descrição. Ótimo para tudo o que se consulta de forma direta.
• Resposta automática: o Lizbot reage a uma palavra-chave em uma mensagem normal, inclusive com expressões regulares. Ótimo quando as pessoas simplesmente escrevem a pergunta no chat, por exemplo "qual é o ip". Você encontra isso no painel em Interação, na aba Respostas automáticas.

Muitos servidores usam os dois: /ip para quem conhece o comando e uma resposta automática para todo o resto. Nesse caso, mantenha os textos iguais para não circularem duas versões.

1. Conferir o módulo e abrir a página

Abra o painel e escolha o seu servidor. Na barra lateral, em Automatizar, fica a página Comandos personalizados. Em servidores novos o módulo já vem ativado. Se mais tarde você não vir seus comandos no Discord, confira em Módulos se Comandos personalizados está ativo. Só assim o Lizbot registra os comandos no Discord.

No plano Free você cria até 20 comandos personalizados, no Pro até 150 e no Studio quantos quiser. Para a maioria dos servidores, 20 já sobram. O Discord permite no máximo 100 comandos de barra por servidor. Os comandos personalizados que não couberem mais ali ficam todos acessíveis por /c.

2. Começar rápido com um modelo

Se você não quer começar do zero, use Comandos a partir de modelo no topo da página. Há cinco pacotes:

• Comandos básicos: /regras, /redes, /ajuda
• Suporte: /ajuda-ticket, /faq, /contato
• Criador: /stream, /youtube, /merch, /agenda
• Comunidade: /apresentar, /eventos, /parcerias
• Servidor de jogos: /ip, /status, /mods

Os modelos trazem textos de exemplo com endereços fictícios como example.com. Troque sem falta pelos seus links e dados reais, senão o /ip manda seus jogadores para lugar nenhum.

3. Criar um comando personalizado

Clique em Comando. Na janela Novo comando você preenche estes campos:

1. Nome: é o nome do comando: regras vira /regras. São permitidas letras minúsculas, números, - e _, no máximo 32 caracteres. Acentos, ç e espaços não funcionam, então escreva informacoes em vez de "informações".
2. Descrição: o Discord mostra este texto no menu de comandos, abaixo do nome, com no máximo 100 caracteres. Escreva de um jeito que dê para entender o que vem sem testar, por exemplo "IP e versão do servidor".
3. Resposta: o texto em si, com até 2000 caracteres. A formatação do Discord funciona, ou seja, negrito, listas e links. Um canal só fica clicável como <#ID-do-canal>; um #regras digitado à mão continua como texto normal.
4. Se quiser, os interruptores e as restrições das próximas seções.
5. Salvar.

Depois de salvar, o comando fica disponível no Discord em poucos segundos. Se ele não aparecer para você, reinicie o app do Discord ou aperte Ctrl+R na versão do navegador. O Discord nem sempre recarrega a lista de comandos na hora. O guia mudar o idioma de um bot do Discord explica em que idioma o Discord mostra os comandos e como mudar o idioma do bot.

Na lista você vê quantas vezes cada comando já foi usado. Assim você percebe quais comandos são realmente usados e quais pode cortar.

4. Placeholders: respostas que se adaptam

Com placeholders entre chaves, cada resposta fica pessoal. O Lizbot os substitui quando o comando é usado:

O placeholder {args} é especialmente prático. Todo comando personalizado ganha automaticamente no Discord uma opção text, que é opcional. O que for digitado ali aparece no lugar de {args}. Um exemplo para um comando da equipe /boas-vindas:

```
Oi, {args}! Boas-vindas ao {guild.name}. Dá uma olhada primeiro em <#123456789012345678> e depois se apresente rapidinho.
```

Troque o número pelo ID do seu canal de regras. Se alguém da equipe usar /boas-vindas text:@Alex, o Lizbot cumprimenta Alex com uma menção. Se text ficar vazio, esse espaço fica vazio. Por isso, escreva a frase de um jeito que ela faça sentido também sem o complemento, ou use {args} só em comandos da equipe em que todo mundo sabe o que vai ali.

Um placeholder que o Lizbot não conhece fica no texto do jeito que está. Se na resposta aparecer {user.nam} em vez de um nome, você digitou errado.

5. Resposta como embed ou visível só para quem usou

Dois interruptores mudam a aparência da resposta:

• Responder como embed: o texto aparece em uma caixa com borda colorida. A Cor do embed você escolhe logo abaixo. Embeds parecem mais organizados e combinam com regras, IP do servidor ou listas de links. Para respostas curtas e descontraídas, texto normal costuma ser mais agradável.
• Visível só para quem usou: só a pessoa que usa o comando vê a resposta. O canal continua limpo mesmo quando dez pessoas digitam /ip em sequência. Para comandos que a equipe deve publicar para todos verem, como um aviso de regras, deixe o interruptor desligado.

Se você precisa de um embed com título, imagem e botões de link, a ferramenta certa é o criador de embeds. Mais detalhes na página Embeds.

6. Permissões: só para a equipe ou para todos

Sem restrição, qualquer membro pode usar qualquer comando personalizado em qualquer lugar. Com dois campos no comando você limita isso:

• Só para os cargos: só membros com pelo menos um dos cargos escolhidos podem usar o comando. Vazio significa: todos.
• Só nos canais: o comando só funciona nos canais escolhidos. Vazio significa: em todo lugar.

Quem usar o comando mesmo assim recebe um aviso curto de que não tem permissão. Esse aviso só a própria pessoa vê.

Importante saber: o Lizbot verifica essas permissões quando o comando é usado. Mas o Discord continua mostrando o comando a todos no menu. Se você quer esconder do menu também um comando da equipe, use além disso as permissões de comandos do próprio Discord:

1. Abra as Configurações do servidor e depois Integrações.
2. Ao lado do Lizbot, clique em Gerenciar.
3. Escolha o comando personalizado na lista.
4. Tire o acesso de @everyone e libere para os cargos da sua equipe.

Assim o Discord esconde os comandos de membros sem permissão. Mesmo assim, deixe Só para os cargos configurado no Lizbot. Desse jeito o comando continua protegido se mais tarde alguém redefinir sem querer a configuração do Discord.

Membros sem a permissão Usar comandos de aplicativo (em inglês "Use Application Commands") não conseguem usar nenhum comando de barra. Confira isso em @everyone, nas permissões dos cargos, se membros avisarem que nenhum comando aparece. O guia configurar cargos no Discord explica como cargos e permissões funcionam juntos.

7. Importar comandos de outro bot

Se até agora você usava outro bot com comandos próprios, não precisa digitar tudo de novo. No painel, em Trocar de bot, fica a aba Comandos:

1. Cole os seus comandos como texto, um comando por linha, por exemplo !regras Leia #regras, por favor ou regras: texto. Como alternativa, carregue com Carregar arquivo um arquivo CSV ou JSON com as colunas name e response.
2. Em Placeholders de, escolha o bot de onde vêm os comandos ou Outro bot. O Lizbot então converte os placeholders conhecidos para o formato dele.
3. Clique em Verificar. Em Assim fica você vê o resultado antes de qualquer coisa ser salva.
4. Decida se Sobrescrever comandos existentes deve ficar ativo.
5. Clique em Importar.

O Lizbot ajusta os nomes durante a importação: prefixos como ! somem e letras maiúsculas viram minúsculas. Letras com acento e o ç não são permitidos e viram um hífen: !Informação vira /informa-o. Corrija esses nomes depois no painel. São pulados os comandos cujo nome já pertence ao Lizbot, entradas duplicadas, comandos que já existem quando você não sobrescreve e tudo o que passar do limite do seu plano. Comandos novos recebem a descrição provisória "Importiert". Troque depois no painel por um texto compreensível, porque é exatamente ele que o Discord mostra no menu de comandos. A troca completa está descrita no guia trocar de bot, e um resumo está na página Trocar de bot.

Checklist

• O módulo Comandos personalizados está ativo
• Cada comando tem um nome curto e claro e uma descrição compreensível
• Os textos de exemplo dos modelos foram trocados por links e dados reais
• Comandos que muita gente usa respondem só para quem usou
• Comandos da equipe estão limitados com Só para os cargos e também no Discord, em Integrações
• Os placeholders foram testados e não sobra nada entre chaves na resposta
• Os comandos do bot anterior foram importados, e o bot antigo não responde mais em duplicidade

Erros comuns

• O comando não aparece: quase sempre o Discord ainda não recarregou a lista. Reinicie o app. Se não resolver, clique em Sincronizar comandos de novo. Confira também se o módulo está ativo.
• O nome tem maiúsculas ou acentos: o Discord só aceita minúsculas, números, - e _. O painel impede nomes inválidos; o que confunde é procurar depois por "informações" quando o comando se chama informacoes.
• O nome coincide com um comando do Lizbot: comandos como /ticket ou /community poll já existem. O painel recusa direto alguns nomes, como /ticket. Em outros casos o comando personalizado é salvo, mas no Discord aparece o comando integrado do Lizbot enquanto o módulo dele estiver ativo. Por isso, escolha um nome próprio, por exemplo /ajuda-ticket.
• Comando da equipe visível para todos: a restrição do Lizbot bloqueia o uso, mas não esconde o comando. Acrescente as permissões de comandos em Integrações.
• Comandos demais: trinta comandos que ninguém conhece não ajudam ninguém. Olhe de tempos em tempos o número de usos e apague o que ninguém usa.
• Informações desatualizadas: um IP de servidor errado é pior do que nenhum. Planeje atualizar os textos a cada mudança.