Langue
Anvil · Discord7 min de lecture

Anvil dans Discord

Un bot, une invitation, et aucune application à enregistrer. Voici ce qu’il publie, où il le publie, ce qu’il peut modifier sur votre serveur — et quoi regarder le jour où il s’arrête.

Un bot partagé, rien à créer~5 min de l’invitation au premier messageSur demande chaque flux est coupé tant que vous ne le dirigez pas
Cette traduction en Français n’a encore été relue par aucun locuteur natif. Si une phrase sonne faux, la page anglaise est l’original — et nous le signaler est ce qui la corrigera.
Étape 1

Un bot, déjà construit

#

Il n’y a aucune application Discord à créer, aucun token à générer et aucun secret à coller. Anvil fait tourner un bot que chaque clan partage, donc se connecter est une invitation et rien d’autre.

Vous pouvez tout de même amener le vôtre — collez un token sous Use your own bot instead (advanced) et il sera utilisé à la place. Cela ne vaut le coup que si vous voulez que le bot porte le nom et l’avatar de votre clan dans la liste des membres ; tout ce guide fonctionne pareil dans les deux cas.

Voir les salons, Envoyer des messages, Intégrer des liens, Joindre des fichiersLa base. Sans cela, il est sur votre serveur et muet.
Gérer les webhooksPour que Set it up for me et Post here puissent créer des webhooks à votre place, au lieu que vous copiiez des URL depuis Discord à la main, et pour qu’Anvil puisse trouver d’anciens webhooks à supprimer.
Gérer les rôlesUniquement si vous activez la synchronisation des rôles. Il peut alors distribuer les rôles que vous associez — et il ne peut jamais toucher un rôle au-dessus du sien, ce qui est la règle de Discord, pas la nôtre.
Gérer les pseudosUniquement si vous activez la synchronisation des pseudos, pour que le pseudo serveur d’un membre puisse être mis à son RSN.
Gérer les salonsPour les salons privés des équipes pendant une draft, et pour les guides publiés comme nouvelle catégorie ou forum. Sans elle, tout le reste fonctionne quand même.
Gérer les fils, Envoyer des messages dans les filsPour les guides publiés dans un forum : écrire dans la publication, puis la supprimer — sans cette permission, Discord ne laisse pas un bot supprimer même sa propre publication.
Changer le pseudoSeulement si vous donnez au bot le nom de votre clan sous Connection → Bot appearance in your server. Cela ne change son nom que sur votre serveur.
Il demande tout d’un coup
Discord n’a aucun moyen de demander une permission plus tard, donc le lien d’invitation réclame l’ensemble, et les fonctions que vous n’activez jamais n’utilisent jamais les leurs. Rouvrir le lien d’invitation est aussi la façon de réparer une permission que quelqu’un a retirée.
Étape 2

Le connecter

#

Deux choses, dans cet ordre. Le bot doit être sur votre serveur, et Anvil doit savoir quel serveur est le vôtre.

Inviter le botAdmin → Discord → Connect your Discord server (ou Add Anvil to Discord). Discord vous demande sur quel serveur ajouter Anvil et vous renvoie ici, vous ne pouvez donc pas l’ajouter au mauvais par accident. Plus tard, Invite / re-invite the bot se trouve sous More settings → Connection.
Renseigner l’identifiant du serveurSeulement si le bouton n’y arrive pas : ouvrez Can’t use the button? Enter the server ID, faites un clic droit sur l’icône de votre serveur dans Discord → Copier l’identifiant du serveur (nécessite d’activer le Mode développeur, dans la section Avancés des paramètres de Discord lui-même), collez-le dans Your Discord server’s ID et appuyez sur Save. C’est ce champ qui rend la connexion propre à vous.

Le panneau vous dit ensuite la vérité plutôt que votre intention : si le bot est réellement membre de ce serveur, et quelles permissions lui manquent. Une ligne verte là vaut plus qu’un formulaire enregistré.

L’identifiant du serveur est tout le lien
Un serveur appartient à exactement un clan sur Anvil, et les commandes slash venant d’un serveur que personne n’a revendiqué sont refusées plutôt que devinées. Tant que vous ne le renseignez pas, le bot est invité et inactif.
Étape 3

Configurer les webhooks

#

Anvil publie via des webhooks, un par salon, et chacun est facultatif. Rien n’est publié nulle part tant que vous ne dirigez pas un flux vers un salon — un clan tout neuf est silencieux à dessein, pas par accident.

