Mise en place d'un bot Discord en Python

Créer les commandes ban, unban & kick sur un bot Discord en Python

Créer les commandes mute, unmute & nickname sur un bot Discord en Python

Python

Tu as toujours voulu créer un bot Discord mais tu n'as jamais su comment faire ? Alors ce tuto est fait pour toi !

### 📝 Introduction

Afin de poursuivre ce tuto dans de bonnes conditions, nous allons devoir installer le module discord py afin d'interagir directement avec l'API de Discord et donc créer notre bot Discord.

Vous allez également devoir créer votre bot Discord depuis [le portail développeur de Discord](https://discord.dev/) afin d'obtenir le token de votre futur bot (token qui servira à connecter le Bot à l'API de Discord).

### ⚡️ Initialisation de notre projet

Pour installer `discord.py` vous devez écrire ceci dans votre console:

**Windows**:
```python
pip install discord.py
```

**MacOS & Linux:**:
```py
python3 -m pip install -U discord.py
```

### 📝 Création de notre fichier principal

Nous allons créer un fichier main.py mais libre à vous de le nommer comme bon vous semble !

Voici nos premières lignes de code et analysons les ensembles:

```python
import discord # <- Ici nous importons le module nécessaire à la création de notre bot
from discord.ext import commands # <- Ici nous importons "commands" car ce dernier permet, comme son nom l'indique, de créer des commandes

bot = commands.Bot(command_prefix="!", intents=discord.Intents.all()) # <- Nous définissions ici le prefix de notre bot ainsi que les intents que nous souhaitons utiliser. Ici nous les importons tous pour des questions de pratique.

if __name__ == "__main__":
    bot.run("Votre token") # <- Ici on lance notre bot
```

### 📦 Création de notre handler de commandes

À quoi va nous servir notre handler ? Tout simplement à exécuter nos différentes commandes en dehors du fichier principal ce qui nous permet d'avoir un code plus clair et plus propre. Nous aurons également besoin de créer un dossier "cogs" où nous mettrons toutes nos commandes durant ce tuto.

Voici le code de notre handler que nous mettrons dans le dossier `main.py` :

```python
@bot.event
async def on_ready():
    print(f"Connecté en tant que {bot.user.name} !")
    for file in os.listdir("./cogs"): # Liste toutes nos commandes présentes dans le dossier "./cogs
        if file.endswith(".py"): # Récupère tout les fichiers dont l'extention se termine par ".py"
            name = file[:-3] # Récupère le nom des fichiers et retire l'extension ".py"
            await bot.load_extension(f"cogs.{name}") # Charge toutes les commandes présentes dans le dossier "./cogs"
```
> Attention, n'oubliez pas d'importer le module "os" car nous utilisons la methode "os.listdir".
>
Nous allons maintenant créer notre commande ping dans un nouveau fichier que nous appellerons ping.py par exemple, fichier que nous créons dans le dossier cogs évidemment.

```python
import discord
from discord.ext import commands, tasks

class Ping(commands.Cog):
    def __init__(self, bot):
        self.bot = bot # Cette méthode nous permet d'accéder au bot ce qui nous permet d'effectuer des actions tel que l'envoie de message, récupérer un utilisateur, etc.
    
    @commands.command()
    async def ping(self, ctx: commands.Context): # Il est important d'ajouter self comme premier argument pour pouvoir accéder aux fonctionnalités de ctx.
        await ctx.send('🏓 Pong!')

async def setup(bot):
    await bot.add_cog(Ping(bot)) # Ici on ajoute simplement notre commande à notre handler
```
![Description](https://i.imgur.com/Ut5apnE.png)

Vous venez de créer votre première commande discord grâce à votre bot, magique n'est-ce pas ? 🪄

***

### 📚 Chapitre à suivre...

Dans le chapitre suivant, nous verrons les différentes commandes de modération qu'il est possible de réaliser avec discord.py tel que **ban**, **kick**, **unban**, **mute**, **unmute**, **nickname** ainsi que le **slowmode** !

Faites chauffer vos claviers !

<data>NE PAS SUPPRIMER CETTE LIGNE!</data>

Les premières étapes de la création d'un bot Discord en Python