Comment créer un client Discord.py ?

Après avoir configuré votre bot dans le Discord Developer Portal, il est temps de le mettre en ligne en créant un client capable d’interagir avec l’API de Discord grâce à la bibliothèque discord.py.

Prérequis

Avant de commencer, assurez-vous d’avoir installé les éléments suivants :

• Python
• Visual Studio Code ou votre éditeur de code favori
• L’extension Python pour VSCode (optionnelle mais recommandée)
• Le module discord.py, que nous allons installer dans ce tutoriel

1. Créer le Dossier du Projet

La première étape consiste à créer un nouveau dossier pour votre projet. Vous pouvez le nommer comme vous voulez, mais pour cet exemple, nous allons l’appeler tutorial-bot-discord.

Sur votre bureau, créez le dossier et ouvrez-le dans Visual Studio Code (ou votre éditeur de code préféré).

2. Créer le Fichier client.py

Dans le dossier que vous venez de créer, ajoutez un nouveau fichier Python. Nommez-le client.py. Ce fichier contiendra tout le code nécessaire pour initialiser et lancer votre bot.

3. La Variable Token

Chaque bot Discord est associé à un token unique que vous pouvez obtenir depuis le Discord Developer Portal. Une fois votre bot créé, copiez le token et collez-le dans une variable Python dans le fichier client.py comme suit :

token = "VOTRE_TOKEN_ICI"

⚠️️ Attention : Ne partagez jamais ce token publiquement. Si vous le perdez ou s’il est compromis, vous pouvez le régénérer depuis le portail développeur.

4. Environnement Virtuel

Avant d’installer discord.py, il est recommandé de créer un environnement virtuel pour isoler les dépendances du projet. Cela permet de gérer facilement les versions des modules et d’éviter des conflits futurs.

Créer un Environnement Virtuel

Dans Visual Studio Code, ouvrez le terminal (Ctrl + `) et exécutez la commande suivante pour créer l’environnement virtuel :

python -m venv .venv

Ensuite, activez cet environnement :

• Sur Windows :

  .venv\Scripts\activate

• Sur macOS/Linux :

  source .venv/bin/activate

Pour vérifier que l’environnement virtuel est actif, tapez :

pip --version

Vous devriez voir le chemin de votre environnement virtuel dans la sortie.

5. Installer discord.py

Avec l’environnement virtuel activé, installez la bibliothèque discord.py :

pip install discord.py

Cette commande installera toutes les dépendances nécessaires pour interagir avec l’API de Discord via Python.

6. Coder le Fichier client.py

Maintenant que tout est en place, passons à l’écriture du code pour notre bot.

Commencez par importer la bibliothèque discord :

import discord

Ensuite, créez une instance de client qui interagira avec l’API Discord :

client = discord.Client(intents=discord.Intents.all())

Nous utilisons ici discord.Intents.all() pour activer tous les intents. Ces derniers permettent de spécifier les événements auxquels votre bot peut réagir (comme les messages ou les statuts des membres).

Si vous n’avez activé que certains intents dans le Discord Developer Portal, vous pouvez les définir individuellement comme suit :

intents = discord.Intents.default()
intents.members = True
intents.presences = True
client = discord.Client(intents=intents)

7. Lancer le Bot

Finalement, démarrez le bot en utilisant la méthode run() et en lui passant le token que vous avez récupéré :

client.run(token)

Le fichier client.py complet ressemblera donc à ceci :

import discord

token = "VOTRE_TOKEN_ICI"

client = discord.Client(intents=discord.Intents.all())

client.run(token)

8. Exécuter le Script

Vous pouvez maintenant exécuter votre bot en lançant le script Python depuis votre terminal :

python client.py

Si tout se passe bien, vous devriez voir des logs s’afficher dans le terminal. Plus important encore, lorsque vous vous connecterez à votre serveur Discord, votre bot devrait apparaître en ligne dans la liste des membres.

Conclusion

Vous avez désormais mis en ligne votre premier bot Discord !

Dans la prochaine partie du tutoriel, nous apprendrons à interagir avec des événements comme les messages et à ajouter des fonctionnalités à notre bot.

Lire la suite du tutoriel bot discord en python avec discord.py (Partie 3)