Discord Moderation Bot

Bot modulaire de modération de discorde

Un bot modulaire pour modérer les utilisateurs sur Discord! Ajoutez des commandes personnalisées et des gestionnaires d'événements pour personnaliser le bot à votre goût. Recharger le bot en utilisant la commande de !reload ou !reload events pour voir vos modifications appliquées en direct!

Une note concernant les intentions de messages

Ce bot ne fonctionnera que pour des robots plus petits car il nécessite l'utilisation d'intentions de messages, qui pour les bots plus grands, nécessite une vérification de Discord. Cela signifie que si votre bot sera dans plus de 100 severs, vous ne pourrez pas utiliser cette méthode de réalisation de commandes et devra coder vos propres gestionnaires de commandes à l'aide des nouvelles interactions.

Voir cette FAQ de Discord concernant ces changements.

Il existe un plan vague à mettre à jour pour utiliser les nouvelles commandes basées sur l'interaction qui offre une expérience utilisateur plus agréable, mais pour l'instant, il restera basé sur un message jusqu'à ce que je m'ennuie vraiment et que j'ai besoin de quelque chose à faire

Liens rapides

Ajout de vos propres commandes

Ajout de vos propres gestionnaires d'événements

Ajout de votre propre stockage persistant

Installation / configuration

Exigences d'installation

• Version Python > = 3,8
• Discord.py a été testé sur 2.3.2
  • Windows Install: python -m pip install discord.py
  • Installation de Linux: pip3 install discord.py

Création d'un compte bot avec Discord

1. Accédez au portail Discord Developer et créez une nouvelle application
2. Accédez à la section Bot et cliquez sur Add a bot . Remplissez les informations nécessaires (comme le nom et une image si vous le souhaitez)
3. Faites défiler jusqu'à la section Privileged Gateway Intents et assurez-vous de sélectionner l' SERVER MEMBERS INTENT et MESSAGE CONTENT INTENT . Cliquez sur Enregistrer pour que cela enregistre vos modifications!
4. Maintenant, faites défiler vers le haut et cliquez sur le bouton Reset Token , suivez les invites d'écran jusqu'à ce que vous puissiez copier ce jeton. C'est ainsi que le programme se connectera en tant que compte BOT. Ne partagez ce jeton avec personne!
5. Collez le jeton nouvellement copié dans un fichier texte appelé token.txt dans le même dossier que le fichier bot.py

Inviter le bot à votre serveur

1. Sur la page de demande de votre bot dans le portail Discord Developer, cliquez sur la section OAuth2 .
2. Cliquez maintenant sur la section URL Generator de la barre latérale
3. Sélectionnez la portée bot , puis sélectionnez l'autorisation Administrator dans la liste de cases Autorisations de bot nouvellement affichées
4. Copiez l'URL en bas et collez-le dans votre navigateur. Suivez les invites à l'écran pour inviter le bot sur votre serveur. Vous devez être un administrateur pour inviter le bot sur le serveur.

Courir le bot

1. Ouvrez une invite de commande dans le répertoire racine des fichiers bot (où se trouve bot.py ) et exécutez la commande python bot.py pour exécuter le bot.
2. Vous devriez voir une sortie à l'écran pour parler de commandes de chargement et de vous connecter en tant que bot. Si tout cela fonctionne, vous pouvez maintenant utiliser le bot!
3. Ajoutez tous les rôles de modérateur que vous souhaitez au bot en utilisant les commandes ci-dessous!

BOT INFORMATION

• Préfixe par défaut : !
• <argument> = argument requis
• [argument] = Argument facultatif
• Les durées peuvent être un temps formaté qui ressemble à ce qui suit: ( 1w2d3h4m5s ) ​​ou le temps en secondes.
• Les durées peuvent également utiliser des types uniques comme 2m ou 1w par exemple
• Toutes les commandes vous obligent à être dans un rôle de modérateur. Voir les commandes ci-dessous sur la façon d'ajouter ou de supprimer un rôle de mod (nécessite l'autorisation d'administration pour ajouter des rôles de mod)
• Lisez comment obtenir l'ID utilisateur ici

Commandes

• !mod <add|remove|list> <role ID>

  • Ajoute, supprime l'ID de rôle à la liste des rôles de modérateur.
  • Si vous souhaitez list les rôles, vous n'avez pas besoin de l'ID de rôle à la fin.

• !mute <user ID> [reason]

  • Mute en permanence l'utilisateur. Doit être inhabituel manuellement.

• !tempmute <user ID> <duration> [reason]

  • Mute temporairement l'utilisateur.

• !unmute <user ID>

  • Incompétent l'utilisateur

• !ban <user ID> <duration> <reason>

  • Interdit l'utilisateur du serveur pour la durée spécifiée
  • La raison est requise. Si vous n'avez pas de raison, vous ne devriez pas les interdire.

• !unban <user ID>

  • Débantir l'utilisateur du serveur.

• !reload

  • Recharger le registre des commandes pour toutes les modifications apportées aux commandes

• !reload events

  • Recharger le registre des événements pour toutes les modifications apportées

Comment obtenir l'ID utilisateur

Vous devez suivre le guide de discorde ici

Mais l'essentiel est:

• Activer le mode développeur dans Discord
• Cliquez avec le bouton droit sur leur nom d'utilisateur dans le chat ou sur la barre latérale
• Cliquez sur Copy ID

Problèmes avec les commandes personnalisées?

Assurez-vous que:

• Votre commande est une sous-classe de la classe de commande de base. (Utilisez from commands.base import Command , puis définissez la classe comme ceci: class MyCommand(Command): donc c'est une sous-classe de celui-ci)
• Il a un async def execute(self, message, **kwargs): fonction pour exécuter la commande
• Il n'a pas d'erreurs de syntaxe Python de base.