🎭 Auto-Rôle

Le module Auto-Rôle couvre trois mécanismes distincts d'attribution de rôle, tous configurables indépendamment.

🚪 Rôle à l'arrivée

Un ou plusieurs rôles sont automatiquement donnés à chaque nouveau membre humain qui rejoint le serveur.

🤖 Rôle des bots

Une liste de rôles séparée peut être définie spécifiquement pour les bots ajoutés au serveur — pratique pour leur donner d'office les permissions ou l'identité visuelle adaptées, sans toucher aux rôles des humains.

🎙️ Rôle vocal automatique

Un rôle peut être attribué automatiquement à un membre dès qu'il rejoint un salon vocal, et retiré dès qu'il le quitte (le salon AFK du serveur est ignoré). Ce rôle se resynchronise aussi au redémarrage du bot : si des membres étaient déjà en vocal, ils reçoivent le rôle sans attendre un nouveau changement d'état.

🎛️ Panneaux de rôles cliquables

Tu peux publier un panneau de rôles : un message (embed) avec des boutons, un par rôle proposé. Chaque bouton :

• Ajoute le rôle au clic si le membre ne l'a pas, le retire s'il l'a déjà (toggle).
• A un libellé, un emoji et un style (primaire, succès, danger, secondaire) personnalisables.

Les panneaux restent fonctionnels même après un redémarrage du bot (les boutons sont ré-attachés automatiquement).

[!NOTE] Le rôle du bot doit être positionné au-dessus des rôles qu'il doit attribuer dans la hiérarchie des rôles Discord, sinon l'attribution échoue silencieusement (erreur de permission).

📌 Rôles persistants (sticky roles)

Si activé, les rôles d'un membre sont mémorisés à son départ et restaurés automatiquement s'il revient sur le serveur, plutôt que de repartir de zéro.

🚀 Rôle booster

Synchronise automatiquement un rôle dédié avec le statut booster du serveur (attribué quand un membre boost, retiré quand il arrête).

🎁 Rôle de parrainage

Un rôle peut être attribué automatiquement quand un membre atteint un seuil de parrainage (nombre d'invitations valides), avec un message privé optionnel pour le prévenir.

🔁 Resynchronisation

Une vérification quotidienne recale les rôles auto-attribués (arrivée, vocal, booster) sur l'état réel du serveur, pour rattraper d'éventuels décalages (redémarrage manqué, changement Discord non détecté...).

📋 Logs (staff)

Journal des rôles attribués/retirés via un panneau de rôles ou une réaction, dans un salon staff dédié.

⚙️ Configuration

Tous les réglages (rôles à l'arrivée, rôles bots, rôle vocal, panneaux) se retrouvent dans Configurer → Auto-Rôle du dashboard.

🧪 Exemple concret

Pour donner automatiquement le rôle @Membre à chaque arrivant sur Mon Serveur : Configurer → Auto-rôle, ajoute @Membre à la liste, enregistre. Le rôle du bot doit être placé au-dessus de @Membre dans Paramètres du serveur → Rôles, sinon Discord refuse de l'attribuer.