Os bots do Discord vêm em todas as formas e tamanhos e podem ser usados para uma ampla variedade de propósitos que vão desde moderar o comportamento do usuário em seu servidor, distribuir automaticamente punições como silenciar ou banir jogadores que saem da linha, até jogar música para todos curtirem.
As instruções abaixo pressupõem que você já tenha uma conta e servidor no Discord. Caso contrário, você deve configurar isso em discordapp.com antes de continuar.
Enquanto os bots do Discord são escritos na linguagem JavaScript, você não precisa ser um programador experiente para criá-los. Na verdade, o processo é muito menos intimidante do que você imagina. Continue lendo para saber como fazer um Discord Bot que faz o seu lance.
Este tutorial é destinado a usuários que executam sistemas operacionais macOS ou Windows.
Baixe e instale o Node.js
Antes de começar a criar o bot do Discord, você deve primeiro instalar o Node.js, um ambiente de tempo de execução JavaScript criado no mecanismo V8 do Google Chrome.
-
Abra um navegador da web e navegue até a página oficial de download do Node.js.
Image -
Selecione o pacote de instalação apropriado para sua plataforma específica (macOS ou Windows) e clique no link de download.
- Abra o arquivo baixado e siga as instruções na tela para instalar o Node.js.
- Ao concluir, inicie o aplicativo Prompt de comando (Windows) ou Terminal (macOS).
-
Digite o seguinte texto no prompt e pressione Enter no teclado: node -v
Image - Se um número de versão for retornado, o Node.js foi instalado corretamente. Caso contrário, revise as etapas acima e verifique se a instalação foi concluída.
Criar um aplicativo de discórdia
Agora que você tirou os pré-requisitos do caminho, é hora de criar um novo aplicativo ao qual seu bot possa ser adicionado posteriormente.
- Abra um navegador e navegue até o Portal do Desenvolvedor Discord do seu servidor, fazendo login se necessário.
-
Clique Nova Aplicação.
Image -
Digite um nome para seu novo aplicativo no campo de edição fornecido e clique em Create quando estiver pronto.
Image -
A tela de Informações Gerais para seu novo aplicativo agora deve ser exibida, conforme mostrado na captura de tela anexa. Selecione Bot, localizado no painel esquerdo do menu.
Image -
Clique Adicionar bot.
Image -
Aparecerá uma mensagem perguntando se você tem certeza de que deseja adicionar um bot ao seu aplicativo. Clique em Sim, faça isso!
Image -
Seu novo bot agora deve ser criado, com suas informações e opções exibidas na seção BUILD-A-BOT. Selecione Clique para Revelar Token.
Image -
Uma longa sequência de caracteres agora deve ser exibida no lugar do link mencionado. Clique em Copiar para enviar este token para sua área de transferência.
Image -
Cole este token em um arquivo de texto por enquanto usando o Bloco de Notas, TextEdit ou um aplicativo similar.
Você deve excluir este arquivo e removê-lo da sua Lixeira ou Lixeira depois de concluir este tutorial.
Codificando seu bot
Você criou um bot e o adicionou ao seu servidor. Em seguida, vem a parte divertida, codificar seu bot para fazer o que você deseja.
- Iniciar o aplicativo Prompt de comando (Windows) ou Terminal (macOS).
-
Digite o seguinte texto no prompt e pressione Enter ou Return em seu teclado: mkdir discord-test -bot
Image Você pode substituir discord-test-bot por um nome de sua escolha.
-
Em seguida, digite o seguinte comando para percorrer o diretório recém-criado: cd discord-test-bot
Image -
O prompt de comando agora deve ser atualizado, exibindo o nome da pasta do projeto do seu bot. Digite o seguinte e pressione Enter ou Return: npm init -y
Image -
Um arquivo chamado package.json agora deve ser criado na pasta do seu projeto, conforme mostrado na captura de tela acima. Digite o seguinte no prompt de comando e pressione Enter ou Return: npm install --save discord.js
Image -
Uma lista de mensagens WARN agora pode ser exibida, que pode ser ignorada desde que não haja erros (ERR) mostrados e a mensagem na parte inferior do seu prompt de comando ou janela do Terminal leia “adicionado 7 pacotes” ou “adicionou 8 pacotes”. Digite o seguinte e pressione Enter ou Return para criar o arquivo auth.json: touch auth.json
Image Se você receber uma mensagem de erro ao tentar usar o comando touch, talvez seja necessário instalá-lo primeiro digitando a seguinte sintaxe no prompt de comando: npm install touch-cli -g
-
Haverá uma mensagem de confirmação informando que este arquivo foi criado, mas você pode digitar ls -al (macOS) ou dir (Windows) para ver o conteúdo do diretório do seu projeto e confirmar por si mesmo que auth.json está listado de fato.
Image - Inicie seu código ou editor de texto preferido, como Atom, Notepad ou TextEdit, e navegue até a nova pasta do projeto.
-
Abra o arquivo auth.json e digite o texto mostrado na captura de tela, substituindo AUTH-TOKEN pela string do token de autenticação que você armazenou anteriormente no tutorial. Salve o arquivo quando terminar.
Image Você must copie e cole toda a string de autenticação entre as aspas mostradas. Se estiver f altando um caractere, seu bot não funcionará como esperado.
- Retorne ao editor e crie um novo arquivo na pasta do seu projeto chamado bot.js.
-
O arquivo bot.js conterá o código que dita o comportamento do seu bot, que é totalmente sua. Para os propósitos deste tutorial, no entanto, recomendamos usar o código a seguir e testar seu bot de ponta a ponta para garantir que tudo esteja funcionando conforme o esperado. Você pode então voltar e editar o conteúdo do bot.js como achar melhor.
const Discord=require('discord.js');
cliente const=new Discord. Client();
const auth=require('./auth.json');
client.on('pronto', ()=> {
console.log(`Logado como ${client.user.tag}!`);
});
client.on('message', msg=> {
if (msg.content==='olá') {
msg.reply('oi!');
}
});
client.login(auth.token);
Este código de amostra gravará uma mensagem no console da linha de comando quando o bot for chamado, confirmando um login bem-sucedido e contendo sua tag de usuário.
- Salve seu arquivo bot.js atualizado.
- Retorne ao Prompt de Comando ou Terminal e digite o seguinte para executar seu script de bot: node bot.js
- Se você fez tudo corretamente até este ponto, o seguinte texto deve aparecer em seu prompt de comando ou janela de terminal: Logado como discord-test-bot
Integre o código do bot com seu servidor
Você está quase lá…
- Abra um navegador e navegue até o Portal do Desenvolvedor Discord do seu servidor, fazendo login se necessário.
-
Selecione o aplicativo que criamos anteriormente na tela MEUS APLICATIVOS, se solicitado.
Image -
Clique em OAuth2, localizado no painel esquerdo do menu.
Image -
Role até a parte inferior da tela até localizar a seção SCOPES. Coloque uma marca de seleção ao lado da opção bot clicando nela uma vez.
Image -
Role para baixo novamente até a seção BOT PERMISSIONS, colocando marcas de seleção ao lado de cada tipo de permissão que seu bot individual pode precisar para funcionar conforme o esperado. Para os propósitos deste bot de exemplo, precisamos das seguintes permissões: Send Messages, Read Message History
Image Seu bot em particular provavelmente precisará de um conjunto significativamente diferente de permissões. É importante entender o que cada permissão envolve antes de ativá-la, para que os usuários de bot não possam explorá-la para fins nefastos.
-
Clique Copiar, localizado entre as seções SCOPES e BOT PERMISSIONS e acompanhado por um URL longo.
Image - Abra uma nova aba do navegador e cole este URL na barra de endereço, pressionando Enter ou Return para carregar a página.
-
A interface CONNECT TO DISCORD agora deve ser exibida, conforme mostrado na captura de tela anexa. Clique em Selecione um servidor e escolha o nome do seu servidor na lista fornecida.
Image -
Clique Autorizar.
Image -
Coloque uma marca de seleção ao lado de Eu não sou um robô clicando em sua caixa de seleção uma vez.
Image -
Uma mensagem de confirmação deve ser exibida, informando que seu bot está autorizado e foi adicionado ao seu servidor.
Image
Como testar seu bot no servidor
Você pode testar seu bot iniciando o cliente Discord e enviando comandos ou mensagens que correspondem ao seu código específico. Neste exemplo, envie a palavra hello para seu bot e ele deverá responder com hi!
