Vous voulez créer un bot pour animer votre serveur Discord ? Pas de panique, c’est plus simple que ça en a l’air.
Ce guide vous explique comment créer votre propre bot étape par étape, même si vous ne savez pas coder.
Créer un bot Discord : le guide rapide
Il y a deux manières de faire. Soit vous ajoutez un bot déjà fait, soit vous créez le vôtre.
Option 1 : Ajouter un bot qui existe déjà (le plus simple)
Si vous n’avez aucune compétence en programmation, c’est la meilleure solution. Des milliers de bots sont disponibles pour toutes sortes de fonctions.
- Allez sur un site qui liste des bots, comme top.gg.
- Cherchez un bot qui fait ce que vous voulez (musique, modération, jeux).
- Cliquez sur le bouton « Inviter » ou « Add to server ».
- Connectez-vous à votre compte Discord et choisissez le serveur où l’ajouter.
- Donnez-lui les autorisations demandées et c’est tout.
Option 2 : Créer votre propre bot (le résumé)
Si vous voulez un contrôle total et des fonctions sur mesure, vous devez créer votre bot. Voici les grandes étapes :
- Activez le mode développeur sur votre compte Discord.
- Allez sur le Portail des développeurs Discord (aussi appelé Discord API).
- Créez une « Nouvelle application ».
- Dans l’application, allez dans l’onglet « Bot » et générez un bot utilisateur.
- Copiez son « token » (une clé secrète).
- Générez un lien d’invitation dans l’onglet « OAuth2 » pour l’ajouter à votre serveur.
- Programmez le bot en utilisant son token pour qu’il se connecte et réagisse.
Guide complet : créer votre propre bot Discord de A à Z
Maintenant, voyons chaque étape en détail. Ce guide est pensé pour les débutants. On va créer un bot simple qui répond aux messages.
Les prérequis indispensables
Avant de commencer, assurez-vous d’avoir tout ce qu’il faut. C’est rapide et ça vous évitera des blocages.
Voici ce dont vous aurez besoin :
- Un compte Discord : C’est la base, évidemment.
- Un serveur Discord : Vous devez être propriétaire ou administrateur d’un serveur pour pouvoir y ajouter un bot et faire vos tests.
- Des bases en programmation : Il faut connaître un minimum de code. Les langages les plus courants pour les bots Discord sont JavaScript (avec NodeJS) et Python. Pour ce guide, on utilisera JavaScript.
- Un environnement de développement : Il vous faut un logiciel pour écrire du code. Des éditeurs de texte comme Visual Studio Code ou Atom sont gratuits et parfaits pour ça.
Étape 1 : Créer l’application sur le portail des développeurs Discord
La première étape est de déclarer votre bot auprès de Discord. Tout se passe sur leur portail dédié aux développeurs.
Suivez ces instructions :
- Rendez-vous sur le Portail des développeurs Discord et connectez-vous avec votre compte.
- Cliquez sur le bouton « New Application » en haut à droite.
- Donnez un nom à votre application. Ce nom sera visible par les utilisateurs, alors choisissez quelque chose de clair. Acceptez les conditions d’utilisation et cliquez sur « Create ».
- Une fois l’application créée, vous arrivez sur sa page de configuration. Dans le menu de gauche, cliquez sur l’onglet « Bot ».
- Cliquez sur le bouton « Add a Bot ». Confirmez en cliquant sur « Yes, do it! ». Ça y est, votre application a maintenant un utilisateur bot associé.
- Sur cette même page, vous verrez le nom de votre bot et une option pour copier son « Token ». Cliquez sur « Reset Token » ou « View Token » pour l’afficher, puis copiez-le.
Attention : Le token est la clé secrète de votre bot. C’est comme son mot de passe. Ne le partagez JAMAIS publiquement, sinon n’importe qui pourrait prendre le contrôle de votre bot.
Étape 2 : Inviter votre bot sur un serveur
Votre bot existe, mais pour l’instant il n’est connecté nulle part. Il faut l’inviter sur votre serveur de test.
Pour ça, on va générer une URL d’invitation spéciale :
- Dans le menu de gauche, allez dans l’onglet « OAuth2 », puis dans le sous-menu « URL Generator ».
- Dans la section « Scopes », cochez la case « bot ». C’est ce qui indique que l’URL sert à inviter un bot.
- Une nouvelle section « Bot Permissions » apparaît en dessous. C’est ici que vous choisissez ce que votre bot a le droit de faire. Pour commencer, cochez simplement « Send Messages » (Envoyer des messages).
- En bas de la page, une URL a été générée. Copiez cette URL.
- Collez l’URL dans la barre d’adresse de votre navigateur et validez.
- Discord vous demandera sur quel serveur vous voulez ajouter le bot. Choisissez votre serveur de test dans la liste déroulante et cliquez sur « Continuer ».
- Confirmez les autorisations que vous avez définies et validez le captcha.
Votre bot est maintenant sur votre serveur ! Vous le verrez dans la liste des membres, avec le statut « hors ligne ». C’est normal, on ne l’a pas encore programmé pour qu’il se connecte.
Pour des configurations d’autorisations plus complexes, vous pouvez utiliser un générateur de permissions qui simplifie la tâche.
Étape 3 : Programmer votre premier bot avec Discord.js
C’est la partie la plus technique, mais on va y aller simplement. On va utiliser Discord.js, une librairie JavaScript très populaire qui facilite la communication avec l’API de Discord. Vous pouvez trouver toute sa documentation sur le site officiel de Discord.js.
D’abord, installez la librairie. Ouvrez un terminal dans le dossier de votre projet et tapez cette commande :
npm i --save discord.js
Maintenant, créez un fichier (par exemple `index.js`) et copiez-y ce code de base pour connecter le bot :
// On importe la librairie discord.js
const Discord = require('discord.js');
// On crée un nouveau client Discord
const client = new Discord.Client();
// Cet événement se déclenche quand le bot est prêt et connecté
client.on('ready', () => {
console.log(`Connecté en tant que ${client.user.tag} !`);
});
// Remplacez 'VOTRE_TOKEN_ICI' par le token que vous avez copié
client.login('VOTRE_TOKEN_ICI');
Ce code est simple : il importe la librairie, crée un objet `client` qui représente votre bot, affiche un message dans la console quand la connexion est réussie, et enfin utilise la fonction `login` pour se connecter avec votre token.
Pour le lancer, tapez `node index.js` dans votre terminal. Si tout va bien, vous verrez le message de confirmation et votre bot apparaîtra « en ligne » sur votre serveur.
Ajoutons maintenant une fonction simple : répondre « pong ! » quand un utilisateur écrit « ping ». Ajoutez ce bloc de code juste avant la ligne `client.login` :
// Cet événement se déclenche à chaque fois qu'un message est envoyé
client.on('message', message => {
// On vérifie si le contenu du message est exactement "ping"
if (message.content === 'ping') {
// Si c'est le cas, le bot répond "pong !" dans le même salon
message.reply('pong !');
}
});
Ici, `client.on(‘message’, …)` écoute tous les messages. Si le contenu (`message.content`) est égal à « ping », le bot utilise `message.reply()` pour répondre. Relancez votre bot et testez la commande sur votre serveur.
Qu’est-ce qu’un bot Discord et pourquoi en créer un ?
Maintenant que vous savez comment faire, revenons à la base. Un bot Discord, c’est un programme automatisé qui agit comme un utilisateur sur un serveur. Il est connecté via l’API de Discord et peut faire presque tout ce qu’un humain peut faire, mais de manière automatique.
Mais alors, à quoi ça sert ? Les bots rendent un serveur plus vivant et plus facile à gérer. Voici quelques exemples de ce qu’ils peuvent faire :
- Modération automatique : Bannir les spammeurs, supprimer les insultes, ou mettre des avertissements aux utilisateurs qui ne respectent pas les règles.
- Envoi de messages : Accueillir les nouveaux membres avec un message personnalisé (par exemple : `channel.send(‘Bienvenue sur le serveur, @member !’)`), envoyer des annonces programmées, etc.
- Gestion des rôles : Attribuer des rôles automatiquement aux utilisateurs en fonction de leurs actions ou de réactions à un message.
- Intégration de services externes : Afficher des notifications de Twitch, YouTube ou Twitter directement sur votre serveur.
- Divertissement : Ajouter des jeux, des sondages, des quiz ou diffuser de la musique dans les salons vocaux.
En résumé, créer un bot permet de personnaliser l’expérience sur votre serveur, d’automatiser les tâches répétitives et de renforcer l’engagement de votre communauté.
Vous avez maintenant toutes les bases pour créer un bot Discord. Vous avez créé l’application, invité le bot sur votre serveur et écrit vos premières lignes de code pour le faire réagir.
Ce n’est que le début. À partir de là, vous pouvez explorer la documentation de Discord.js pour ajouter des fonctions plus complexes. C’est un excellent moyen d’apprendre la programmation tout en améliorant votre communauté.
