🛬Rôles à l'arrivée

📌 Documentation du système d'AutoRole dans TennoCore

Le système d'AutoRole de TennoCore permet d’attribuer automatiquement des rôles aux nouveaux membres qui rejoignent le serveur. Il offre également la possibilité de gérer ces rôles dynamiquement via des commandes slash.


🛠 Fonctionnalités principales :

  1. Attribution automatique de rôles 🎭

    • Lorsque un nouveau membre rejoint le serveur, il reçoit immédiatement les rôles définis par un administrateur.

  2. Ajout et gestion flexible des rôles ⚙️

    • Les administrateurs peuvent ajouter jusqu’à 3 rôles en une seule commande.

    • Les rôles ajoutés sont cumulatifs, sans suppression des anciens.

  3. Stockage en base de données SQLite 📂

    • Les rôles configurés sont enregistrés et persistent même après un redémarrage du bot.

  4. Commandes de gestion du système AutoRole 🛠

    • /autorole ➜ Ajoute des rôles automatiques pour les nouveaux membres.

    • /liste_autorole ➜ Affiche les rôles automatiques actuellement configurés.

    • /supprimer_autorole ➜ Supprime tous les rôles automatiques enregistrés.


📌 Comment configurer l’AutoRole ?

Les administrateurs peuvent configurer l’attribution automatique des rôles via la commande :

/autorole @Rôle1 @Rôle2 @Rôle3
  • @Rôle1, @Rôle2, @Rôle3 : Rôles à attribuer aux nouveaux membres.

  • Si des rôles existent déjà, les nouveaux rôles sont ajoutés sans supprimer les anciens.

Exemple d’utilisation :

/autorole @Membre @Vérifié

➜ Tous les nouveaux arrivants recevront les rôles @Membre et @Vérifié automatiquement.


📌 Vérifier les rôles AutoRole actifs

Pour voir quels rôles sont actuellement attribués automatiquement, utilisez :

/liste_autorole

Le bot retournera :

📜 Rôles automatiques configurés : @Membre, @Vérifié

Si aucun rôle n’est enregistré, il affichera :

❌ Aucun rôle automatique configuré.

📌 Supprimer l’AutoRole

Si vous souhaitez désactiver l’attribution automatique des rôles :

/supprimer_autorole

Le bot confirmera :

✅ Les rôles automatiques ont été supprimés.

Cette action supprimera tous les rôles AutoRole enregistrés pour le serveur.


🔄 Fonctionnement interne

  1. Stockage en SQLite

    • Les rôles sont enregistrés dans une base de données (autorole.db).

    • Lorsqu'un utilisateur rejoint, les rôles sont récupérés et appliqués automatiquement.

  2. Écoute des événements Discord

    • Dès qu’un nouvel utilisateur rejoint, l’événement on_member_join est déclenché.

    • Le bot récupère les rôles associés au serveur et les applique immédiatement.

  3. Persistance des données

    • Même après redémarrage du bot, les rôles restent enregistrés et fonctionnels.


📌 Conclusion

Le système d’AutoRole de TennoCore est un outil simple et puissant qui facilite la gestion des rôles pour les nouveaux membres d’un serveur Discord. Grâce à une base de données persistante et une gestion flexible, il offre une solution efficace pour automatiser l’attribution des rôles sans intervention manuelle.

🚀 Un must-have pour les communautés cherchant à automatiser la gestion des nouveaux arrivants !

Dernière mise à jour