Comment créer un Bot Discord en Python ?

Vous voulez développer votre propre Bot Discord en Python ? Vous ne trouvez pas votre bonheur dans les bots publics mais vous vous débrouillez en Python ?

Python est un des langages les plus populaires pour développer des Bots Discord ce qui en fait un tres bon choix.

Dans cet article nous découvrirons :

• Comment héberger un bot discord gratuitement ?
• Qu’est-ce que Discord.py, la libraire de reference pour développer des bots discord en python ?
• Quel boilerplate utiliser pour votre bot discord ?

Découvrons sans plus tarder comment commencer le développement de votre Bot Discord en Python.

Comment utiliser un bot discord en Python ?

Avant de commencer le développement de notre bot Discord a proprement parler, vous devez :

• vous inscrire sur Discord
• vous inscrire sur le Portail des Développeurs Discord
• Créer une application Discord
• Preciser que c’est un bot
• Lui donner des permissions
• Récupérer vos tokens

Si vous n’avez pas encore tout cela, je vous explique tout sur mon article complet sur les bots discord.

Qu’est-ce que discord.py ?

Discord.py est un package Python qui vous fournit un wrapper autour de l’API Discord.

Avec son API moderne, sa facile d’utilisation, sa richesse en features et sa gestion d’asynchrone, Discord.py s’est imposée comme Librairie de reference pour Discord.

Ainsi, vous pouvez voir qu’une bonne partie des bots Discord de top.gg ont ete fait avec discord.py.

C’est une API Python moderne utilisant l’async qui couvre à 100 % de l’API Discord.

Discord.py est un projet open-source disponible sur GitHub.

Comment obtenir discord.py ?

Pour obtenir le package python discord.py, il faut installer la librairie Discord.py avec la commande pip.

Avant de commencer, je vous conseille de vous créer un environnement virtuel.

En Python, un environnement virtuel permet d’installer des packages dans un environnement clos. Cela évite d’avoir une quantité importante de packages python sur votre machine. En plus, vous pourrez facilement installer les ressources nécessaires et rien d’autre en créant un fichier requirements.txt pour partager votre projet.

Créons donc notre virtual env avec la commande :

python3 -m venv <nom_de_votre_environnement_virtuel>

Suivi de

source <nom_de_votre_environnement_virtuel>/bin/activate

Finalement, on va installer le la librairie discord.py en fonction de notre système d’exploitation

Pour Mac OSX et Linux :

python -m pip install discord.py

Pour Windows :

py -3 -m pip install -U discord.py

Comment créer un bot discord.py ?

La libraire discord.py contient quelques exemples.

Prenons le code du “quickstart” sur le site de discord.py pour commencer avec un bot basique.

# Vous devrez autoriser l'intent 'message_content' dans le Discord Developer Portal.

import discord

intents = discord.Intents.default()
intents.message_content = True

client = discord.Client(intents=intents)

@client.event
async def on_ready():
    print(f'We have logged in as {client.user}')

@client.event
async def on_message(message):
    if message.author == client.user:
        return

    if message.content.startswith('$hello'):
        await message.channel.send('Hello!')

client.run('VOTRE_TOKEN_DISCORD_APP')

Une fois installe sur votre serveur, le bot répondra quand vous tapez $hello.

Une fonction appelée on_message et une autre appelée on_ready.

on_ready qui se produit au démarrage du bot et on_message, chaque fois qu’un messager est reçu.

La fonction on_ready est plus simple, alors regardons d’abord celle-là. Tout ce qu’elle fait, c’est imprimer les informations sur le client, confirmant que vous êtes connecté comme étant le bon bot et que la connexion a été établie avec succès.

La fonction on_message() commence par une déclaration if qui vérifie si l’auteur du message est le client lui-même. Ces messages sont ignorés, car cela signifie qu’il s’agit d’un message envoyé par le robot lui-même.

Tout en bas du fichier, après les définitions des fonctions, il y a simplement un appel à client.run().

Comment héberger un Bot Discord développé en Python

Pour héberger votre bot discord, il faut juste que votre fichier tourne en permanence.

Vous pouvez le faire tourner sur votre ordinateur s’il est allume 24/7, sur une raspberry pi ou dans le cloud.