Avec le bot Anvil sur votre serveur, Set it up for me, en haut de Admin → Discord, crée les salons et y dirige chaque flux. Pour le faire à la main, ouvrez More settings → What goes where et commencez par le Catch-all channel de l’onglet Clan & events, puis le In-game catch-all de l’onglet In-game (plugin) : choisissez un salon dans la liste déroulante et c’est enregistré. Sans le bot, ouvrez dans ce salon Discord Modifier le salon → Intégrations → Webhooks, créez-en un, copiez son URL, choisissez Paste a webhook… dans la liste déroulante, collez-la et appuyez sur Save. Une URL de webhook peut publier dans son salon : traitez-la comme un mot de passe ; si elle fuit, supprimez-la dans Discord et recréez-en une. Test, et Add another pour répartir les publications chargées entre deux webhooks, se trouvent sous Post without a bot.

Canal généralLe principal, dans l’onglet Clan & events. Débuts et fins d’événements, ouvertures d’inscriptions, classements, résultats hebdomadaires : tout ce que le site publie sans canal dédié. Si vous ne configurez que celui-ci, votre clan fonctionne déjà.
Canal général in-gameDans l’onglet In-game (plugin) : là où va tout ce qui vient du jeu quand il n’a pas de canal dédié. À configurer en second.
Jalons et plusDans l’onglet In-game (plugin). Slayer, clues, speedruns, kill counts, paris BA et messages de chat personnalisés sont publiés ici, une fois que les joueurs les ont activés. Son bouton Filters définit ce que votre clan offre à ses membres par défaut. Les modèles personnels des joueurs et les types privés se trouvent dans Settings, page by page.
Les flux séparésLes posts d’événements, les tableaux que vous co-animez, le Skill & Boss of the Week et les événements du calendrier du clan peuvent être séparés du canal général. Les drops rares, pets, collection log, niveaux, combat achievements, quêtes, journaux, morts et kills PvP peuvent être séparés du canal général in-game. Les changements de roster, les validations d’inscription et le journal de la cagnotte restent sur Staff only. Un flux séparé vide revient à son canal général. La cagnotte fait exception : vide signifie qu’aucun argent n’est publié. Leagues et les autres modes ont leur propre onglet Game modes.
Séparez les morts en premier
Les morts sont le flux au plus gros volume sur la plupart des tableaux et celui qui enterre tout le reste. Si vous ne séparez qu’une chose, séparez celle-là.
Étape 4

Leagues, Deadman et autres modes

#

Leagues, Deadman, hardcore et les autres modes tournent sur leurs propres mondes, avec leurs propres personnages. Leurs posts sont toujours étiquetés et ne comptent jamais pour les tableaux ni pour les compétitions. Ils ont leur propre onglet : Admin → Discord → What goes where → Game modes. Un mode y apparaît la première fois qu’un membre y joue.

Chaque mode a un interrupteur et un canal To. Activez Send game-mode posts to their own channels pour utiliser ces canaux ; si vous le laissez désactivé, chaque mode publie dans les canaux habituels, toujours étiqueté. Le bouton Posts sur la ligne d’un mode liste tous les types qu’il envoie, les habituels comme les événements propres au mode, chacun avec son propre interrupteur.

Sous cette liste, Custom thresholds permet à un mode de publier moins que le jeu principal. Post drops rarer than 1 in… (au moins 2) et Post drops worth at least (gp) (au moins 1,000) fixent leurs propres seuils (vide = identique au jeu principal). Appuyez ensuite sur Save drop thresholds : les objets toujours publiés le restent, mais les drops qui ne comptent que par leur valeur ne le sont plus. Use its own level milestones ne publie un passage de niveau que s’il respecte les deux jeux de règles.

Plus strict, jamais plus souple
Les filtres d’un mode ne peuvent que retirer des publications. Le plugin a déjà appliqué vos réglages du jeu principal, donc aucun filtre de mode ne peut faire revenir une publication.
Étape 5

Anciens webhooks d’autres plugins ou bots

#

Avec le bot sur votre serveur, la page Discord liste chaque webhook qui s’y trouve et qui n’appartient pas à Anvil. Coming from other plugins? propose Use the same channels, pour que Set it up for me publie là où vos anciens flux publiaient et que rien ne bouge pour vos membres.

