Quali file devo caricare per il mio bot discord.js?

Carica index.js e package.json (per la dipendenza discord.js) nella directory del servizio, tramite il file manager integrato o caricando i file.

Perché i miei comandi Slash non vengono visualizzati?

I comandi registrati globalmente con Routes.applicationCommands() possono impiegare fino a un'ora per comparire ovunque su Discord. Per testarli subito, registrali su un singolo server con Routes.applicationGuildCommands().

Programmare un bot Discord personalizzato con discord.js

Q: Come risolvo l'errore "Missing Access" o altri problemi di autorizzazione?

Controlla i permessi dei ruoli del bot e verifica che durante l'invito siano stati selezionati i permessi corretti nel generatore di URL OAuth2.

Crea passo dopo passo un bot Discord con JavaScript e discord.js e distribuiscilo su ZapX.

10 novembre 20263 min di lettura0 Visualizzazioni0 utile

Introduzione

In questa guida creerai da zero un bot Discord con JavaScript e la libreria discord.js. Registrerai l'applicazione del bot nel Discord Developer Portal, scriverai una struttura di base funzionante con un comando Slash personalizzato e infine distribuirai il bot su ZapX Discord Bot Hosting. È utile avere conoscenze di base di JavaScript/Node.js, ma non sono indispensabili.

Preparazione

Prima di iniziare a scrivere il codice, ti serve un'applicazione bot su Discord:

Apri il Discord Developer Portal e fai clic su New Application. Assegna un nome al tuo bot.
Nel menu a sinistra, vai alla scheda Bot. Qui puoi trovare il Token del bot tramite Reset Token. Copia il token e conservalo in un luogo sicuro: consente l'accesso completo al tuo bot e non deve mai essere inserito nel codice né condiviso pubblicamente.
Nella stessa pagina, sotto Privileged Gateway Intents, attiva Message Content Intent se vuoi che il bot reagisca ai contenuti dei messaggi.
Inoltre, prendi nota della Application ID in General Information: ti servirà per registrare i comandi Slash.
Vai alla scheda OAuth2 → URL Generator. Seleziona lo scope bot e anche applications.commands; poi seleziona i permessi necessari al bot e apri il link generato per invitarlo sul tuo server Discord.

Scrivere il bot in JavaScript

Crea un nuovo progetto Node.js e installa discord.js:

bash

npm init -y
npm install discord.js

Crea un file index.js e imposta la struttura di base del 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);

Il token non viene inserito nel codice come testo statico, ma viene letto tramite la variabile d'ambiente DISCORD_TOKEN (process.env.DISCORD_TOKEN). In questo modo il token resta separato dal codice, una condizione necessaria per il passaggio di distribuzione descritto più avanti.

Se vuoi anche far reagire il bot quando nuovi membri entrano nel server, ad esempio con un messaggio di benvenuto, aggiungi un altro gestore di eventi e l'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}!`);
  }
});

Distribuire il bot su ZapX Discord Bot Hosting

Se non l'hai già fatto, crea un nuovo servizio Discord Bot nel pannello clienti ZapX.
Durante la configurazione, seleziona Node.js come runtime (versione LTS più recente).
Carica index.js e package.json (per la dipendenza discord.js) nella directory del servizio tramite il file manager integrato o caricando i file.

Nella scheda Impostazioni, inserisci il token del bot che hai generato in precedenza in Configurazione bot → Discord Bot Token e salva le impostazioni. In questo modo il token resta separato dal codice e non dovrai modificarlo quando carichi nuovamente i file. Nel codice continuerai a poterlo usare come variabile d'ambiente DISCORD_TOKEN.

Impostazioni di ZapX Discord Bot con il campo del token

5. Avvia il servizio. Se tutto funziona correttamente, nel log comparirà il messaggio Bot ist online als ... e il bot risulterà "Online" sul tuo server Discord.

Risoluzione dei problemi

Il bot resta offline: verifica che il token sia impostato correttamente nella variabile d'ambiente DISCORD_TOKEN e controlla se nel log del servizio compare un messaggio di errore.

I comandi Slash non vengono visualizzati: i comandi registrati globalmente tramite Routes.applicationCommands() possono impiegare fino a un'ora prima di essere visualizzati ovunque su Discord. Per eseguire una prova, registrali direttamente su un singolo server tramite Routes.applicationGuildCommands(), così saranno disponibili subito.

Errore "Missing Access" o altri errori di autorizzazione: il bot non dispone dei permessi necessari sul server. Controlla i permessi dei ruoli del bot e verifica che, durante l'invito, siano stati selezionati i permessi corretti in OAuth2 URL Generator.

Conclusione

Ora hai creato un bot Discord funzionante con discord.js, lo hai dotato di un comando Slash personalizzato e lo hai distribuito su ZapX Discord Bot Hosting. Da qui puoi ampliarlo con altri comandi, funzioni di moderazione o integrazioni.

FAQ

Domande frequenti

Un'applicazione bot nel Discord Developer Portal. Crea una New Application, recupera il token nella scheda Bot tramite 'Reset Token', annota la Application ID in General Information e genera il link d'invito nel generatore di URL OAuth2, selezionando gli scope 'bot' e 'applications.commands'.

Il token viene letto tramite la variabile d'ambiente DISCORD_TOKEN ('process.env.DISCORD_TOKEN'), anziché essere inserito nel codice. In ZapX Discord Bot Hosting, inseriscilo nella scheda Impostazioni, in Configurazione bot → Discord Bot Token.

Node.js (versione LTS più recente).

Feedback

Questo articolo ti è stato utile?

Il tuo feedback ci aiuta a definire le priorità e a migliorare i contenuti.

0 di 0 I feedback hanno giudicato utile questo articolo.

Assistenza personale

Le istruzioni non sono sufficienti?

Il supporto ZAP conosce il tuo prodotto: descrivi brevemente la tua richiesta e ti aiuteremo personalmente.

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}!`); } });

Quali 🍪 cookie desideri consentire?

Programmare un bot Discord personalizzato con discord.js

Introduzione

Preparazione

Scrivere il bot in JavaScript

Distribuire il bot su ZapX Discord Bot Hosting

Risoluzione dei problemi

Conclusione

Domande frequenti

Bot Discord

Preparazione

Scrivere il bot in JavaScript

Distribuire il bot su ZapX Discord Bot Hosting

Risoluzione dei problemi

Conclusione

Server di gioco

Server e hosting

ZAPX

Risorse

ZAP-Hosting