NOUVEAU 📢 Black Friday : l'offre de lancement finit le 30 nov. Jusqu'à 70 % de remise sur votre premier mois !Voir les offres
Black FridayJusqu'à 70 % de remise sur votre premier mois, fin le 30 nov.Fin dans 9 j 02 h 49 minBlack FridayJusqu'à 70 % de remise sur votre premier mois, fin le 30 nov.Fin dans 9 j 02 h 49 minBlack FridayJusqu'à 70 % de remise sur votre premier mois, fin le 30 nov.Fin dans 9 j 02 h 49 min

Comment héberger un bot Pycord 24/7

Hébergement de bots DiscordMis à jour 6 nov. 202610 min de lecture

Pour héberger un bot Pycord 24/7, faites-le tourner sur une machine qui reste allumée plutôt que sur votre PC : un VPS Linux avec un service systemd si vous l'hébergez vous-même, ou un forfait bot sur l'hébergement de bots Discord PlayNHost (à partir de 1,99 $US par mois), où vous envoyez votre code, collez le token et appuyez sur Démarrer. Lors de notre test, un bot Pycord 2.8.1 a utilisé environ 51 Mo de mémoire et a joint Discord environ 1,1 seconde après son lancement. Pycord s'installe sous le nom py-cord mais s'importe sous le nom discord, le même que discord.py : n'indiquez donc qu'une seule des deux. Les étapes sur PlayNHost :

  1. Sur la page d'hébergement de bots Discord, cliquez sur Créer un serveur pour un forfait. Dans la fenêtre de commande, répondez à Pour quelle plateforme est votre bot ? par Discord et choisissez Python.
  2. Ouvrez votre serveur dans le panel. La carte Configurer votre bot de l'Aperçu s'ouvre sur Connexion à Discord. Sa première étape, Ce qui tourne, doit indiquer Ce bot fait tourner Python Bot. ; cliquez sur cette étape pour la vérifier, puis sur Continuer.
  3. À l'étape Connexion à Discord, collez votre token dans Collez le token de votre bot, cliquez sur Connecter, puis sur Oui, continuer.
  4. À l'étape Permissions, cochez Mon code l’utilise uniquement pour les intents privilégiés que demande votre code (le bot ci-dessous n'en a besoin d'aucun), cliquez sur Ajouter à un serveur Discord, puis sur Continuer.
  5. À l'étape Votre code, cliquez sur Téléverser des fichiers et envoyez bot.py et un requirements.txt qui liste py-cord, ou cliquez sur Connecter Git.
  6. Si votre fichier principal n'est pas bot.py, définissez le Fichier d’entrée sur la page Bot, volet Code, puis cliquez sur Enregistrer.
  7. Cliquez sur Démarrer le bot et surveillez la Console. Quand votre bot affiche Logged in as ..., la carte indique Votre bot est en ligne sur Discord.

Les étapes générales pour Python (runtime, paquets, lignes de la console) se trouvent dans Comment héberger un bot Discord Python. Cette page couvre ce qui change avec Pycord.

Ce que nous avons mesuré

Nous avons fait tourner chaque bibliothèque Discord pour Python sur nos propres serveurs, dans la même configuration Python 3.12 que celle d'un forfait bot, avec une limite de mémoire de 1 Go :

BibliothèqueVersionMémoire au reposDu démarrage à la réponse de Discord
Pycord2.8.151 Mo1.1 s
discord.py2.7.148 Mo1.0 s
nextcord3.2.047 Mo1.0 s
disnake2.12.247 Mo0.9 s
hikari2.7.061 Mo1.3 s
Python seul3.129 Mo

Méthode : le plus petit programme qui charge la bibliothèque et se connecte avec un faux token, installé comme nos serveurs l'installent. La mémoire est celle que le processus occupait 15 secondes après le refus du token par Discord, et le temps de démarrage court du lancement à cette réponse, il inclut donc un aller-retour vers Discord. Chaque valeur est la médiane de trois exécutions après une exécution d'échauffement. C'est le plancher : un bot qui s'est connecté, a rejoint des serveurs et mis des membres en cache consomme davantage, dans une mesure qui dépend du bot.

Ce que cela signifie pour le forfait : un bot Pycord minimal occupe environ un dixième du forfait STARTER de 0,5 Go. Dimensionnez le forfait selon ce que votre propre bot garde en mémoire, pas selon la bibliothèque.