Une fois vos membres sur Anvil, allez dans Remove old webhooks from other plugins, cochez ceux à supprimer et appuyez sur Remove … webhooks, puis sur Yes, remove them. Cela les supprime définitivement dans Discord — c’est irréversible.

La liste contient tout webhook qui n’appartient pas à Anvil, pas seulement ceux d’autres plugins. Il y en a un que vous voulez garder, comme le flux d’un autre bot ? Appuyez sur Keep et il quitte la liste ; Show kept et Put back le font revenir. Le garder ne fait que le masquer ici — rien ne change dans Discord.

Nécessite « Gérer les webhooks »
Le bot lit les webhooks de votre serveur pour les trouver. Sans Gérer les webhooks sur son rôle, la page indique qu’il ne peut pas les voir.
Étape 6

Rôles et pseudos

#

Les deux synchronisations sont coupées jusqu’à leur activation sous Admin → Discord → Roles & nicknames, et toutes deux suivent la liste des membres. Activez Enable Discord role sync, laissez Auto-match in-game rank → Discord role by name activé, choisissez au besoin des Member roles et Guest roles généraux, enregistrez, puis appuyez sur Sync roles & nicknames now. Chaque personne doit aussi avoir un compte Discord lié ; le rapport de synchronisation nomme quiconque n’a pas pu être identifié.

Synchronisation des rôlesAssociez vos rangs en jeu à des rôles Discord et Anvil les maintient alignés. Il y a aussi des rôles uniques pour les membres, les invités, les capitaines et l’événement en cours, pour pouvoir mentionner les bonnes personnes sans tenir une liste à la main.
Synchronisation des pseudosMet le pseudo serveur d’un membre à son RSN. Par défaut elle remplit un pseudo vide, et on peut lui demander d’écraser celui que quelqu’un a choisi — c’est le réglage auquel réfléchir avant, pas après.
Le rôle du bot doit être au-dessus de ceux qu’il gère
Discord n’autorise aucun bot à toucher un rôle au niveau du sien ou au-dessus, et il refuse en silence de votre côté — la synchronisation ne fait alors simplement rien. Remontez le rôle Anvil dans Paramètres du serveur → Rôles et ça se met à marcher ; rien n’a besoin d’être réinvité.
Étape 7

Commandes slash

#

Le bot répond à /bingo sur votre serveur (la grille, le classement, les règles, votre propre carte), ainsi qu’à des commandes de clan comme /sotw, /stats et /coffer. Elles lisent le site en direct, donc personne n’a à quitter Discord pour savoir où il en est. Chaque commande et ses options a sa propre page.

Elles apparaissent une minute environ après l’arrivée du bot. Si elles n’apparaissent jamais, l’invitation a accordé le bot mais pas ses commandes — ce sont deux permissions distinctes, et un ancien lien d’invitation n’en demandait qu’une. Relancez Invite / re-invite the bot sous Connection sur la page Discord ; cela n’expulse pas le bot et ne réinitialise rien.

Il répond dans la langue de chacun
Par défaut, le bot répond dans la langue que ce membre a réglée dans Discord, avec l’anglais en repli. Choisissez une seule langue sous Langue du bot pour l’imposer à tous — c’est aussi le seul moyen d’avoir l’arabe, puisque Discord n’a pas de langue client arabe à détecter.
Étape 8

Ce qu’il publie, et quand

#

Deux sources, et il vaut la peine de savoir laquelle est laquelle quand quelque chose semble anormal.

Le site publie les événements : un tableau qui ouvre, les inscriptions, un lancement, les classements, le résultat. Cela part d’Anvil lui-même et fonctionne que quelqu’un ait le plugin ou non.

Le plugin publie ce qui se passe en jeu : drops, familiers, morts, niveaux, cases du collection log, combat achievements. Cela n’existe que pour les membres qui le font tourner, donc un salon de drops silencieux signifie en général un plugin silencieux plutôt qu’un webhook cassé.

Rien n’est publié deux fois
Un drop qui complète une case fait un message, pas un du plugin et un autre du tableau.
Étape 9

Seuils de drop

#

Anvil démarre à 1m gp ou 1 in 1,000. Un drop est publié dès qu’il atteint l’un des deux. Personne ne peut fixer des valeurs inférieures à celles-ci, et 0 désactive un seuil.

