Quais arquivos preciso enviar para o meu bot discord.js?

Envie os arquivos index.js e package.json (com a dependência discord.js) para o diretório do serviço, usando o gerenciador de arquivos integrado ou o recurso de upload de arquivos.

Como programar seu próprio bot do Discord com discord.js

Q: Por que meus comandos de barra não aparecem?

Os comandos registrados globalmente por meio de Routes.applicationCommands() podem levar até uma hora para aparecer no Discord. Para testar, registre-os diretamente em um servidor específico usando Routes.applicationGuildCommands().

Aprenda passo a passo a criar seu próprio bot do Discord com JavaScript e discord.js e fazer o deploy no ZapX.

10 de novembro de 20263 min de leitura0 visualizações0 útil

Introdução

Neste guia, você vai criar seu próprio bot do Discord do zero usando JavaScript e a biblioteca discord.js. Você vai registrar o aplicativo do bot no Discord Developer Portal, escrever uma estrutura básica funcional com um comando de barra personalizado e, em seguida, fazer o deploy do bot no ZapX Discord Bot Hosting. Ter conhecimentos básicos de JavaScript/Node.js é útil, mas não é obrigatório.

Preparação

Antes de começar a escrever o código, você precisa criar um aplicativo de bot no Discord:

Acesse o Discord Developer Portal e clique em New Application. Escolha um nome para o seu bot.
No menu à esquerda, acesse a guia Bot. Lá, você encontra o Token do seu bot em Reset Token. Copie o token e guarde-o em segurança: ele permite acesso total ao seu bot e nunca deve ser incluído no código nem compartilhado publicamente.
Na mesma página, em Privileged Gateway Intents, ative a opção Message Content Intent se quiser que seu bot reaja ao conteúdo das mensagens.
Anote também a Application ID, que fica em General Information. Ela será necessária para registrar os comandos de barra.
Acesse a guia OAuth2 → URL Generator. Selecione o escopo bot e também applications.commands, escolha as permissões necessárias para o bot e abra o link gerado para convidá-lo ao seu servidor do Discord.

Escrever o bot em JavaScript

Crie um novo projeto Node.js e instale o discord.js:

bash

npm init -y
npm install discord.js

Crie um arquivo index.js e configure a estrutura básica do seu bot:

javascript

const { Client, GatewayIntentBits, REST, Routes, SlashCommandBuilder } = require("discord.js");

const client = new Client({
  intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildMessages, GatewayIntentBits.MessageContent],
});

const commands = [
  new SlashCommandBuilder().setName("hallo").setDescription("Begrüßt dich mit einer kurzen Nachricht"),
].map((command) => command.toJSON());

const rest = new REST({ version: "10" }).setToken(process.env.DISCORD_TOKEN);

client.once("ready", async () => {
  await rest.put(Routes.applicationCommands(client.user.id), { body: commands });
  console.log(`Bot ist online als ${client.user.tag}`);
});

client.on("interactionCreate", async (interaction) => {
  if (!interaction.isChatInputCommand()) return;
  if (interaction.commandName === "hallo") {
    await interaction.reply(`Hallo ${interaction.user}!`);
  }
});

client.login(process.env.DISCORD_TOKEN);

O token não é incluído como texto fixo no código. Em vez disso, ele é lido por meio da variável de ambiente DISCORD_TOKEN (process.env.DISCORD_TOKEN). Assim, o token fica fora do código, o que também é importante para a etapa de deploy mais adiante.

Se quiser que o bot também reaja quando novos membros entrarem no servidor, por exemplo, enviando uma mensagem de boas-vindas, adicione outro manipulador de eventos e o intent GatewayIntentBits.GuildMembers:

javascript

client.on("guildMemberAdd", (member) => {
  const channel = member.guild.channels.cache.find((c) => c.name === "willkommen");
  if (channel) {
    channel.send(`Willkommen auf dem Server, ${member}!`);
  }
});

Fazer o deploy do bot no ZapX Discord Bot Hosting

Crie um novo serviço de bot do Discord no painel de cliente ZapX, caso ainda não tenha feito isso.
Durante a configuração, selecione Node.js como runtime (versão LTS mais recente).
Envie os arquivos index.js e package.json (com a dependência discord.js) para o diretório do serviço usando o gerenciador de arquivos integrado ou o recurso de upload de arquivos.

