Cette page explique comment Dispatch.IO décide qui peut faire quoi dans ta communauté Fluxer : la permission demandée pour chaque commande, les permissions dont le bot a lui-même besoin, la hiérarchie des rôles de Fluxer, les rôles de staff reconnus par le bot et les droits particuliers du propriétaire. Elle s'adresse aux propriétaires et administrateurs qui organisent leur équipe de modération.
Astuce
La configuration la plus simple : invite le bot avec la permission Administrateur, place son rôle tout en haut de la liste des rôles, et donne à tes modérateurs les permissions Fluxer des commandes qu'ils utilisent.
Comment le bot vérifie les permissions
Fluxer n'a pas de commandes slash : il ne peut donc pas masquer une commande aux membres qui n'ont pas le droit, comme Discord. C'est le bot qui vérifie tout, dans cet ordre, à chaque commande :
Chaque refus est une réponse courte supprimée après 5 secondes, avec ta commande. Le nom de la permission y est écrit en anglais (« Ban Members »), comme dans l'API de Fluxer : le tableau Permission requise pour chaque commande donne son nom français.
Les permissions du bot
À l'invitation
Le lien d'invitation demande Administrateur : c'est le plus simple, et c'est ce que le bot attend. Sans elle, il lui faut au minimum :
| À quoi elles servent | Permissions Fluxer |
|---|---|
| Lire et répondre | Voir le salon, Envoyer des messages, Intégrer des liens, Joindre des fichiers, Voir l'historique des messages |
| Boutons en réactions, emojis du bot | Ajouter des réactions, Utiliser des emojis externes |
Réponses supprimées après 5 s, anti-raid, !clear | Gérer les messages |
Tickets, salons temporaires, !nuke, !toggle-lock | Gérer les salons, Gérer les rôles |
| Rôles de bienvenue, récompenses, rôles par réaction | Gérer les rôles |
| Modération | Bannir des membres, Expulser des membres, Appliquer une restriction temporaire aux membres, Déplacer des membres |
Flammes dans les pseudos, !rename | Gérer les surnoms |
| Journaux (auteur des actions), invitations | Voir le journal d'activité, Gérer la communauté, Gérer les webhooks |
!emoji | Créer des emojis et des stickers, Gérer les emojis et les stickers |
| Musique et radio (dans le salon vocal) | Se connecter, Parler |
La place du rôle du bot
Sur Fluxer comme sur Discord, un rôle ne peut donner que les rôles placés en dessous de lui, et un membre ne peut sanctionner que les membres dont le rôle le plus haut est en dessous du sien. Fluxer a une règle en plus :
À position égale, le plus ancien gagne
Deux rôles peuvent avoir la même position. Fluxer place alors au-dessus le rôle le plus ancien. Un rôle que tu viens de créer arrive en bas de la liste (position 1), sous le rôle du bot s'il est aussi à cette position : glisse le rôle du bot au-dessus pour éviter toute surprise.
Place le rôle Dispatch.IO au-dessus :
- des rôles qu'il donne (bienvenue, récompenses de niveau et de flamme, panneaux de rôles,
!role-all) ; - des membres qu'il sanctionne (
!timeout,!kick,!ban, anti-raid) ou renomme (flammes,!rename).
Le bot ne donne jamais un rôle placé au-dessus de lui, ni un rôle « dangereux » (Administrateur, Gérer la communauté, Gérer les rôles, Bannir, Expulser…) par un panneau de rôles.
Permissions vérifiées par commande
Avant certaines commandes, le bot vérifie qu'il a les permissions nécessaires et répond « Il me manque la permission … » sinon :
| Commande | Permission du bot vérifiée |
|---|---|
!ban, !unban, !banlist | Bannir des membres |
!kick | Expulser des membres |
!timeout, !end-timeout, !force-disconnect | Appliquer une restriction temporaire aux membres |
!clear | Gérer les messages |
!nuke | Gérer les salons |
!toggle-lock | Gérer les salons, Gérer les rôles |
!role-all | Gérer les rôles |
!play, !play-now, !play-radio | Voir le salon, Se connecter, Parler (dans ton salon vocal) |
Pour les autres, une permission manquante fait simplement échouer l'action (et un journal Erreur de permission est publié dans le Salon logs serveur quand c'est prévu).
Permission requise pour chaque commande
| Permission Fluxer du membre | Commandes |
|---|---|
| Aucune | !help, !ping, !prefix (affichage), !info, !profil, !premium, !rename (soi-même), !report, !upload-image, !translate, !hello, !giphy, !rank, !top, !streak, !achievements, !bump, !poll, !botlist, !infractions (les tiennes), !ticket-manager (dans un ticket, selon ton rôle), !zulu, !metar, !frequencies, les commandes de musique (!play, !play-radio, !queue, !title, !volume, !stop…, avec la règle du demandeur) |
| Gérer la communauté | !prefix <nouveau> |
| Appliquer une restriction temporaire aux membres | !warn, !timeout, !end-timeout, !force-disconnect, !snipe, !infractions @membre |
| Expulser des membres | !kick |
| Bannir des membres | !ban, !unban, !banlist |
| Gérer les salons | !toggle-lock |
| Gérer les emojis et les stickers | !emoji |
| Administrateur | !config, !clear, !nuke, !say, !role-all, !modify-xp, !reset-levels, !raid-mode, !giveaway, !create-embed, !edit-embed, !create-container, !edit-container, !create-banner |
Les commandes de l'équipe Dispatch.IO (!badge, !manage-badge, !flag) ne répondent qu'aux créateurs du bot.
Les rôles de staff ADMIN et MODO
En plus des permissions Fluxer, le bot connaît deux types de rôle de staff enregistrés pour chaque communauté : ADMIN et MODO. Sur Fluxer, ils servent surtout à protéger :
- un membre avec un rôle ADMIN ne peut être sanctionné que par le propriétaire ;
- un membre avec un rôle MODO ne peut être sanctionné que par le propriétaire ou un administrateur (rôle ADMIN ou permission Administrateur) ;
- un rôle MODO (ou ADMIN) permet aussi de consulter les infractions des autres membres avec
!infractions @membre.
Note
Pour lancer une commande de modération, il faut la permission Fluxer indiquée ci-dessus : un rôle MODO sans la permission ne suffit pas. Si ta communauté n'a pas de rôles ADMIN et MODO, le bot se base uniquement sur les permissions Fluxer : c'est le cas normal.
Qui peut sanctionner qui
Les commandes de modération protègent le propriétaire et le staff. Chaque refus affiche un message clair, par exemple « Vous ne pouvez pas bannir un membre avec un rôle supérieur ou égal au vôtre. ».
| Règle | !ban | !kick | !timeout | !warn | !end-timeout | !force-disconnect | !unban |
|---|---|---|---|---|---|---|---|
| Le propriétaire ne peut pas être visé | Oui | Oui | Oui | Non | Non | Non | Oui |
| Le bot lui-même ne peut pas être visé | Oui | Oui | Oui | Oui | Oui | Oui | — |
| Le rôle de l'auteur doit être au-dessus de la cible | Oui | Oui | Oui | Non | Non | Non | Non |
| Le rôle du bot doit être au-dessus de la cible | Oui | Oui | Oui | Non | Non | Non | Non |
| Cible avec un rôle ADMIN | Propriétaire seulement | Propriétaire seulement | Propriétaire seulement | Propriétaire seulement | Propriétaire seulement | Propriétaire seulement | — |
| Cible avec un rôle MODO | Propriétaire ou admin | Propriétaire ou admin | Propriétaire ou admin | Propriétaire ou admin | Propriétaire ou admin | Propriétaire ou admin | — |
« Au-dessus » suit la règle de Fluxer : position plus haute, ou même position et rôle plus ancien.
Les droits du propriétaire
Le propriétaire de la communauté a toujours toutes les permissions : il peut utiliser toutes les commandes et il a accès au tableau de bord. Le bot lui donne en plus ces droits :
- Protection : il ne peut pas être visé par
!ban,!kick,!timeoutni!unban. - Sanctionner le staff : il est le seul à pouvoir sanctionner un membre qui a un rôle ADMIN.
- Anti-raid : il est sur la liste blanche de toutes les protections dès l'arrivée du bot.
- Alertes : tant qu'aucune mention d'urgence n'est réglée sur le site, c'est lui qui est mentionné sur les logs critiques (anti-raid, sanctions).
- Infractions : avec les membres qui ont la permission Administrateur, il peut supprimer une infraction (lien envoyé avec
!infractions). - Pseudo : il n'est jamais renommé par les flammes.
Donner les bons droits à ton équipe
Les droits passent par les permissions Fluxer de tes rôles (Paramètres de la communauté → Rôles). Exemple pour la communauté Café des Devs :
| Rôle | Permissions à donner | Commandes du bot accessibles |
|---|---|---|
| @Modérateurs | Appliquer une restriction temporaire aux membres, Expulser des membres, Bannir des membres | !warn, !timeout, !end-timeout, !force-disconnect, !snipe, !kick, !ban, !unban, !banlist, !infractions @membre |
| Rôle d'administration | Administrateur | Toutes les commandes |
| @Membres | Aucune permission particulière | Les commandes publiques (!profil, !top, !bump…) |
Pour la protection entre membres du staff, pense à la hiérarchie : place le rôle @Modérateurs au-dessus de @Membres, et le rôle du bot au-dessus de tous.
Qui peut configurer le bot
| Où | Qui |
|---|---|
| Tableau de bord du site | Le propriétaire et les membres avec Administrateur ou Gérer la communauté. |
!prefix <nouveau> | Les membres avec Gérer la communauté. |
!raid-mode, !config | Les membres avec Administrateur. |
Les changements faits sur le site sont enregistrés dans le Salon logs serveur, avec le nom de leur auteur. Le détail des réglages est dans Configuration du bot.
Les rôles des comptes sur le site (équipe Dispatch.IO, pages d'administration) sont un système à part : voir Gestion des permissions.
Problèmes fréquents
| Problème | Cause probable | Solution |
|---|---|---|
| « Il te faut la permission … » | Le membre n'a pas la permission Fluxer de la commande | Donne la permission à son rôle (tableau ci-dessus). |
| « Il me manque la permission … » | Le rôle du bot n'a pas la permission | Ajoute la permission au rôle du bot, ou rends-lui Administrateur. |
| « Je ne peux pas bannir ce membre car son rôle est supérieur ou égal au mien. » | Le rôle du bot est sous celui de la cible (ou à la même position et plus récent) | Monte le rôle du bot dans Paramètres de la communauté → Rôles. |
| Le bot ne répond à aucune commande | Mauvais préfixe, ou le bot ne voit pas le salon | Mentionne le bot (@Dispatch.IO help) pour voir le préfixe ; vérifie Voir le salon et Envoyer des messages pour son rôle. |
| Ma commande reste dans le salon après la réponse | Le bot n'a pas Gérer les messages dans ce salon | Donne-lui la permission, ou ignore : seule ta commande reste. |