Skip to main content

Chapitre 4 - Les évènements

Nous rejoindre sur Discord

Définition

Lorsque l'on souhaite interagir avec Discord, notre bot réagi avec un évènement. Il existe deux types d'évènement :

  • once : émet l'évènement une fois que le bot est prêt
  • on : émet dès qu'un évènement est reçu

Que ce soit pour la lecture d'un message ou encore l'utilisation d'une commande, en fonction de l'évènement qu'il reçoit, le bot va utiliser des instructions différentes.

La liste de tous les évènements possibles est présente sur : Discord JS - Client

Structure des évènement

Voici la structure que nous allons utiliser lorsque nous allons créer nos fichiers :

require('log-timestamp'); // Présent sur chaque fichier

module.exports = {
    name: 'event_name', // Nom de l'évènement
    once: true, // once : true | on : false
    async  execute(client, ..args) { // On récupère le client que l'on a envoyé, et on y ajoute les autres paramètres nécessaire
      /**
      * Instruction de l'évènement
      */
    },
};

Lorsque vous voulez écouter un évènement, nous vous conseillons d'appeler le fichier qui le contient de la même manière que son nom afin de vous retrouver facilement.

Évènement - Ready

Le premier évènement que l'on va créer se nomme : ready. Cet évènement se produit une fois que notre bot est prêt (il sera donc de type : once). Jusqu'à maintenant, lorsque l'on démarrait notre bot, voici) quoi ça ressemblait :

Nous allons y ajouter une action :

require('log-timestamp');

module.exports = {
    name: 'ready',
    once: true,
    execute(client) {
        /* Modification du statut de présence */
        client.user.setPresence({
            activities: [{ name: 'Formation Xelyos - Bot Discord' }],
            status: 'online',
        });
    },
};

Évènement - interactionCreate

L'évènement interactionCreate correspond au moment où une commande ou une réaction est utilisée. C'est cet évènement qui va garantir que nos commandes puissent être utilisées. Voici la structure de ce fichier :

require('log-timestamp');

module.exports = {
    name: 'interactionCreate',
    once: false,
    async execute(client, interaction) { // On récupère le client et l'interaction
        /* Commande Slash */
        if (interaction.isChatInputCommand()) { // l'interaction est de type commande
            const command = client.commands.get(interaction.commandName); // On récupère donc la commande correspondant au nom de l'intéraction
            if (!command) return; // Si on ne l'a trouve pas, on ne fait rien
            try {
                await command.execute(interaction, client); // On execute les instructions de notre commande
            } catch (error) {
                /* Une erreur est survenue lors de l'exécution de la commande */
                console.error(interaction.commandName, error);
                await interaction.reply({
                    content: 'There was an error while executing this command!',
                    ephemeral: true,
                });
            }
        }
        /* Commande Slash */

        /* Réponse aux réactions */
        if (interaction.isButton() || interaction.isSelectMenu()) { // Notre réaction est de type button ou menu de sélection
            if (interaction.message.author.id !== client.user.id) return; // On ne réagit pas à nous même
            const reaction = client.reactions.get(interaction.customId);
            if (!reaction) return;
            reaction.execute(interaction, client);
        }
        /* Réponse aux réactions */
    },
};