Documentation
CommunautéComplète

Discord

Connectez votre serveur Discord pour lier les comptes, synchroniser les rôles avec les grades, relier le chat, publier les journaux du staff et proposer des commandes slash.

Le module Discord relie votre serveur ou votre réseau Minecraft à votre serveur Discord grâce à votre propre bot. Les joueurs lient leurs comptes, reçoivent des rôles Discord selon leurs grades et discutent entre le jeu et Discord. Votre staff reçoit les journaux des sanctions, des emprisonnements, des signalements et des tickets dans les salons de votre choix.

Remarque

Ce module nécessite l'édition complète. Voir éditions.

Fonctionnalités

  • Liaison des comptes. Un joueur tape /discord link en jeu et reçoit un code. Il l'envoie sur Discord avec la commande slash /link, ou en message privé au bot. Chaque compte Minecraft se lie à un seul compte Discord, et inversement.
  • Récompense de liaison. Donnez de l'argent et exécutez des commandes console la première fois qu'un joueur lie son compte. La récompense n'est donnée qu'une fois par compte Minecraft et une fois par compte Discord, via la boîte aux lettres.
  • Rôles selon les grades. Les joueurs liés reçoivent les rôles Discord qui correspondent à leurs grades. Les rôles sont mis à jour à leur connexion et quand leur grade change.
  • Pseudos Discord. Si vous le souhaitez, renommez les membres liés avec leur pseudo Minecraft ou leur surnom en jeu.
  • Pont du chat. Un salon Discord et le chat du jeu se reflètent l'un l'autre. Les arrivées, les départs, les morts, les progrès ainsi que le démarrage et l'arrêt des serveurs peuvent aussi être publiés. Les joueurs invisibles ne sont jamais annoncés.
  • Journaux du staff. Les sanctions, les emprisonnements, les signalements et les tickets sont publiés chacun dans leur propre salon. Le staff qui a un compte lié peut prendre en charge ou fermer un signalement avec des boutons, directement depuis Discord.
  • Message d'état. Un message dans le salon de votre choix affiche les joueurs connectés, le TPS et la durée de fonctionnement de chaque serveur, mis à jour chaque minute.
  • Commandes slash sur Discord :
    • /link <code> : lie le compte Discord à un compte Minecraft.
    • /online : liste les joueurs connectés sur chaque serveur.
    • /player <name> : affiche le profil d'un joueur.
    • /leaderboard <board> : affiche le top 10 d'un classement. Disponible uniquement quand le module classements contient des classements.
  • Un seul bot pour tout le réseau. Un seul serveur fait tourner le bot. Les autres serveurs lui envoient leurs événements, si bien que le pont du chat et les journaux couvrent tous les serveurs.

Mise en place

1. Créer le bot

Vous ne le faites qu'une fois, cela prend environ cinq minutes. Le panneau Connexion de la page Discord dans l'éditeur web reprend les mêmes étapes.

  1. Ouvrez le portail des développeurs Discord et créez une nouvelle application. Donnez-lui le nom que vous voulez pour votre bot.
  2. Allez sur la page Bot de l'application, cliquez sur Reset Token et copiez le jeton.
  3. Sur cette même page Bot, sous Privileged Gateway Intents, activez Message Content Intent et enregistrez. Le bot en a besoin pour lire le salon du pont du chat et les codes envoyés en message privé. Les autres intents privilégiés ne sont pas nécessaires.
  4. Dans l'éditeur web, ouvrez Discord, collez le jeton dans Jeton du bot et enregistrez.
  5. Cliquez sur Inviter le bot et ajoutez-le à votre serveur Discord. Le lien d'invitation apparaît une fois le jeton enregistré et demande déjà les permissions dont le bot a besoin : Voir les salons, Envoyer des messages, Intégrer des liens, Voir les anciens messages, Gérer les rôles et Gérer les pseudos.
Attention

Gardez votre jeton secret. Une fois enregistré, il n'est plus jamais affiché dans l'éditeur web. S'il fuite, réinitialisez-le sur la page Bot du portail et collez le nouveau.

Le panneau Connexion montre l'état du bot : Bot en ligne quand tout fonctionne. S'il affiche Intent manquant, activez Message Content Intent et enregistrez à nouveau le jeton. S'il affiche Bot pas invité, utilisez le bouton d'invitation. S'il affiche Bibliothèque manquante, le serveur du bot n'a pas pu télécharger ce dont il a besoin pour communiquer avec Discord : vérifiez son accès à Internet et redémarrez-le.

2. Choisir le serveur du bot et le serveur Discord

Réglage Rôle
Serveur du bot Sur un réseau, seul ce serveur fait tourner le bot. Les autres serveurs lui envoient leurs événements. Un serveur seul fait toujours tourner le bot lui-même.
Serveur Discord Si le bot est présent sur plusieurs serveurs Discord, choisissez celui à utiliser. Par défaut, le premier.
Activité du bot Texte affiché sous le nom du bot, par exemple {online} players. Vide : aucun.