Un bot Pycord minimal

Il répond à /ping avec une slash command et affiche une ligne de démarrage. Il lit le token dans DISCORD_TOKEN, le nom que le panel donne à votre code.

requirements.txt

py-cord>=2.8,<3

bot.py

import os

import discord

bot = discord.Bot()


@bot.event
async def on_ready():
    print(f"Logged in as {bot.user}")


@bot.slash_command(name="ping", description="Check that the bot answers")
async def ping(ctx: discord.ApplicationContext):
    await ctx.respond("Pong!")


bot.run(os.environ["DISCORD_TOKEN"])

discord.Bot est la classe propre à Pycord pour les slash commands. Elle enregistre /ping auprès de Discord toute seule à chaque connexion, car auto_sync_commands est activé par défaut : il n'y a donc aucune étape de synchronisation à écrire. La ligne Logged in as fait passer la pastille de l'Aperçu à En ligne sur Discord.

Si le token est incorrect

Quand Discord refuse le token, Pycord lève cette erreur (le texte affiché par notre bot de test) :

LoginFailure: Improper token has been passed.

Avec bot.run(), une trace d'erreur se termine par discord.errors.LoginFailure: Improper token has been passed. et le bot s'arrête. Le panel lit cette ligne : la pastille affiche Problème de token et une bannière indique Discord n’a pas accepté le token de votre bot. Obtenez un nouveau token dans le Discord Developer Portal : votre application, Bot, Reset Token (il n'est affiché qu'une fois). Cliquez sur Remplacer le token dans la bannière, puis sur Remplacer le token dans le volet Discord, collez-le et redémarrez le bot. Voir Comment créer un bot Discord et obtenir son token.

Ce qu'un hébergeur doit savoir sur Pycord

  • Le nom d'installation et le nom d'import diffèrent. Vous installez py-cord et écrivez import discord. discord.py installe un module du même nom, discord, les deux ne peuvent donc pas coexister. Le guide de Pycord lui-même demande de désinstaller discord.py d'abord, et prévient que désinstaller discord.py après avoir installé py-cord peut causer des problèmes.
  • Passer un serveur de discord.py à Pycord. Nos serveurs installent les paquets dans un dossier .local et ne retirent jamais un paquet que vous enlevez de requirements.txt : discord.py resterait donc à côté de Pycord. Dans Files, supprimez le dossier .local et le fichier .pnh/packages.state, puis appuyez sur Démarrer : tout ce qui est dans requirements.txt s'installe de nouveau, sans discord.py.
  • Version de Python. Pycord 2.8.1 prend en charge Python 3.10 à 3.14. Le Runtime du volet Code propose exactement celles-ci, avec 3.12 par défaut : tout choix fonctionne.
  • Intents. discord.Bot() utilise les intents par défaut, qui n'incluent aucun intent privilégié, et les slash commands n'en demandent aucun. Les commandes à préfixe comme !ping exigent intents.message_content = True dans votre code et Message Content Intent activé dans le Developer Portal. Si votre code le demande alors qu'il est désactivé dans le Portal, Discord refuse la connexion. Voir Corriger « Used disallowed intents » sur votre bot Discord.
  • Laissez on_connect libre. L'enregistrement automatique s'exécute dans le on_connect du bot lui-même. Si vous définissez vous-même on_connect, la documentation de Pycord demande d'y appeler await bot.sync_commands(), faute de quoi vos commandes ne se mettent plus à jour. Placez le code de démarrage dans on_ready, comme plus haut.
  • Les logs sont désactivés tant que vous ne les activez pas. Le run() de Pycord ne configure pas la journalisation : Python n'affiche donc que les avertissements et erreurs de la bibliothèque, pas ses lignes d'information comme la connexion. Affichez votre propre ligne de démarrage, comme plus haut, ou appelez logging.basicConfig(level=logging.INFO) pour voir ce que fait la bibliothèque.
  • Vocal. Pour les salons vocaux, écrivez py-cord[voice] dans requirements.txt au lieu de py-cord.

L'héberger vous-même sur un VPS Linux

Sous Debian ou Ubuntu, installez Python, créez un utilisateur et un dossier pour le bot, puis installez Pycord dans un environnement virtuel :

