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

Dans ce chapitre nous allons voir comment créer nos commandes modérations.

***

### 🚪 Commandes kick

Cette commande, tout le monde la connaît, permet d'exclure un membre de son serveur discord de manière non définitive.

Voyons comment créer cette dernière:

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

class Kick(commands.Cog):
    def __init__(self, bot):
        self.bot = bot

async def setup(bot):
    await bot.add_cog(Kick(bot)
```

Ici nous avons la structure nécessaire pour envoyer notre commande dans l'handler mais voyons ce qui nous intéresse réellement, la commande kick.

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

class Kick(commands.Cog):
    def __init__(self, bot):
        self.bot = bot

    @commands.command()
    async def kick(self, ctx: commands.Context, target: discord.Member, *, reason: str="") -> discord.Message:
        is_in_private = ctx.guild is None and isinstance(ctx.author, discord.User)
        if is_in_private:
            return await ctx.send("Vous ne pouvez pas exécuter cette commande en privé !")
        has_permissions = ctx.author.guild_permissions.ban_members
        if not has_permissions:
            return await ctx.send("Vous n'avez pas les permissions de ban ce membre !")
        is_text_channel = isinstance(ctx.channel, discord.TextChannel)
        if not is_text_channel:
            return await ctx.send("Vous devez envoyer cette commande depuis un salon textuel !")
        is_kickable = ctx.author.top_role > target.top_role
        if not is_kickable:
            return await ctx.send("Vous ne pouvez pas bannir ce membre !")
        
        if reason == "":
            reason = "Aucun raison n'a été fourni"

        await target.kick(reason=reason)
        await ctx.send("Le membre à bien été kick ! ✅")

async def setup(bot):
    await bot.add_cog(Kick(bot)
```

Dans un premier temps, nous avons notre bloc de vérification qui permet de "sécuriser" la commande et d'assurer son bon fonctionnement.

Par exemple, notre première ligne vérifie que le message a bien été envoyé dans un channel discord et non par message privé.

```python
is_in_private = ctx.guild is None and isinstance(ctx.author, discord.User)
```

Une fois que toutes les vérifications ont été validées par le bot, nous pouvons kick le membre en question grâce à la ligne suivante:

```python
await target.kick(reason=reason)
```

Et voilà, vous venez de créer votre première commande de modération ! 👮‍♀️

***

### ⚖️ Commande Ban & Unban

Pour ces deux commandes, le fonctionnement sera identique à l'exception de la commande Unban qui comme vous pouvez vous en doutez n'aura pas tout à fait le même code.

Ban:

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

class Ban(commands.Cog):
    def __init__(self, bot):
        self.bot = bot

    @commands.command()
    async def ban(self, ctx: commands.Context, target: discord.Member, *, reason: str="") -> discord.Message:
        is_in_private = ctx.guild is None and isinstance(ctx.author, discord.User)
        if is_in_private:
            return await ctx.send("Vous ne pouvez pas exécuter cette commande en privé !")
        has_permissions = ctx.author.guild_permissions.ban_members
        if not has_permissions:
            return await ctx.send("Vous n'avez pas les permissions de ban ce membre !")
        is_text_channel = isinstance(ctx.channel, discord.TextChannel)
        if not is_text_channel:
            return await ctx.send("Vous devez envoyer cette commande depuis un salon textuel !")
        is_bannable = ctx.author.top_role > target.top_role
        if not is_bannable:
            return await ctx.send("Vous ne pouvez pas bannir ce membre !")
        
        if reason == "":
            reason = "Aucune raison n'a été défini"
        
        await target.ban(reason=reason)
        await ctx.send("Le membre a bien été banni ✅")

async def setup(bot):
    await bot.add_cog(Ban(bot))
```

Dans un premier temps, nous retrouvons notre initialisation de la commande dans notre handler. 

Ensuite, nous avons notre bloc de conditions qui assure le bon fonctionnement de notre commande.

Pour finir, nous avons la ligne qui nous permet de ban le membre en question qui s'écrit tout simplement:

```python
await target.ban(reason=reason)
```

Pour la commande Unban, ça sera un peu différent car nous allons devoir indiquer à notre bot que la personne souhaitée est enregistrée parmi les membres bannis de notre serveur:

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

class Unban(commands.Cog):
    def __init__(self, bot):
        self.bot = bot

    @commands.command()
    async def unban(self, ctx: commands.Context, target: str, *, reason: str="") -> discord.Message:
        is_in_private = ctx.guild is None and isinstance(ctx.author, discord.TextChannel)
        if is_in_private:
            return await ctx.send("Vous ne pouvez pas exécuter cette commande en privé !")
        has_permissions = ctx.author.guild_permissions.ban_members
        if not has_permissions:
            return await ctx.send("Vous n'avez pas les permissions d'unban ce membre !")
        is_text_channel = isinstance(ctx.channel, discord.TextChannel)
        if not is_text_channel:
            return await ctx.send("Vous devez envoyer cette commande depuis un salon textuel !")
        
        banned_users = [ban_entry async for ban_entry in ctx.guild.bans()] # Ici on crée un tableau dans lequel on va inclure tout les membres bannis du discord pour pouvoir y accéder
        member_name, member_disriminator = target.split("#") # Ici on sépare le pseudo discord en deux à partir du # donc par exemple Naltos#1234 deviendra Naltos 1234

        for ban_entry in banned_users:
            user = ban_entry.user

            if (user.name, user.discriminator) == (member_name, member_disriminator): # Ici on vérifie si l'utilisateur en question fait bien partie de la liste des membres bannis en vérifiant son pseudo ainsi que son #
                await ctx.guild.unban(user, reason=reason)
                return await ctx.send(f"{user.name} a été débanni ! ✅")
        
        return await ctx.send("Je ne trouve pas {target} parmi les utilisateurs bannis !")
    
async def setup(bot):
    await bot.add_cog(Unban(bot))
```

Nous allons nous intéresser à deux lignes en particulier qui nous permettent d'aller chercher le membre banni qui nous intéresse:

```python
banned_users = [ban_entry async for ban_entry in ctx.guild.bans()] 
member_name, member_disriminator = target.split("#")
```

Notre première ligne permet d'enregistrer dans un tableau tous les membres bannis de notre serveur.

Notre seconde ligne permet de scinder notre string à partir d'un élément en particulier, ici le #. À noter qu'avec les nouveaux pseudos, cela peut ne pas être utile mais on ne sait jamais.

Passons ensuite au deuxième bloc le plus important:

```python
for ban_entry in banned_users:
    user = ban_entry.user

    if (user.name, user.discriminator) == (member_name, member_disriminator):
        await ctx.guild.unban(user, reason=reason)
        return await ctx.send(f"{user.name} a été débanni ! ✅")
```

Ici, retenez simplement que nous parcourons notre liste de bannis sur notre serveur et que parmi cette liste de bannis, nous allons chercher si le joueur indiqué dans notre commande fait bien partie des bannis.

Si c'est le cas, alors nous le débannons grâce à cette ligne:

```python
await ctx.guild.unban(user, reason=reason)
```

Et voilà, vous pouvez maintenant débannir n'importe qui depuis votre bot ! ✨

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

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