Pour héberger et faire tourner votre bot, il existe des solutions gratuites et payantes comme Railway, Heroku, PythonAnywhere, AWS ou un VPS.

Je vous montre quelques manières de faire ci-dessous, mais avant, voyons quel est l’hébergeur qui convient le mieux à vos besoins.

Quel est le meilleur hébergeur pour un bot discord Python ?

Comment héberger un Bot Discord Python sur Railway ?

Railway est un concurrent plus récent aux autres services d’hébergement. Ils disposent d’un free tier de 5$ par mois, ce qui est plus qu’assez pour votre bot Discord.

Vous pouvez essayer gratuitement Railway en cliquant sur ce lien.

😭 Railway ne propose plus son plan gratuit depuis le 1er Août 2023. Je vous tiendrai au courant quand je trouverai un meilleur hébergeur gratuit.

1. Inscrivez-vous sur Railway et validez votre compte

Vous pouvez vous inscrire sur Railway.app et commencer à utiliser leur service gratuitement.

Vous recevrez l’équivalent de 2 dollars ou 200 heures d’exécution de base pour votre bot discord.

Vous pourrez passer à 5 dollars ou 500 heures par mois en validant votre adresse email et en acceptant leurs conditions générales.

🤑 pro tip : Il y environ 730 heures dans un mois (en fonction du mois). Il est donc possible d’avoir 2 comptes Railway (qui vous offriront 500h x 2 = 1000 heures) et de jongler entre les deux si vous voulez rester 100% gratuit.

Vous pourrez lier une carte de crédit et ajouter du crédit sur votre compte pour profiter d’un plan complet “Developer Plan”.

Bref, continuons.

2. Créez un nouveau projet sur GitHub

J’ai créé un boilerplate sur github pour vous aider.

Si vous n’avez encore rien, vous pouvez partir de ce boilerplate pour commencer le développement de votre bot discord en Python.

Si vous avez déjà développé un bot discord que vous souhaitez héberger sur Railway, vous pouvez le faire en passant par Github.

Railway a besoin de 3 fichiers si vous passez par GitHub : un fichier Procfile, un fichier runtime.txt et un fichier requirements.txt. Vous aurez besoin ces 3 fichiers de configuration en plus de vos fichiers de scripts python.

Procfile

web: python <le_nom_de_votre_script_principal>.py

Remplacez <le_nom_de_votre_script_principal> par le nom du fichier que vous lancez pour faire tourner votre bot.

runtime.txt

python-3.9.5

La version de Python que vous souhaitez utiliser, préférez la dernière version LTS (long term support).

requirements.txt

discord.py

Toutes les modules Python que vous utilisez. Vous pouvez récupérer la liste de votre projet avec la commande : pip freeze > requirements.txt depuis l’environnement python de votre bot discord.

3. Ajoutez votre token discord

Si vous ne savez pas comment récupérer votre le token discord de votre bot, je vous recommande mon article sur les bots discord.

En bref, vous devez :

• Vous rendre sur le “Developer Portal” de Discord
• Créer une nouvelle application avec le bouton “New Application”
• Vous rendre dans l’onglet “Bot”, appuyer sur “Reset Token” et récupérer votre token

⚠️ Copiez ce token dans un endroit sécurisé, on va en avoir besoin dans l’étape suivante.

Tant que vous êtes dans le Developer Portal, vous devrez configurer les “Intents” de votre bot.

Si vous avez utilisé mon boilerplate, vous devrez activer l’intent “MESSAGE CONTENT INTENT”.

Une fois que c’est fait, vous aurez besoin d’un lien pour rajouter le bot à votre salon discord. Allez dans OAuth 2 puis URL Generator.

Dans Scopes, choisissez Bot.

Dans Bot Permissions, choisissez Read Messages/View Channels et Send Messages.

Copiez enfin le lien généré en bas de page et coller le dans votre navigateur.

Choisissez votre serveur et vous aurez fini de lier votre bot à votre guilde discord.

Si tout s’est bien passé vous devriez voir votre bot apparaître hors ligne.

4. Importez votre bot depuis Github vers Railway

Dans votre Dashboard Railway, appuyez sur New Project.

Choisissez Deploy from GitHub repo puis le repo de votre bot discord.

