Créer un bot Discord en JavaScript est relativement simple grâce à la bibliothèque discord.js, qui est un module Node.js utilisé pour interagir avec l’API Discord. Ce guide détaillé vous aidera à créer et à déployer un bot Discord basique en JavaScript.

Prérequis

1. Node.js : Assurez-vous que Node.js est installé sur votre machine. Vous pouvez le télécharger depuis nodejs.org.
2. Un compte Discord : Vous devez avoir un compte Discord et un serveur Discord où vous pouvez tester le bot.
3. Un token de bot : Vous devez créer un bot dans le portail de développement Discord et obtenir un token pour l’authentification du bot.

Étapes de création du bot Discord

1. Créer une nouvelle application Discord et un bot

1. Rendez-vous sur le portail de développeurs Discord.
2. Cliquez sur « New Application » pour créer une nouvelle application.
3. Donnez un nom à votre application (par exemple, « MonBot »).
4. Allez dans l’onglet « Bot » à gauche et cliquez sur « Add Bot ».
5. Sous « Token », cliquez sur « Copy » pour obtenir votre token de bot. Gardez-le dans un endroit sûr, car vous en aurez besoin dans votre code.

2. Créer un répertoire pour le bot

Sur votre machine, créez un répertoire pour votre projet et ouvrez un terminal dans ce répertoire.

bashCopierModifiermkdir mon-bot-discord
cd mon-bot-discord

3. Initialiser un projet Node.js

Exécutez la commande suivante pour initialiser un projet Node.js dans votre répertoire.

bashCopierModifiernpm init -y

Cela crée un fichier package.json avec les valeurs par défaut.

4. Installer discord.js

Ensuite, installez la bibliothèque discord.js via npm :

bashCopierModifiernpm install discord.js

Cela ajoutera la bibliothèque à votre projet.

5. Créer un fichier de bot (index.js)

Dans votre répertoire de projet, créez un fichier appelé index.js. Ce fichier contiendra le code principal du bot.

Exemple de code de bot Discord

Voici un code simple pour créer un bot Discord qui répond à un message.

javascriptCopierModifier// Importer la bibliothèque discord.js
const { Client, GatewayIntentBits } = require('discord.js');

// Créer une instance du client
const client = new Client({
    intents: [
        GatewayIntentBits.Guilds,
        GatewayIntentBits.GuildMessages,
        GatewayIntentBits.MessageContent
    ]
});

// L'événement 'ready' est déclenché lorsque le bot se connecte
client.once('ready', () => {
    console.log('Le bot est connecté et prêt à fonctionner !');
});

// L'événement 'messageCreate' est déclenché lorsqu'un message est envoyé dans un serveur
client.on('messageCreate', message => {
    // Ignorer les messages envoyés par le bot lui-même
    if (message.author.bot) return;

    // Si le message contient "bonjour", répondre avec "Salut !"
    if (message.content.toLowerCase() === 'bonjour') {
        message.reply('Salut ! Comment ça va ?');
    }
});

// Se connecter avec le token du bot
client.login('VOTRE_TOKEN_ICI');

Explication du code :

1. Client : Crée une instance du client Discord. Le client est la connexion du bot à l’API Discord.
2. GatewayIntentBits : Ce sont des intentions qui indiquent quelles informations le bot souhaite recevoir. Ici, le bot reçoit des informations sur les serveurs (guildes), les messages et le contenu des messages.
3. client.once(‘ready’, …) : L’événement ready est déclenché lorsque le bot se connecte et est prêt.
4. client.on(‘messageCreate’, …) : L’événement messageCreate se déclenche à chaque fois qu’un message est envoyé dans un serveur. Le bot répond au message « bonjour » avec « Salut ! Comment ça va ? ».
5. client.login(‘VOTRE_TOKEN_ICI’) : Le bot se connecte à Discord avec le token du bot que vous avez copié.

6. Exécuter le bot

Avant d’exécuter le bot, assurez-vous de remplacer 'VOTRE_TOKEN_ICI' par le token réel que vous avez obtenu lors de la création du bot dans le portail Discord.

Pour exécuter le bot, utilisez la commande suivante dans votre terminal :

bashCopierModifiernode index.js

Le bot devrait maintenant être en ligne et prêt à répondre sur Discord. Si vous tapez « bonjour » dans le serveur où le bot est présent, il devrait répondre avec « Salut ! Comment ça va ? ».

7. Inviter le bot sur votre serveur Discord

Pour inviter votre bot sur un serveur Discord, vous devez générer un lien d’invitation.

1. Allez dans le portail de développement Discord.
2. Sélectionnez votre application (votre bot).
3. Allez dans l’onglet « OAuth2 ».
4. Sous « OAuth2 URL Generator », cochez « bot » dans les scopes et « Send Messages », « Read Message History », et d’autres permissions selon vos besoins.
5. Copiez l’URL générée et ouvrez-la dans un navigateur pour inviter le bot sur votre serveur Discord.

8. Ajouter des fonctionnalités au bot

À ce stade, vous avez un bot de base qui répond à un simple message. Cependant, vous pouvez ajouter plus de fonctionnalités comme des commandes, des réactions à des événements spécifiques (par exemple, rejoindre un serveur, etc.), ou encore intégrer des API externes.

Voici un exemple d’une commande plus avancée avec des arguments :

javascriptCopierModifierclient.on('messageCreate', message => {
    if (message.author.bot) return;

    // Commande simple pour afficher l'heure
    if (message.content.toLowerCase() === '!heure') {
        const currentDate = new Date();
        message.reply(`Il est actuellement ${currentDate.toLocaleTimeString()}`);
    }
});

9. Gérer les erreurs et les logs

Il est important de gérer les erreurs et de loguer les actions de votre bot pour pouvoir déboguer facilement en cas de problème.

Voici un exemple simple de gestion des erreurs :

javascriptCopierModifierclient.on('error', (error) => {
    console.error('Erreur du bot:', error);
});

Conclusion

Félicitations ! Vous avez créé un bot Discord simple en JavaScript avec discord.js. Vous pouvez maintenant l’étendre avec de nombreuses fonctionnalités, comme des commandes avancées, des interactions plus complexes, et bien plus encore. Discord.js est une bibliothèque très flexible et permet d’ajouter une grande variété de fonctionnalités à vos bots.