Les salons et les rôles apparaissent dans les listes ci-dessous une fois le bot en ligne sur votre serveur Discord. Un avertissement s'affiche à côté de tout salon où le bot ne peut pas écrire.

3. Pont du chat

Réglage Rôle Par défaut
Salon du chat Ce salon et le chat du jeu se reflètent l'un l'autre. Aucun
Chat du jeu vers Discord Envoie les messages du jeu dans le salon. Activé
Discord vers le chat du jeu Affiche les messages du salon en jeu. Activé
Membres liés seulement Seuls les membres qui ont un compte lié peuvent parler en jeu depuis Discord. Désactivé
Arrivées et départs Publie les arrivées et les départs des joueurs. Activé
Morts Publie les messages de mort. Activé
Progrès Publie les progrès. Activé
Démarrage et arrêt du serveur Publie le démarrage ou l'arrêt d'un serveur. Activé
Longueur maximale des messages Les messages plus longs sont coupés, dans les deux sens. 256

Les mentions et la mise en forme écrites en jeu ne sont jamais appliquées sur Discord. Les joueurs mutés ne peuvent jamais parler en jeu depuis Discord.

Formats des messages vous permet de changer l'apparence de chaque message relayé : les messages Discord en jeu (avec les couleurs Minecraft), et sur Discord les messages du jeu, les arrivées, les départs, les morts, les progrès, le démarrage et l'arrêt du serveur (avec **bold** et *italic*). Chaque langue a ses propres textes.

4. Journaux du staff

Chaque journal va dans son propre salon. Laissez un salon vide et le journal correspondant n'est pas publié.

Réglage Ce qu'il publie
Salon des sanctions Bans, mutes, expulsions et avertissements, donnés et levés.
Salon de la prison Joueurs envoyés en prison et libérés.
Salon des signalements Signalements nouveaux, pris en charge et fermés.
Salon des tickets Tickets nouveaux, fermés et notés.
Réponses aux tickets Publie aussi chaque réponse écrite dans un ticket. Désactivé par défaut.
Boutons des signalements Le staff qui a un compte lié peut prendre en charge ou fermer un signalement depuis Discord. Activé par défaut.
Image de la tête du joueur Adresse de la tête affichée dans les journaux. {uuid} et {name} sont remplacés. Vide : aucune.

Les boutons des signalements ne fonctionnent que pour les membres liés qui ont la permission inglis.reports.notify en jeu.

5. État

Choisissez un Salon d'état et le bot y garde un message, mis à jour chaque minute, avec les joueurs connectés, le TPS et la durée de fonctionnement de chaque serveur.

6. Rôles

Seuls les joueurs liés reçoivent des rôles.

Réglage Rôle Par défaut
Donner les rôles selon les grades Les joueurs liés reçoivent les rôles Discord de leurs grades. Activé
Grades utilisés Tous les grades (y compris les grades hérités) ou seulement le Grade le plus haut. Tous les grades
Retirer les autres rôles Un rôle du tableau est retiré quand le joueur n'a plus le grade correspondant. Activé
Pseudo Discord Inchangé, Pseudo Minecraft ou Surnom. Inchangé
Rôles par grade Tableau qui associe chaque grade à un rôle Discord. Utilisez Ajouter un rôle pour ajouter une ligne. Vide
Attention

Discord ne permet au bot de donner que des rôles situés sous son propre rôle. Les rôles trop hauts sont marqués « au dessus du bot » dans la liste. Montez le rôle du bot plus haut dans les paramètres de votre serveur Discord. Il en va de même pour les pseudos.

7. Liaison des comptes

Réglage Rôle Par défaut
Durée du code (minutes) Temps dont dispose un joueur pour envoyer le code donné par /discord link. 10
Liaison par message privé Les joueurs peuvent aussi envoyer leur code au bot en message privé. Activé
Argent offert Donné une fois par compte lors de la première liaison. 0 : aucun. 0
Devise de la récompense Identifiant de la devise. Vide : la devise principale. Devise principale
Commandes de récompense Commandes console exécutées une seule fois lors de la première liaison. {player} est le pseudo du joueur. Vide

La page Comptes liés liste tous les joueurs liés avec leur compte Discord et la date de liaison. Vous pouvez y faire une recherche et délier un joueur. Délier retire les rôles synchronisés, et la récompense de première liaison n'est pas redonnée.

Commandes

Commande Rôle Permission
/discord Indique si votre compte est lié, et à quel compte Discord. inglis.discord.discord (tout le monde)
/discord link Vous donne un code pour lier votre compte sur Discord. inglis.discord.discord
/discord unlink Délie votre compte. inglis.discord.discord

L'alias, la permission, le délai, le prix, les mondes et les règles par grade de /discord se modifient dans l'éditeur web, voir commandes.

Conseils

  • Après trop de codes erronés, un compte Discord doit attendre un quart d'heure avant de réessayer. Cela empêche de deviner les codes.
  • Si les commandes slash n'apparaissent pas sur Discord, invitez à nouveau le bot avec le bouton de l'éditeur web.
  • Sur un réseau, choisissez comme serveur du bot un serveur qui tourne en permanence, comme votre lobby.