Les bots Discord sont de toutes formes et de toutes tailles et peuvent être utilisés pour un large éventail d'objectifs allant de la modération du comportement des utilisateurs sur votre serveur, en passant par l'administration automatique de sanctions telles que la mise en sourdine ou l'interdiction des joueurs qui sortent de la ligne, jusqu'au jeu de la musique pour le plaisir de tous.
Les instructions ci-dessous supposent que vous avez déjà un compte et un serveur Discord en place. Sinon, vous devez le configurer sur discordapp.com avant de continuer.
Bien que les bots Discord soient écrits en langage JavaScript, vous n'avez pas besoin d'être un codeur expérimenté pour les créer. En fait, le processus est beaucoup moins intimidant que vous ne l'imaginez. Continuez à lire pour apprendre à créer un bot Discord qui répond à vos attentes.
Ce tutoriel est destiné aux utilisateurs exécutant les systèmes d'exploitation macOS ou Windows.
Télécharger et installer Node.js
Avant de commencer à créer un bot Discord, vous devez d'abord installer Node.js, un environnement d'exécution JavaScript basé sur le moteur V8 de Google Chrome.
-
Ouvrez un navigateur Web et accédez à la page de téléchargement officielle de Node.js.
Image - Sélectionnez le package d'installation approprié pour votre plate-forme particulière (macOS ou Windows) et cliquez sur son lien de téléchargement.
- Ouvrez le fichier téléchargé et suivez les invites à l'écran pour installer Node.js.
- Une fois terminé, lancez l'application Invite de commandes (Windows) ou Terminal (macOS).
-
Tapez le texte suivant à l'invite et appuyez sur Entrée sur votre clavier: node -v
Image - Si un numéro de version est renvoyé, alors Node.js est installé correctement. Si ce n'est pas le cas, reprenez les étapes ci-dessus et assurez-vous que l'installation est terminée.
Créer une application Discord
Maintenant que vous avez éliminé les prérequis, il est temps de créer une nouvelle application à laquelle votre bot pourra être ajouté ultérieurement.
- Ouvrez un navigateur et accédez au portail des développeurs Discord pour votre serveur, en vous connectant si nécessaire.
-
Cliquez Nouvelle application.
Image -
Entrez un nom pour votre nouvelle application dans le champ d'édition fourni et cliquez sur Créer lorsque vous êtes prêt.
Image -
L'écran d'informations générales de votre nouvelle application devrait maintenant s'afficher, comme illustré dans la capture d'écran ci-jointe. Sélectionnez Bot, trouvé dans le volet de menu de gauche.
Image -
Cliquez Ajouter un robot.
Image -
Un message apparaîtra maintenant, vous demandant si vous êtes sûr de vouloir ajouter un bot à votre application. Cliquez sur Oui, faites-le !
Image -
Votre nouveau bot devrait maintenant être créé, avec ses informations et ses options affichées dans la section BUILD-A-BOT. Sélectionnez Cliquez pour révéler le jeton.
Image -
Une longue chaîne de caractères devrait maintenant être affichée à la place du lien susmentionné. Cliquez sur Copier pour envoyer ce jeton dans votre presse-papiers.
Image -
Collez ce jeton dans un fichier texte pour l'instant en utilisant le Bloc-notes, TextEdit ou une application similaire.
Vous devez supprimer ce fichier et le retirer de votre corbeille ou de votre corbeille une fois que vous avez terminé ce didacticiel.
Coder votre bot
Vous avez créé un bot et l'avez ajouté à votre serveur. Vient ensuite la partie amusante, en fait coder votre bot pour qu'il fasse ce que vous voulez.
- Lancez l'application Invite de commandes (Windows) ou Terminal (macOS).
-
Tapez le texte suivant à l'invite et appuyez sur Enter ou Return sur votre clavier: mkdir discord-test -bot
Image Vous pouvez remplacer discord-test-bot par le nom de votre choix.
-
Ensuite, tapez la commande suivante pour naviguer dans votre répertoire nouvellement créé: cd discord-test-bot
Image -
L'invite de commande devrait maintenant être mise à jour, affichant le nom du dossier de projet du dossier de votre bot. Tapez ce qui suit et appuyez sur Entrée ou Retour: npm init -y
Image -
Un fichier nommé package.json doit maintenant être créé dans votre dossier de projet, comme indiqué dans la capture d'écran ci-dessus. Tapez ce qui suit à l'invite de commande et appuyez sur Entrée ou Retour: npm install --save discord.js
Image -
Une liste de messages d'AVERTISSEMENT peut maintenant être affichée, qui peut être ignorée tant qu'il n'y a pas d'erreurs (ERR) affichées et que le message vers le bas de votre invite de commande ou de la fenêtre du terminal indique "7 packages ajoutés" ou "ajouté 8 paquets". Tapez ce qui suit et appuyez sur Entrée ou Retour pour créer le fichier auth.json: touch auth.json
Image Si vous recevez un message d'erreur lorsque vous essayez d'utiliser la commande touch, vous devrez peut-être d'abord l'installer en saisissant la syntaxe suivante à l'invite de commande: npm install touch-cli -g
-
Il y aura un message de confirmation indiquant que ce fichier a été créé, mais vous pouvez taper ls -al (macOS) ou dir (Windows) pour voir le contenu de votre répertoire de projet et confirmer par vous-même que auth.json est bien répertorié.
Image - Lancez votre éditeur de code ou de texte préféré tel que Atom, Notepad ou TextEdit, et accédez à votre nouveau dossier de projet.
-
Ouvrez le fichier auth.json et entrez le texte affiché dans la capture d'écran ci-jointe, en remplaçant AUTH-TOKEN par la chaîne de jeton d'authentification que vous avez stockée précédemment dans le didacticiel. Enregistrez le fichier lorsque vous avez terminé.
Image Vous devez copier et coller la chaîne d'authentification entière entre les guillemets affichés. S'il vous manque ne serait-ce qu'un seul caractère, votre bot ne fonctionnera pas comme prévu.
- Retournez à l'éditeur et créez un nouveau fichier dans votre dossier de projet nommé bot.js.
-
Le fichier bot.js contiendra le code qui dicte le comportement de votre bot, qui dépend entièrement de vous. Pour les besoins de ce didacticiel, cependant, nous vous recommandons d'utiliser le code suivant et de tester votre bot de bout en bout pour vous assurer que tout fonctionne comme prévu. Vous pouvez ensuite revenir en arrière et modifier le contenu de bot.js comme bon vous semble.
const Discord=require('discord.js');
const client=new Discord. Client();
const auth=require('./auth.json');
client.on('prêt', ()=> {
console.log(`Connecté en tant que ${client.user.tag}!`);
});
client.on('message', msg=> {
if (msg.content===‘bonjour’) {
msg.reply('salut !');
}
});
client.login(auth.token);
Cet exemple de code écrira un message dans la console de ligne de commande lorsque le bot sera appelé, confirmant une connexion réussie et contenant votre tag d'utilisateur.
- Enregistrez votre fichier mis à jour bot.js.
- Retournez à l'invite de commande ou au terminal et tapez ce qui suit pour exécuter votre script de bot: node bot.js
- Si vous avez tout fait correctement jusqu'à présent, le texte suivant devrait apparaître dans votre invite de commande ou votre fenêtre de terminal: Connecté en tant que discord-test-bot
Intégrez le code du bot avec votre serveur
Vous y êtes presque…
- Ouvrez un navigateur et accédez au portail des développeurs Discord pour votre serveur, en vous connectant si nécessaire.
-
Sélectionnez l'application que nous avons créée précédemment à partir de l'écran MES APPLICATIONS, si vous y êtes invité.
Image -
Cliquez sur OAuth2, situé dans le volet de menu de gauche.
Image -
Faites défiler vers le bas de l'écran jusqu'à ce que vous trouviez la section SCOPES. Placez une coche à côté de l'option bot en cliquant dessus une fois.
Image -
Faites défiler à nouveau jusqu'à la section BOT PERMISSIONS, en plaçant des coches à côté de chaque type d'autorisation dont votre bot individuel pourrait avoir besoin pour fonctionner comme prévu. Pour les besoins de cet exemple de bot, nous avons besoin des autorisations suivantes: Envoyer des messages, Lire l'historique des messages
Image Votre bot particulier aura probablement besoin d'un ensemble d'autorisations très différent. Il est important de comprendre ce que chaque autorisation implique avant de l'activer, afin que les utilisateurs de robots ne puissent pas l'exploiter à des fins malveillantes.
-
Cliquez sur Copier, situé entre les sections SCOPES et BOT PERMISSIONS et accompagné d'une longue URL.
Image - Ouvrez un nouvel onglet de navigateur et collez cette URL dans la barre d'adresse, en appuyant sur Enter ou Return pour charger la page.
-
L'interface CONNECT TO DISCORD devrait maintenant être affichée, comme indiqué dans la capture d'écran ci-jointe. Cliquez sur Select a server et choisissez le nom de votre serveur dans la liste fournie.
Image -
Cliquez Autoriser.
Image -
Placez une coche à côté de Je ne suis pas un robot en cliquant une fois sur sa case à cocher.
Image -
Un message de confirmation devrait maintenant s'afficher, notant que votre bot est autorisé et a été ajouté à votre serveur.
Image
Comment tester votre bot sur le serveur
Vous pouvez tester votre bot en lançant le client Discord et en lui envoyant des commandes ou des messages correspondant à votre code particulier. Dans cet exemple, envoyez le mot hello à votre bot et il devrait répondre par hi!
