Intégration DiscordSRV

EliteMobs utilise DiscordSRV pour permettre la diffusion des messages de priorité d'annonce de niveau 3 et supérieur. Vous pouvez en apprendre plus sur le système de priorité d'annonce ici.

Concrètement, cela signifie que certains Boss Personnalisés très spéciaux peuvent envoyer des messages sur Discord d'une manière qui ressemble à ceci :

L'intention est de créer un salon d'annonces dédié à EliteMobs que les joueurs peuvent consulter pour voir s'il y a des Boss de Monde intéressants actuellement en vie qu'ils peuvent aller tuer, et le montrer dans le classement des éliminations.

Tout mettre en place

Configurer DiscordSRV

DiscordSRV est un plugin différent qui n'est pas développé par moi. Vous pouvez trouver leur guide de configuration détaillé ici. Si vous avez du mal à le configurer, leur salon de support est ici. Je ne suis pas en mesure de fournir du support pour ce plugin, veuillez donc vous adresser à eux pour cette partie de l'installation.

Remarque : EliteMobs est testé avec la version 1.28.0 de DiscordSRV. Bien que d'autres versions puissent fonctionner, cette version est connue pour être compatible.

Configurer la configuration DiscordSRV d'EliteMobs

Une fois que vous avez correctement configuré DiscordSRV (et vous devez tester pour vérifier que cela fonctionne réellement avant de passer à cette étape), la configuration d'EliteMobs ne comporte qu'une seule étape.

Rendez-vous dans le fichier de configuration DiscordSRV.yml du dossier de configuration d'EliteMobs (généralement plugins/EliteMobs/DiscordSRV.yml) et vous y trouverez une option de configuration nommée announcementRoomName.

Il existe trois valeurs utilisables pour ce message. Je recommande la n°1.

1. [Recommandé] Le nom du salon tel que vous l'avez configuré dans le fichier de configuration de DiscordSRV. Peu importe comment vous avez appelé le salon, seul compte le fait d'utiliser le bon nom. Voici un exemple du salon que j'ai configuré pour être dédié aux événements EliteMobs : Dans mon cas, l'option devrait être announcementRoomName: EMEvents.

2. L'ID du salon tel que vous l'avez configuré dans le fichier de configuration de DiscordSRV. Voici un exemple du salon. Notez que chaque salon est unique. Je ne montre les images qu'à titre d'exemple, n'essayez pas de copier les numéros d'ID. Cela ne fonctionnera pas. Votre configuration doit avoir un ensemble de chiffres unique basé sur l'id de votre salon discord.

3. [Mauvais] Le nom de votre salon tel qu'il apparaît sur discord. Il n'est pas garanti que cela fonctionne correctement, pour diverses raisons. Gardez à l'esprit que votre salon discord doit être configuré dans les fichiers de configuration de DiscordSRV — ce n'est pas parce que vous pouvez indiquer le nom du salon dans ce fichier de configuration que vous pouvez sauter sa configuration dans DiscordSRV.

Notes techniques

• Les codes couleur Minecraft sont automatiquement retirés des messages envoyés vers Discord afin d'assurer un affichage correct
• Les messages Discord sont envoyés de façon asynchrone pour éviter les ralentissements du serveur
• EliteMobs utilise une recherche à trois niveaux pour trouver votre salon Discord : d'abord par ID de salon, puis par la correspondance de salons de DiscordSRV, et enfin par recherche du nom de salon
• Seul le contenu ayant une priorité d'annonce de 3 ou plus déclenchera des notifications Discord — cela couvre les messages d'apparition, de mort et de fuite des Boss Personnalisés ainsi que les startMessage / endMessage des Événements Personnalisés
• Les mêmes messages que ceux affichés en jeu sont envoyés vers Discord
• Le salon n'est résolu qu'une seule fois puis mis en cache pour le reste de la session du serveur : modifier announcementRoomName nécessite donc un redémarrage, et pas seulement un /em reload

Tests

Vous pouvez utiliser la commande /em discord <message> pour tester si votre configuration fonctionne. Remplacez <message> par le texte de votre choix à envoyer sur Discord.

Exemple : /em discord Test message from EliteMobs!

Si votre message apparaît dans le salon Discord configuré, c'est terminé !

Remarque : cette commande nécessite la permission elitemobs.discord.message

Vous pouvez également utiliser /em discord (sans message) pour afficher le lien d'invitation du serveur Discord d'EliteMobs, pour le support et les téléchargements. Cette commande nécessite la permission elitemobs.discord.link.

Dépannage

Les messages n'apparaissent pas sur Discord :

• Vérifiez que DiscordSRV est installé et fonctionnel (testez d'abord avec les propres commandes de DiscordSRV)
• Vérifiez que announcementRoomName n'est PAS laissé à sa valeur d'exemple par défaut
• Assurez-vous que le nom/ID du salon correspond exactement à ce qui figure dans votre configuration DiscordSRV
• Consultez la console pour d'éventuels avertissements d'EliteMobs concernant l'intégration Discord
• Vérifiez que vous disposez de la permission elitemobs.discord.message pour les tests

Erreurs de salon introuvable :

• Revérifiez l'orthographe du nom de votre salon dans DiscordSRV.yml et dans le DiscordSRV.yml d'EliteMobs
• Essayez d'utiliser l'ID numérique du salon plutôt que son nom
• Assurez-vous que le salon est correctement configuré dans le config.yml de DiscordSRV

La commande de test ne fonctionne pas :

• Vérifiez que vous disposez de la permission elitemobs.discord.message
• Utilisez la syntaxe correcte : /em discord <message> (avec un message)
• Consultez la console du serveur pour d'éventuels messages d'erreur