Comment créer un bot Discord avec Python (discord.py)

Ce guide construit un bot Python avec une commande slash, /ping. Il vous faut d’abord une application Discord et un token de bot : Comment créer un bot Discord et obtenir son token.

Les fichiers

requirements.txt

discord.py>=2.4

bot.py

import os
import discord
from discord import app_commands

intents = discord.Intents.default()
client = discord.Client(intents=intents)
tree = app_commands.CommandTree(client)

@tree.command(name="ping", description="Replies with pong")
async def ping(interaction: discord.Interaction):
    await interaction.response.send_message("pong")

@client.event
async def on_ready():
    await tree.sync()
    print(f"Logged in as {client.user}")

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

Le bot utilise les intents par défaut : aucun intent privilégié n’a donc besoin d’être activé.

Le faire tourner sur PlayNHost

1. Ouvrez votre serveur dans le panel. Cliquez sur Modifier le type de serveur dans l’Aperçu et choisissez Python Bot. Faites-le sur un nouveau serveur : changer le type le réinstalle. Voir Comment changer le type de votre serveur.
2. Dans Files, téléversez bot.py et requirements.txt.
3. Dans Paramètres, Paramètres du jeu, réglez Fichier principal sur bot.py et collez votre token dans Token du bot Discord.
4. Ouvrez Console et démarrez le serveur. Le serveur installe les paquets de requirements.txt à chaque démarrage.
5. Quand la console affiche Logged in as ..., saisissez /ping dans Discord.

Bon à savoir

• Le serveur utilise Python 3.12 par défaut. Si un paquet a besoin d’une autre version, choisissez 3.10, 3.11, 3.13 ou 3.14 sous Paramètres, Image Docker.
• Les commandes enregistrées avec tree.sync() sont globales et peuvent mettre un moment à apparaître. Pendant les tests, synchronisez plutôt avec un seul serveur : tree.copy_global_to(guild=discord.Object(id=YOUR_SERVER_ID)) puis await tree.sync(guild=...).
• Lisez les erreurs dans Console. Un paquet manquant signifie qu’une ligne manque dans requirements.txt.

À lire aussi : Comment héberger un bot Discord Python, Comment utiliser une base de données avec votre bot Discord.