Choisissez l’option Deploy now.

La dernière chose qu’il nous reste à faire est d’ajouter le token de notre bot discord dans les variables d’environnement de Railway.

Il s’agit du token de votre bot discord qu’on a récupéré dans l’étape précédente (et que je vous avais dit de garder dans un endroit sécurisé 😅).

Pas de panique si vous l’avez perdu, vous pouvez un créer un nouveau sur le Developer Portal de Discord.

Cliquez sur la carte de votre projet sur Railway puis rendez-vous dans l’onglet Variables.

Appuyez sur New Variable puis ajoutez le nom de la variable “VARIABLE_NAME” (DISCORD_BOT_TOKEN pour mon boilerplate) et votre token dans “VALUE”.

Et voilà, c’est fini 🎉 Vous devriez voir votre bot passer en ligne sur votre salon discord quand Railway aura fini de déployer votre projet.

Comment héberger un Bot Discord Python sur Replit ?

Replit est une plateforme qui permet de coder directement sur un site web ainsi que de lancer des programmes.

Il est donc possible d’utiliser Replit pour coder et lancer des scripts Python, dont des bots Discord développés en Python.

Replit dispose d’un plan gratuit si vous acceptez que vos “Repls” (vos projets) soient publiques, visibles par tous. Vous n’aurez pas non plus d’accès SSH avec le plan gratuit.

Un autre problème est qu’un projet hébergé gratuitement sur Replit se coupera automatiquement après une heure s’il n’y a pas eu d’interaction avec.

Il nous faut donc un service qui va “pinger” notre bot au moins une fois par heure pour que votre bot tourne en permanence.

Heureusement, une solution gratuite existe : UptimeRobot.

UptimeRobot nous permettra d’interagir avec notre bot Discord toutes les 5 minutes pour s’assurer qu’il tourne en permanence.

Host gratuitement un bot python sur PythonAnywhere ?

Pour déployer notre bot Discord, nous allons d’abord créer un compte gratuit avec PythonAnywhere.

PythonAnywhere un service qui permet de déployer facilement des applications Python dans le cloud. Sur la page de connexion, saisissez votre adresse email et votre mot de passe puis cliquez sur “Connexion”.

Un fois sur PythonAnywhere, rendez-vous sur la page du dashboard.

Cliquez ensuite sur “Upload a file”, localiser votre script de bot Discord et uploadez-le.

Il vous suffira ensuite de lancer le fichier .py que vous venez d’uploader en cliquant dessus et puis >>> Run this file.

Comment héberger un Bot Discord Python sur Heroku ?

🤑 Heroku a supprimé son plan gratuit en 2023. Il ne vous sera donc pas possible de commencer gratuitement à héberger votre bot discord sur Heroku.

Je vous conseille Railway.app qui est bien plus simple et avec qui vous pouvez commencer gratuitement (500 heures par mois).

Pour déployer votre bot discord en Python vous pouvez utiliser un compte Heroku.

Installer Heroku sur Mac OSX

brew install heroku/brew/heroku

ou avec le lien du client Mac OSX Heroku.

Installer Heroku sur Windows

Pour Windows, vous pouvez passer par les clients desktop aussi bien pour Windows 32 bits que 64 bits.

Si vous ne savez pas quelle version vous avez, vous avez sûrement plutôt le 64bits.

Windows 64-bits

Le client GUI Heroku Windows 64 bit.

Windows 32-bits

Le client GUI Heroku Windows 32 bit.

Installer Heroku sur Ubuntu

sudo snap install heroku --classic

Une fois installe, tapez heroku login dans votre terminal.

Ensuite heroku create.

Avec votre Procfile qui contient :

worker: python nom_de_votre_bot.py

Puis git push heroku master.

Vous savez maintenant utiliser un bot discord en Python !

Dans cet article vous avez appris comment faire fonctionner un bot discord en Python.

Vous pouvez maintenant aller plus loin en améliorant votre script.

Les lecteurs de cet article on aussi aimé :

• Comment apprendre Python en 2023
• Les meilleurs livres pour apprendre Python
• Les meilleurs cours payants pour progresser Python
• Tout savoir sur le Bot Discord MEE6
• Comment développer des Bots Discord avec Node JS