I robot Discord sono disponibili in tutte le forme e dimensioni e possono essere utilizzati per un'ampia gamma di scopi che vanno dalla moderazione del comportamento degli utenti sul server, all'assegnazione automatica di punizioni come l'esclusione dell'audio o il divieto di giocatori che escono dalla linea, al gioco musica per il divertimento di tutti.
Le istruzioni seguenti presuppongono che tu abbia già un account Discord e un server in atto. In caso contrario, dovresti configurarlo su discordapp.com prima di continuare.
Mentre i robot Discord sono scritti nel linguaggio JavaScript, non è necessario essere un programmatore esperto per crearli. In effetti, il processo è molto meno intimidatorio di quanto potresti immaginare. Continua a leggere per scoprire come creare un robot Discord che soddisfi le tue richieste.
Questo tutorial è destinato agli utenti che eseguono sistemi operativi macOS o Windows.
Scarica e installa Node.js
Prima di iniziare con la creazione di bot Discord, devi installare Node.js, un ambiente di runtime JavaScript basato sul motore V8 di Google Chrome.
-
Apri un browser web e vai alla pagina di download ufficiale di Node.js.
-
Seleziona il pacchetto di installazione appropriato per la tua piattaforma particolare (macOS o Windows) e fai clic sul relativo link per il download.
- Apri il file scaricato e segui le istruzioni sullo schermo per installare Node.js.
- Una volta completato, avvia l'applicazione Prompt dei comandi (Windows) o Terminal (macOS).
-
Digita il seguente testo al prompt e premi Invio sulla tastiera: node -v
- Se viene restituito un numero di versione, Node.js è installato correttamente. In caso contrario, rivedere i passaggi precedenti e assicurarsi che l'installazione sia completata.
Crea un'applicazione Discord
Ora che hai eliminato i prerequisiti, è il momento di creare una nuova applicazione a cui il tuo bot può essere aggiunto in seguito.
- Apri un browser e vai al Portale per sviluppatori Discord per il tuo server, effettuando l'accesso se necessario.
-
Fai clic su Nuova applicazione.
-
Inserisci un nome per la tua nuova applicazione nel campo di modifica fornito e fai clic su Crea quando sei pronto.
-
Ora dovrebbe essere visualizzata la schermata Informazioni generali per la tua nuova applicazione, come mostrato nella schermata di accompagnamento. Seleziona Bot, che si trova nel riquadro del menu a sinistra.
-
Fai clic su Aggiungi bot.
-
Ora apparirà un messaggio che ti chiederà se sei sicuro di voler aggiungere un bot alla tua applicazione. Fai clic su Sì, fallo!
-
Il tuo nuovo bot dovrebbe ora essere creato, con le sue informazioni e opzioni visualizzate nella sezione BUILD-A-BOT. Seleziona Fai clic per rivelare il token.
-
Ora dovrebbe essere visualizzata una lunga stringa di caratteri al posto del collegamento sopra menzionato. Fai clic su Copia per inviare questo token agli appunti.
-
Incolla questo token in un file di testo per ora usando Blocco note, TextEdit o un'applicazione simile.
Dovresti eliminare questo file e rimuoverlo dal Cestino o dal Cestino una volta completato questo tutorial.
Codifica del tuo bot
Hai creato un bot e l'hai aggiunto al tuo server. Poi arriva la parte divertente, codificare effettivamente il tuo bot per fare ciò che vuoi.
- Avvia l'applicazione Prompt dei comandi (Windows) o Terminal (macOS).
-
Digita il seguente testo al prompt e premi Enter o Return sulla tastiera: mkdir discord-test -bot
Puoi sostituire discord-test-bot con un nome a tua scelta.
-
Successivamente, digita il seguente comando per attraversare la directory appena creata: cd discord-test-bot
-
Il prompt dei comandi ora dovrebbe essere aggiornato, visualizzando il nome della cartella del progetto della cartella del tuo bot. Digita quanto segue e premi Invio o Invio: npm init -y
-
Un file chiamato package.json dovrebbe ora essere creato nella cartella del tuo progetto, come mostrato nella schermata sopra. Digita quanto segue al prompt dei comandi e premi Invio o Invio: npm install --save discord.js
-
Può ora essere visualizzato un elenco di messaggi WARN, che possono essere ignorati fintanto che non vengono visualizzati errori (ERR) e il messaggio nella parte inferiore del prompt dei comandi o della finestra del terminale riporta "7 pacchetti aggiunti" o "aggiunti 8 pacchetti". Digita quanto segue e premi Invio o Invio per creare il file auth.json: touch auth.json
Se viene visualizzato un messaggio di errore quando si tenta di utilizzare il comando touch, potrebbe essere necessario prima installarlo inserendo la seguente sintassi al prompt dei comandi: npm install touch-cli -g
-
Verrà visualizzato un messaggio di conferma che informa che questo file è stato creato, ma puoi digitare ls -al (macOS) o dir (Windows) per vedere il contenuto della directory del tuo progetto e confermare tu stesso che auth.json è effettivamente elencato.
- Avvia il tuo codice preferito o editor di testo come Atom, Notepad o TextEdit e vai alla cartella del tuo nuovo progetto.
-
Apri il file auth.json e inserisci il testo mostrato nella schermata di accompagnamento, sostituendo AUTH-TOKEN con la stringa del token di autenticazione che hai memorizzato in precedenza nel tutorial. Salva il file al termine.
Devi devi copiare e incollare l'intera stringa di autenticazione tra virgolette mostrate. Se ti manca anche un solo personaggio, il tuo bot non funzionerà come previsto.
- Torna all'editor e crea un nuovo file nella cartella del tuo progetto chiamato bot.js.
-
Il file bot.js conterrà il codice che determina il comportamento del tuo bot, che dipende completamente da te. Ai fini di questo tutorial, tuttavia, ti consigliamo di usare il codice seguente e di testare il tuo bot end-to-end per assicurarti che tutto funzioni come previsto. Puoi quindi tornare indietro e modificare il contenuto di bot.js come meglio credi.
const Discord=require('discord.js');
const client=new Discord. Client();
const auth=require('./auth.json');
client.on('pronto', ()=> {
console.log(`Acceduto come ${client.user.tag}!`);
});
client.on('messaggio', msg=> {
if (msg.content==='ciao') {
msg.reply('ciao!');
}
});
client.login(auth.token);
Questo codice di esempio scriverà un messaggio sulla console della riga di comando quando il bot viene chiamato, confermando un accesso riuscito e contenente il tuo tag utente.
- Salva il file bot.js aggiornato.
- Torna al prompt dei comandi o al terminale e digita quanto segue per eseguire lo script del bot: node bot.js
- Se hai fatto tutto correttamente fino a questo punto, il seguente testo dovrebbe apparire nel tuo prompt dei comandi o nella finestra del terminale: Accesso come discord-test-bot
Integra il codice del bot con il tuo server
Ci sei quasi…
- Apri un browser e vai al Portale per sviluppatori Discord per il tuo server, effettuando l'accesso se necessario.
-
Seleziona l'applicazione che abbiamo creato in precedenza dalla schermata LE MIE APPLICAZIONI, se richiesto.
-
Fai clic su OAuth2, che si trova nel riquadro del menu a sinistra.
-
Scorri fino in fondo allo schermo finché non trovi la sezione SCOPES. Metti un segno di spunta accanto all'opzione bot facendo clic su di essa una volta.
-
Scorri di nuovo verso il basso fino alla sezione AUTORIZZAZIONI BOT, mettendo dei segni di spunta accanto a ciascun tipo di autorizzazione di cui il tuo singolo bot potrebbe aver bisogno per funzionare come previsto. Ai fini di questo esempio di bot, abbiamo bisogno delle seguenti autorizzazioni: Invia messaggi, Leggi cronologia messaggi
Il tuo particolare bot avrà probabilmente bisogno di un set di autorizzazioni significativamente diverso. È importante capire cosa comporta ogni autorizzazione prima di abilitarla, in modo che gli utenti del bot non possano sfruttarla per scopi nefasti.
-
Fai clic su Copia, che si trova tra le sezioni SCOPES e AUTORIZZAZIONI BOT e accompagnato da un lungo URL.
- Apri una nuova scheda del browser e incolla questo URL nella barra degli indirizzi, premendo Invio o Invio per caricare la pagina.
-
L'interfaccia CONNECT TO DISCORD dovrebbe ora essere visualizzata, come mostrato nella schermata di accompagnamento. Fai clic su Seleziona un server e scegli il nome del tuo server dall'elenco fornito.
-
Fai clic su Autorizza.
-
Metti un segno di spunta accanto a Non sono un robot facendo clic sulla relativa casella una volta.
-
Ora dovrebbe essere visualizzato un messaggio di conferma, in cui si nota che il tuo bot è autorizzato ed è stato aggiunto al tuo server.
Come testare il tuo bot sul server
Puoi testare il tuo bot avviando il client Discord e inviandogli comandi o messaggi che corrispondono al tuo codice particolare. In questo esempio, invia la parola ciao al tuo bot e dovrebbe rispondere con ciao!