sudo apt update
sudo apt install -y python3 python3-venv
sudo useradd --system --create-home --home-dir /opt/pycord-bot bot
sudo cp bot.py requirements.txt /opt/pycord-bot/
sudo chown bot: /opt/pycord-bot/bot.py /opt/pycord-bot/requirements.txt
sudo -u bot python3 -m venv /opt/pycord-bot/venv
sudo -u bot /opt/pycord-bot/venv/bin/pip install -r /opt/pycord-bot/requirements.txt

Placez le token dans un fichier que seul root peut lire. Créez /etc/pycord-bot.env avec sudo nano /etc/pycord-bot.env, écrivez une ligne, DISCORD_TOKEN= suivi de votre token, enregistrez-la et exécutez sudo chmod 600 /etc/pycord-bot.env.

Créez ensuite /etc/systemd/system/pycord-bot.service :

[Unit]
Description=Pycord Discord bot
Wants=network-online.target
After=network-online.target

[Service]
User=bot
WorkingDirectory=/opt/pycord-bot
EnvironmentFile=/etc/pycord-bot.env
Environment=PYTHONUNBUFFERED=1
ExecStart=/opt/pycord-bot/venv/bin/python bot.py
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

Démarrez-le maintenant et à chaque démarrage du système, puis suivez sa sortie :

sudo systemctl daemon-reload
sudo systemctl enable --now pycord-bot
sudo journalctl -u pycord-bot -f

PYTHONUNBUFFERED=1 fait arriver print() dans le journal immédiatement, au lieu d'attendre qu'un tampon soit plein. Pour mettre le bot à jour, copiez les nouveaux fichiers, relancez la ligne pip install puis sudo systemctl restart pycord-bot.

Auto-hébergement ou forfait bot

Votre propre VPSUn forfait bot PlayNHost
PythonLa version fournie par votre distribution ; vous l'installez et la mettez à jourChoisissez de 3.10 à 3.14 sous Runtime
PaquetsVous lancez pip install après chaque changementInstallés à un démarrage après un changement de requirements.txt ou de version de Python, et au premier démarrage un jour après la dernière installation
RedémarragesVotre unité systemdRelancé après un plantage ; laissé arrêté avec la raison s'il replante dans la minute
Le tokenUn fichier que vous protégez vous-mêmeStocké chiffré, vérifié auprès de Discord quand vous le collez, transmis à votre code sous le nom DISCORD_TOKEN
ErreursVous lisez le journalLa bannière de la console nomme la cause, par exemple un mauvais token ou un intent manquant
Mises à jour système, pare-feu, SSHÀ votre chargePas votre travail

Questions fréquentes

Puis-je avoir Pycord et discord.py dans le même bot ?

Non. Les deux installent le module discord : l'un écrase l'autre. Ne gardez que py-cord dans requirements.txt. Si le serveur faisait tourner discord.py auparavant, supprimez .local et .pnh/packages.state dans Files pour que les paquets s'installent de nouveau proprement.

Pourquoi /ping n'apparaît-il pas sur mon serveur ?

Vérifiez que le bot a été ajouté avec Ajouter à un serveur Discord et que la console affiche la ligne Logged in as : Pycord enregistre la commande à la connexion. Pendant vos tests, passez debug_guilds=[your_server_id] à discord.Bot() : les commandes ne sont alors créées que sur ce serveur et, selon la documentation de Discord, les commandes de serveur se mettent à jour instantanément.

Pycord est-il la même chose que discord.py ?

Non. Pycord est né comme un fork de discord.py et conserve une grande partie de son API, comme discord.Client et discord.ext.commands, mais ses slash commands diffèrent : @bot.slash_command et ctx.respond() dans Pycord, app_commands et un appel de synchronisation dans discord.py. Le code écrit pour l'une ne fonctionne pas toujours avec l'autre.

Un bot Pycord tient-il dans le plus petit forfait ?

Oui. Avec environ 51 Mo lors de notre test, un bot Pycord minimal occupe environ un dixième du forfait STARTER de 0,5 Go. Passez au forfait supérieur quand votre bot en a besoin : grands serveurs dont il met les membres en cache, fichiers ou images qu'il traite, ou données qu'il garde en mémoire.

Prêt à lancer le vôtre ? Choisissez un forfait sur l'hébergement de bots Discord et envoyez votre bot Pycord.

Votre bot est hébergé ailleurs ? Transférez-le chez nous

NOS DERNIERS ARTICLES