Créer un bot Discord avec Python : de zéro à en ligne

Écrire un bot Discord en Python prend une soirée. Le maintenir en ligne 24h/24 coûte un forfait d'hébergement. Voici le parcours complet : de la création de l'application bot à un bot fonctionnel sur le panel de jeu HostValues.

Héberger un bot Discord ? Chez HostValues à partir de €1,40 par mois, en ligne en quelques minutes. Voir les offres →

Étape 1 : créer l'application bot

  1. Rendez-vous sur le Discord Developer Portal et cliquez sur "New Application".
  2. Donnez un nom à l'application et cliquez sur "Create".
  3. Allez dans l'onglet "Bot" et cliquez sur "Reset Token" pour générer un token. Copiez le token et conservez-le en lieu sûr. Vous ne le verrez qu'une seule fois.
  4. Pour les commandes à préfixe !ping et !bonjour de cet exemple, activez uniquement Message Content Intent sous "Privileged Gateway Intents". Presence Intent et Server Members Intent ne sont pas nécessaires à ces commandes.
  5. Allez dans "OAuth2", sélectionnez sous Scopes "bot" et sous Bot Permissions les droits dont votre bot a besoin (minimum : Send Messages, Read Message History).
  6. Copiez l'URL générée et ouvrez-la dans votre navigateur pour ajouter le bot à votre serveur.

Chaque écran du portail, les intents privilégiés et le lien d'invitation sont détaillés dans notre guide du Discord Developer Portal.

Étape 2 : le code

Ces réglages suivent la documentation des intents de discord.py et la documentation Gateway de Discord. Seuls les intents requis par les fonctions du bot doivent être activés.

Créez un dossier avec deux fichiers :

requirements.txt

discord.py>=2.5
python-dotenv

bot.py

import os
import discord
from discord.ext import commands
from dotenv import load_dotenv

load_dotenv()

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

bot = commands.Bot(command_prefix="!", intents=intents)

@bot.event
async def on_ready():
    print(f"En ligne en tant que {bot.user}")

@bot.command()
async def ping(ctx):
    await ctx.send(f"Pong! Latence: {round(bot.latency * 1000)}ms")

@bot.command()
async def bonjour(ctx):
    await ctx.send(f"Salut {ctx.author.display_name}!")

bot.run(os.getenv("DISCORD_TOKEN"))

.env

DISCORD_TOKEN=votre_token_ici

Testez en local : pip install -r requirements.txt, puis python bot.py. Tapez !ping dans votre serveur Discord. Ça fonctionne ? Passons à l'hébergement.

Étape 3 : héberger sur le panel de jeu

  1. Commandez un forfait bot Discord.
  2. Uploadez bot.py, requirements.txt et .env via l'onglet Files. N'uploadez pas le dossier __pycache__ ni un environnement virtuel.
  3. Dans l'onglet Startup, définissez le fichier de démarrage sur bot.py et sélectionnez une image Python disponible qui respecte les exigences de votre version de discord.py. Les versions proposées se vérifient dans votre panel.
  4. Démarrez le serveur. Le panel installe automatiquement les packages depuis requirements.txt.
  5. Dans la console apparaît "En ligne en tant que NomDuBot". Votre bot est désormais joignable 24h/24.

Ajouter des slash commands

Les slash commands sont la manière moderne d'interagir avec les bots. Ils apparaissent dans le menu Discord quand vous tapez / :

@bot.tree.command(name="info", description="Affiche les informations du serveur")
async def info(interaction: discord.Interaction):
    guild = interaction.guild
    await interaction.response.send_message(
        f"{guild.name} a {guild.member_count} membres."
    )

# Ajoutez à on_ready :
@bot.event
async def on_ready():
    await bot.tree.sync()
    print(f"En ligne en tant que {bot.user}")

Les trois erreurs que tout le monde commet

  • Token dans le code. Mettez le token dans un fichier .env, pas dans bot.py. Un token qui se retrouve sur GitHub est automatiquement révoqué par Discord.
  • Intents incohérents. Pour lire les commandes à préfixe, activez Message Content Intent dans le portail et intents.message_content = True dans le code. Demander un intent privilégié non autorisé ferme la connexion Gateway avec le code 4014 ; ne demandez pas tous les intents par défaut.
  • requirements.txt oublié. Le panel ne peut pas installer de packages si le fichier n'est pas là. En local ça fonctionne parce que vous avez installé manuellement.

De combien de RAM mon bot a-t-il besoin ?

Un bot simple de commandes ou de modération : moins de 256 Mo. Le plus petit forfait de 1 Go est largement suffisant. Un bot musical sur plusieurs serveurs : 2 Go.

Puis-je faire tourner plusieurs bots sur un seul forfait ?

Oui. Utilisez pm2 (npm install -g pm2) pour exécuter plusieurs scripts Python simultanément. Trois petits bots tiennent dans 1 Go.

discord.py ou discord.js ?

Python si vous débutez en programmation : la syntaxe est plus lisible. JavaScript si vous avez déjà de l'expérience web ou si vous voulez construire un tableau de bord. Les deux bibliothèques sont activement maintenues et équivalentes en fonctionnalités.

Consultez les forfaits bot Discord ou le KVM VPS si vous faites tourner un site web ou une base de données en plus du bot.

Votre bot Discord toujours en ligne

À partir de €1,40 par mois. En ligne en quelques minutes, sans engagement, protection DDoS incluse.

Voir les offres Commander

Nouveau chez HostValues ? Avec le code WELKOM10, profitez de 10 % de réduction sur votre première commande.


Encore des questions ? Ouvrez un ticket de support et notre équipe vous aidera.

Retour au blog