Gerenciador de arquivos do bot do Discord no ZapX

Na guia Einstellungen, em Bot-Konfiguration → Discord Bot Token, insira o token do bot que você criou anteriormente e salve as configurações. Assim, o token fica separado do código e não precisa ser alterado em um novo upload. No código, esse valor continua disponível como a variável de ambiente DISCORD_TOKEN.

Configurações do bot do Discord no ZapX com o campo do token

5. Inicie o serviço. Se tudo estiver funcionando corretamente, o log mostrará Bot ist online als ... e o bot aparecerá como "Online" no seu servidor do Discord.

Solução de problemas

O bot continua offline: Verifique se o token está configurado corretamente na variável de ambiente DISCORD_TOKEN e se há alguma mensagem de erro no log do serviço.

Os comandos de barra não aparecem: Os comandos registrados globalmente por meio de Routes.applicationCommands() podem levar até uma hora para aparecer no Discord. Para testar, registre os comandos diretamente em um servidor específico usando Routes.applicationGuildCommands(). Assim, eles ficam disponíveis imediatamente.

Erro "Missing Access" ou outros erros de permissão: O bot não tem as permissões necessárias no servidor. Verifique as permissões de cargo do bot e confirme se as permissões adequadas foram selecionadas no OAuth2 URL Generator durante o convite.

Conclusão

Agora você criou um bot funcional do Discord com discord.js, adicionou um comando de barra personalizado e fez o deploy no ZapX Discord Bot Hosting. A partir daqui, você pode ampliar o bot como quiser, adicionando outros comandos, recursos de moderação ou integrações.

FAQ

Perguntas frequentes

Você precisa criar um aplicativo de bot no Discord Developer Portal: crie uma New Application, acesse a guia Bot para obter o token em 'Reset Token', anote a Application ID em General Information e gere o link de convite no OAuth2 URL Generator com os escopos 'bot' e 'applications.commands'.

O token não é incluído diretamente no código. Ele é lido pela variável de ambiente DISCORD_TOKEN ('process.env.DISCORD_TOKEN'). No ZapX Discord Bot Hosting, insira-o na guia Einstellungen, em Bot-Konfiguration -> Discord Bot Token.

Node.js (versão LTS mais recente).

Feedback

Este artigo foi útil?

Sua opinião nos ajuda a definir prioridades e a melhorar os conteúdos.

0 de 0 As avaliações consideraram este artigo útil.

Ajuda personalizada

As instruções não são suficientes?

A nossa equipe de suporte da ZAP conhece seu produto — descreva brevemente seu problema e ajudaremos pessoalmente.

const { Client, GatewayIntentBits, REST, Routes, SlashCommandBuilder } = require("discord.js"); const client = new Client({ intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildMessages, GatewayIntentBits.MessageContent], }); const commands = [ new SlashCommandBuilder().setName("hallo").setDescription("Begrüßt dich mit einer kurzen Nachricht"), ].map((command) => command.toJSON()); const rest = new REST({ version: "10" }).setToken(process.env.DISCORD_TOKEN); client.once("ready", async () => { await rest.put(Routes.applicationCommands(client.user.id), { body: commands }); console.log(`Bot ist online als ${client.user.tag}`); }); client.on("interactionCreate", async (interaction) => { if (!interaction.isChatInputCommand()) return; if (interaction.commandName === "hallo") { await interaction.reply(`Hallo ${interaction.user}!`); } }); client.login(process.env.DISCORD_TOKEN);

client.on("guildMemberAdd", (member) => { const channel = member.guild.channels.cache.find((c) => c.name === "willkommen"); if (channel) { channel.send(`Willkommen auf dem Server, ${member}!`); } });

Quais 🍪 cookies você aceita?

Como programar seu próprio bot do Discord com discord.js

Introdução

Preparação

Escrever o bot em JavaScript

Fazer o deploy do bot no ZapX Discord Bot Hosting

Solução de problemas

Conclusão

Perguntas frequentes

Bot do Discord

Preparação

Escrever o bot em JavaScript

Fazer o deploy do bot no ZapX Discord Bot Hosting

Solução de problemas

Conclusão

Servidor de jogos

Servidores e hospedagem

ZAPX

Recursos

ZAP-Hosting