DiscordSRV: relier Discord à son serveur Minecraft

Avec le plugin DiscordSRV, liez votre serveur Discord à votre serveur Minecraft. Donnez aux joueurs la possibilité de chatter dans le jeu avec les membres de votre serveur Discord et vice-versa. Très utile pour discuter avec vos joueurs in-game sans avoir à lancer le jeu tout en permettant à votre communauté de s'animer.

Par encore convaincu ? Sachez que ce plugin est traduit en français, qu'il est gratuit et open-source ! Que demander de plus ;)

Pré-requis

Bukkit, Spigot ou Paper.

Installation de DiscordSRV

C'est parti pour l'installation de DiscordSRV.

Comme d'habitude, il suffit d'ajouter le fichier jar du plugin sur votre serveur.

Si vous avez un serveur hébergé chez mTxServ, vous pouvez utiliser le panel de gestion :

Rendez-vous dans le panel de gestion du serveur.
Cliquez sur Minecraft puis Plugins Bukkit.
Cherchez DiscordSRV et sélectionnez le.
Choisissez une build qui correspond à votre version de Minecraft et cliquez sur Installer.
Pour démarrer l'installation, cliquez sur Installer Build.
Redémarrez votre serveur.

Voila, le plugin DiscordSRV est installé, il faut maintenant le configurer.

Configuration de Discord

Le plugin DiscordSRV est installé, nous allons créer une application sur Discord nécessaire pour le fonctionnement du bot.

Une fois l'application créée, nous modifierons la configuration du plugin pour utiliser les identifiants Discord de notre application fraîchement créée.

Rendez-vous sur le site Discord Developers.
Cliquez sur Créer une application.
Choisissez un nom cool pour votre bot, ignorez les autres champs et enregistrez :
Dans l'onglet Bot, cliquez sur Add Bot :
Confirmez l'ajout du bot en cliquant sur Yes, do it! :
Facultatif: vous pouvez changer l'avatar du bot si vous le souhaitez.

Notre application Discord est prête. Il ne reste qu'à finaliser la configuration du plugin.

Configuration du plugin

Le plugin est installé sur le serveur et notre application Discord est créée. On passe à la configuration du plugin sur votre serveur Minecraft.

Au redémarrage de votre serveur, un fichier de configuration a été créé par le plugin dans le répertoire plugins/DiscordSRV.

Éditez le fichier plugins/DiscordSRV/config.yml de votre serveur Minecraft.
Copiez le Token du bot depuis la page de l'application :
Collez le token dans la section BotToken du fichier de configuration.
Dans notre exemple :
```
BotToken: "MjE5NTE5OTk0MDUxMDM1MTQ3.CqTCYw.SFAbKtfK3ydTy1jx2-fTHUJqsPo"
```
Copiez le Client ID depuis l'onglet General Information de l'application :
Accédez à l'URL suivante (https://scarsz.me/authorize) et collez-le Client ID sur la page avec Ctrl + v.
Astuce: la page charge un petit script en cours d'exécution côté client qui vérifie la longueur d'un ID client valide et redirige vers discordapp.com pour obtenir l'autorisation OAuth2 de votre bot.
Vous pouvez également ajouter manuellement l'ID client à la fin du lien suivant et l'ouvrir:
https://discordapp.com/oauth2/authorize?scope=bot&client_id=
Sélectionnez votre guilde, puis cliquez sur Authorize.
Discord ouvert, accédez aux paramètres en cliquant sur le rouage situé en bas à gauche de Discord.
Allez dans l'onglet Appearance et activez Developer Mode :
Cliquez avec le bouton droit sur le canal Discord que vous souhaitez utiliser pour discuter entre Discord et Minecraft et cliquez sur Copy ID :
Dans le fichier de configuration config.yml du plugin, recherchez l'option Channelset remplacez 000000000000000000 par l'ID de chaîne copiée.
Dans notre exemple :
```
Channels: {"global": "219559668236681216"}
```
Si vous utilisez un plugin de chat avec support de canaux comme HeroChat, LegendChat, LunaChat, TownyChat ou VentureChat, vous pouvez configurer plus de canaux ici avec leurs canaux Discord liés.
Par exemple, si vous souhaitez ajouter un canal administrateur, il devrait ressembler à ceci (gardez à l'esprit que "channelname" signifie des canaux ingame, pas des canaux Discord) :
```
Channels: {"global": "219559668236681216", "admin": "221419146028646401"}
```
Facultatif: copiez l’ID de canal d’un deuxième canal Discord pour l’utiliser comme canal de console et collez-le dans config.yml.
```
DiscordConsoleChannelId: "219559838890459137"
```
Ouvrez les paramètres du serveur Discord en cliquant sur les 3 lignes parallèles à droite du nom du serveur dans le coin supérieur gauche de Discord et choisissez Server Settings :
Accédez à l'onget Roles et créez un nouveau rôle Bot. Ajoutez l'autorisation Administrator au nouveau rôle.
Assurez-vous que le nouveau rôle Bot figure en haut de la liste, sinon la fonctionnalité de synchronisation des rôles ne fonctionnera probablement pas! :
Pour les utilisateurs expérimentés, il est également possible de configurer des droits limités à des canaux individuels. Le bot a besoin de ces autorisations :
Manage Roles - pour la synchronisation des rôles et l'ajout de rôles aux joueurs liés
Manage Channels - pour le programme de mise à jour de la rubrique de canal
Ban Members - pour la synchronisation des interdictions
Manage Nicknames - pour la synchronisation des noms
Manage Webhooks - pour l'utilisation expérimentale de Webhook
Read Text Channels & See Voice Channels - pour la discussion de Discord à Minecraft
Send Messages - pour la discussion de Minecraft à Discord, console -canal et certaines commandes-sorties
Manage Messages- pour les fonctionnalités de suppression de message
Embed Links - facultatif pour l'intégration de liens postés dans le jeu
Mention Everyone - à mentionner si activé dans config.yml
Redémarrez votre serveur Minecraft.
Basculez vers l'onglet Members et ajoutez le nouveau rôle Bot à votre bot en cliquant sur +son nom et en choisissant le rôle :