Définissez les valeurs par défaut de votre clan dans Admin → Discord → What goes where → Drops : Default minimum drop value (gp), Default: post drops rarer than 1 in… et Require both. Activez Require both et un drop doit atteindre la valeur and la rareté.

Chaque personnage suit la valeur par défaut du clan dont il est membre, et celle d’Anvil s’il n’en a pas. Les joueurs peuvent choisir leurs propres valeurs dans Settings. Il affiche Using clan default ou Custom, et Reset revient en arrière.

Hard floor: never post drops more common than 1 in… est la règle stricte. Les membres ne peuvent pas aller au-delà dans les canaux de votre clan. Leurs propres webhooks, si.

Plus d’informations côté joueur
Les valeurs, modèles et webhooks personnels des joueurs se trouvent dans Settings, page by page.
Étape 10

Plus de webhooks pour les canaux chargés

#

Un webhook ne peut envoyer qu’à une certaine vitesse. Pour un événement chargé, ajoutez d’autres webhooks au même canal. Appuyez sur Busy channel? Let the bot add … more webhooks (il faut Manage Webhooks) ou collez plusieurs liens de webhook dans la zone du canal. Anvil en suggère davantage dès que vous avez 50 joueurs ou plus, beaucoup de posts par minute, ou si Discord a récemment dit « slow down ». Jusqu’à 10, c’est largement suffisant.

Anvil alterne entre eux. Si Discord dit « slow down » à l’un, ce webhook se repose un moment et le suivant prend le post. Si l’un est supprimé ou ne fonctionne plus, il est ignoré pendant 10 minutes. Les posts continuent tant qu’au moins un webhook fonctionne.

Ils doivent tous pointer vers le même canal. Anvil vous prévient s’ils ne le font pas. Utilisez Test pour en vérifier un, ou Stop posting here pour le retirer.

Même canal, mêmes posts
Davantage de webhooks ne publient jamais deux fois. Ils se partagent simplement le travail. La même idée apparaît dans Seuils de drop plus haut, et côté admin dans Running the event.
Étape 11

Publier sur Discord

#

Les admins peuvent publier en tant que bot depuis Post to Discord, sous Clan dans le menu d’administration. Choisissez un Channel, écrivez le Message et appuyez sur Send message. Un long texte, comme un règlement, est découpé tout seul en plusieurs messages.

Send as an embed est activé par défaut et ajoute un Title facultatif et une Accent colour ; désactivez-le pour du texte brut. Ping choisit un rôle, ou @everyone, à mentionner, et Anvil demande confirmation avant d’envoyer.

Chaque publication envoyée est listée sous Sent from here. Edit la modifie dans Discord sans mentionner à nouveau, et Delete la supprime.

Admins seulement, avec le bot
Il publie en tant que bot d’Anvil, connectez donc d’abord votre serveur. Les modérateurs ne le voient pas. C’est l’interrupteur Post to Discord sous Clan settings → Features ; désactivé, il disparaît du menu.
Étape 12

Quand ça devient silencieux

#

Dans l’ordre, parce que chaque point élimine le suivant :

Le bot est-il réellement sur le serveur ?Connection sur la page Discord le dit directement. « Token valide » et « sur votre serveur » sont deux faits différents et le premier n’implique pas le second — avec un bot partagé, le token est toujours valide.
L’identifiant du serveur est-il le bon ?Un identifiant faux mais réel ressemble exactement à un bon, jusqu’à ce que vous remarquiez que les messages partent ailleurs.
Le webhook existe-t-il encore ?Supprimer un salon Discord supprime son webhook, et Anvil garde l’URL morte. Choisissez-lui à nouveau un salon sous What goes where.
Le rôle du bot est-il assez haut ?Uniquement pour la synchronisation des rôles et des pseudos — voir plus haut. C’est celui qui échoue en silence.
Il ne peut pas accueillir les arrivants
Discord ne signale les arrivées que via une connexion gateway, qu’un bot partagé ne maintient pas pour chaque serveur. Il n’y a donc pas de message de bienvenue — mettez plutôt le lien d’inscription dans un salon #roles ou #commencer-ici, là où les gens regardent de toute façon.

Tout ceci se trouve dans Admin → Discord : la configuration rapide en haut, puis More settings — Connection, What goes where, Event posts, Roles & nicknames, Team channels, Commands et Post without a bot.

Bloqué, ou quelque chose cloche ? Demande sur le Discord de support Anvil