Portails de Rôles
Guide Utilisateur
Publiez un message avec un bouton : le membre qui clique reçoit un ou plusieurs rôles, à condition de posséder déjà les rôles que vous exigez. Idéal pour ouvrir l'accès à une section réservée après une première étape.
Ce que ça fait
- Publie un embed personnalisé accompagné d'un bouton, dans le salon de votre choix.
- Vérifie les rôles requis avant d'accorder quoi que ce soit.
- Attribue les rôles à donner en un clic, sans intervention du staff.
- Répond en privé dans le salon (message éphémère) : ni le succès ni le refus ne polluent la conversation.
- Le bouton reste actif dans le temps : il fonctionne encore après un redémarrage du bot.
Ce module n'est pas AutoRole, Role Gate ni RoleRoster
Quatre modules touchent aux rôles, avec des rôles bien distincts :
| Module | Principe |
|---|---|
| Portails de Rôles | Un bouton conditionnel : si vous avez les rôles A et B, alors vous obtenez le rôle C. |
| AutoRole | Des panneaux à menus déroulants où chacun se sert librement, et peut retirer ce qu'il a pris. Aucune condition. |
| Role Gate | Des rôles donnés automatiquement à l'arrivée, des échanges de rôles, et le retrait des rôles aux membres absents. Aucun clic. |
| RoleRoster | Un annuaire : affiche la liste des membres d'un rôle. N'attribue rien. |
Résumé : le portail est le seul des quatre à poser une condition avant d'accorder un rôle.
Démarrage rapide (Admin)
- Ouvrez le dashboard → catégorie Outils & Staff → Portails Sécurisés.
- Cliquez sur Nouveau Portail.
- Donnez un nom interne (il ne s'affiche pas sur Discord) et choisissez le salon de déploiement.
- Renseignez les rôles à attribuer — c'est obligatoire — et, si besoin, les rôles requis.
- Personnalisez l'embed et le bouton, puis Enregistrez.
- Dans la liste, cliquez sur l'icône d'envoi pour publier le panneau dans le salon.
Commandes
Ce module n'a aucune commande Discord : tout se configure depuis le dashboard, et les membres n'utilisent que le bouton du panneau.
Réglages depuis le dashboard
La liste des portails affiche pour chacun son nom, son salon, ses rôles requis et ses rôles donnés, avec trois actions : publier le panneau, modifier, supprimer.
La fenêtre de configuration regroupe quatre blocs :
- Informations de base : nom interne (obligatoire) et salon de déploiement (obligatoire).
- Conditions & Gains :
- Rôles requis — facultatif. Si vous laissez ce champ vide, tout le monde peut cliquer.
- Rôles à attribuer — obligatoire, un ou plusieurs rôles.
- Apparence (Embed) : titre, description et couleur.
- Bouton : texte affiché et emoji (avec sélecteur d'emojis).
Le nombre de portails est limité à 1 pour un serveur non premium (valeur par défaut, ajustable par l'équipe TennoCore).
Bon à savoir
- Le bot a besoin de la permission Gérer les rôles, et son rôle doit être placé au-dessus des rôles qu'il doit attribuer. Sinon le membre reçoit un message d'erreur mentionnant la hiérarchie.
- Les rôles requis sont vérifiés en ET : le membre doit posséder tous les rôles listés. S'il en manque, le bot lui indique précisément lesquels.
- Un membre qui possède déjà tous les rôles du portail reçoit une simple information, sans effet.
- Le portail ne retire jamais de rôle. Pour un fonctionnement en bascule (prendre / rendre), utilisez AutoRole.
- Modifier un portail ne modifie pas le message déjà publié : le texte, la couleur et le libellé du bouton restent ceux d'origine. Republiez le panneau pour obtenir un message à jour, puis supprimez l'ancien.
- Ne laissez pas plusieurs exemplaires du même portail dans le serveur : seul le dernier message publié est réactivé après un redémarrage du bot, les anciens boutons deviennent inertes.
- Supprimer un portail dans le dashboard ne supprime pas le message posté sur Discord : le bouton restera visible mais sans effet. Effacez le message à la main.
- Le salon doit être un salon où le bot peut écrire ; si le salon a été supprimé entre-temps, la publication échoue.
- Les portails fonctionnent aussi avec un bot personnalisé : le bouton est pris en charge par votre bot quand TennoCore n'est pas sur le serveur.