Comment héberger un bot Discord Python

Ce guide concerne les bots écrits en Python, par exemple avec discord.py.

Passer le serveur sur Python

Un nouveau serveur de bot démarre comme un serveur Node.js. Changez-le avant de téléverser quoi que ce soit, car changer le type réinstalle le serveur et supprime par défaut ses fichiers.

1. Ouvrez votre serveur dans le panel et restez sur l’Aperçu.
2. Cliquez sur Modifier le type de serveur et choisissez Python Bot, puis suivez les étapes. Voir Comment changer le type de votre serveur ou la version du jeu si vous voulez le pas-à-pas complet.

Ajouter votre bot

1. Ouvrez Files et téléversez votre bot, avec requirements.txt si vous en avez un.

   • Vous préférez git ? Ouvrez Paramètres, puis Paramètres du jeu et remplissez Dépôt Git. Pour un dépôt privé, renseignez aussi le nom d’utilisateur git et un jeton d’accès.
2. Dans Paramètres du jeu, réglez Fichier principal sur le fichier qui démarre votre bot, comme bot.py ou main.py.
3. Vérifiez Fichier de dépendances. La valeur par défaut est requirements.txt. Quand ce fichier existe, ses paquets sont installés à chaque démarrage.
4. Collez votre token dans Token du bot Discord (facultatif). Votre code le lit avec os.environ["DISCORD_TOKEN"].

Le démarrer

Ouvrez Console et démarrez le serveur. Le serveur installe vos dépendances, puis exécute votre fichier principal avec Python 3.12, la version par défaut (3.10, 3.11, 3.13 et 3.14 se trouvent sous Paramètres, Image Docker). Le premier démarrage est plus long, le temps que les paquets se téléchargent.

Bon à savoir

• Paquets supplémentaires : le champ Paquets pip supplémentaires (facultatif) installe d’autres paquets à chaque démarrage sans modifier requirements.txt.
• Print avec flush : Python retient la sortie quand il n’est pas dans un terminal. Si vos lignes print ne s’affichent pas tout de suite dans la console, utilisez print("text", flush=True) ou le module logging.
• Mises à jour depuis git : activez Mettre à jour depuis git à chaque démarrage pour récupérer votre dernier code à chaque redémarrage.

S’il s’arrête tout de suite : lisez Pourquoi votre bot Discord s’arrête sans cesse.