Rôles Discord, synchronisation et « Membre suspendu »

En bref. Avec le bot Discord configuré, chaque groupe du forum peut être relié à un rôle Discord. Donner le groupe donne le rôle, retirer le groupe retire le rôle. Le réglage Membre suspendu décide de ce qui arrive aux rôles pendant une suspension.

Relier un groupe à un rôle #

1. Configure le bot : voir Relier Discord.
2. Administration → Configuration → Connexion Discord, section Rôles Discord des groupes.
3. Pour chaque groupe, choisis le rôle dans la liste des rôles de ton serveur.
4. Enregistrer.

Un rôle affiché « ⚠ rôle introuvable » a été supprimé sur Discord : choisis-en un autre. Un rôle « (géré par une intégration) » ne peut pas être attribué. Si un rôle n'arrive pas, un bot ne pouvant donner que les rôles placés sous le sien, voir Permission Discord manquante ; l'aide officielle de Discord explique la hiérarchie : Rôles et permissions dans Discord.

Un rôle trop haut est refusé d'avance #

Un rôle que le bot ne pourra pas donner (placé au-dessus du sien ou au même rang, ou géré par une intégration) est grisé dans la liste, avec la raison. Le choisir malgré tout (formulaire périmé) est refusé à l'enregistrement : rien n'est écrit. Si Discord ne répond pas, l'enregistrement a lieu quand même, avec un avertissement. Si tu déplaces ensuite les rôles dans Discord, les correspondances devenues impossibles apparaissent en rouge dans Administration → Configuration → Connexion Discord, sous Correspondances que Discord refusera, avec un bouton Ouvrir dans l'app Discord vers l'écran où corriger. La même règle vaut pour les rôles par grade du MDT (voir plus bas).

Quand les rôles bougent #

La bannière de Administration → Configuration → Connexion Discord affiche le nombre d'échecs de synchronisation. La fiche d'un membre montre les derniers appels à Discord (le journal de synchronisation est gardé 90 jours).

• Un rôle que le membre tient par un autre groupe n'est jamais retiré. Retirer un groupe, ou changer de grade, ne prive pas le membre d'un rôle que l'un de ses autres groupes lui donne.
• Un rôle que Discord refuse de retirer est dit à l'écran au lieu d'un « fait » trompeur, et le refus est consigné dans Administration → Erreurs.
• Le menu des rôles marque les rôles de pouvoir (Administrateur, Bannir, Gérer les rôles…). Une candidature qui accorde un groupe relié à l'un d'eux ne peut être acceptée que par un administrateur, comme pour un groupe de pouvoir du site.

Quand Discord fait foi : « Synchroniser Discord → Agora » #

Par défaut, Agora pousse : donner le groupe donne le rôle. Pour un groupe dont tu gères déjà les rôles dans Discord (un rôle de whitelist donné par un autre bot, un rôle d'abonné…), tu peux inverser le sens, groupe par groupe. Sous la correspondance du groupe, la case Synchroniser Discord → Agora est décochée par défaut. Cochée :

• un membre qui reçoit ce rôle sur Discord est ajouté au groupe sur le site ; s'il le perd (ou quitte le serveur), il est retiré du groupe ;
• Agora ne pousse plus rien vers Discord pour ce groupe : la fiche du membre affiche « géré par Discord » ;
• le rang du rôle n'a plus d'importance (le bot ne l'attribue jamais, il l'écoute) ;
• chaque ajout ou retrait est écrit dans le journal d'administration, auteur Discord.

Jamais pour un groupe de pouvoir : la case est grisée (et refusée à l'enregistrement) pour admin, moderateur, les groupes de la page Staff, les groupes qui portent des droits et les groupes examinateurs de candidatures. Les grades du MDT ne sont pas concernés : ils viennent du jeu.

Comment ça marche. Agora écoute Discord par une connexion ouverte seulement quand au moins une case est cochée (aucune tâche périodique), et applique les événements aux comptes liés par leur identifiant Discord. Un membre sans compte est aligné à sa première connexion. Au démarrage et après toute reconnexion non reprise, Agora relit une fois les rôles des membres liés pour rattraper un événement manqué ; le bouton Resynchroniser fait la même relecture à la demande. La date de dernière relecture n'apparaît que si Discord a vraiment été lu : sans date, rien n'a encore été relu (connexion à Discord pas établie, par exemple).

Deux modes (l'écran indique lequel est actif) :

Pour passer du repli au mode complet : active Server Members Intent, puis clique Resynchroniser. Si ça ne marche pas : Permission Discord manquante, cause 5.

Les rôles Discord des grades (MDT) #

Dans MDT → Configuration, le bloc Discord du service peut donner un rôle par grade d'un job. Agora pose le rôle du grade tenu et retire les autres rôles de grade de ce job :

• à l'ouverture du MDT (au plus toutes les 10 minutes par membre) ;
• dès que le jeu annonce un changement de job ou de grade (embauche, promotion, départ), même si le membre n'a plus aucun service MDT : celui qui quitte la police perd le rôle de son grade sans rien ouvrir. Le grade annoncé demande la ressource à jour ; une ressource plus ancienne signale seulement le changement de job (voir Mettre à jour la ressource).

Règles de sûreté :

• Un rôle de grade d'un job que le membre n'a jamais tenu (posé à la main) n'est pas retiré par ce changement.
• Les rôles tenus par un groupe du forum ne sont jamais retirés.
• Les jobs de tous ses personnages comptent : le rôle reste tant qu'un de ses personnages tient encore le grade. En multi-job (Qbox), changer de job actif ne retire rien ; seuls les jobs réellement quittés comptent.
• Un membre suspendu avec l'option « retirer ses rôles » perd aussi ses rôles de grade ; ils reviennent à la levée.

Le réglage « Membre suspendu » #

Administration → Configuration → Connexion Discord, bloc Membre suspendu :

Pour le refus de connexion :

• il faut la ressource 1.9.8 ou plus récente ;
• le joueur est reconnu par sa liaison du jeu (son compte relié par code) ;
• il voit « Ton compte de la communauté est suspendu jusqu'au … : la connexion au serveur de jeu t'est refusée pendant la suspension », avec le motif ;
• si Agora ne répond pas, la connexion est laissée passer.

Chaque changement de ce réglage est inscrit au journal d'administration.