Aller au contenu principal

Système de Priorité d'Annonce

Le Système de Priorité d'Annonce gère l'importance des messages d'EliteMobs. Pour le moment, il est uniquement utilisé pour gérer les messages envoyés par les apparitions de Boss Personnalisés (Custom Boss).

Aide-mémoire abrégé :

  • Niveau 0 : Silencieux (par défaut pour les boss sans message configuré) - Seuls ceux qui infligent des dégâts voient les messages de mort
  • Niveau 1 : Messages dans le chat + Suivi (si messages/locationMessage configurés)
  • Niveau 2 : Identique au Niveau 1 pour les Boss Personnalisés (aucun comportement distinct)
  • Niveau 3 : Fonctionnalités du Niveau 1 + Annonces Discord (nécessite DiscordSRV)

Comment ça marche :

Note : Vous devez configurer votre Boss Personnalisé avec ce système de priorité si vous souhaitez utiliser une valeur autre que celle par défaut. Cliquez ici pour apprendre comment faire.

Niveau 0

Force le Boss Personnalisé à rester silencieux. Cela signifie :

  • Aucun message d'apparition ne sera envoyé
  • Aucun message d'évasion ne sera envoyé
  • Les messages de mort sont envoyés UNIQUEMENT aux joueurs qui ont infligé des dégâts au boss (pas à l'échelle du serveur)
  • Le suivi du boss est désactivé même si locationMessage est configuré

Niveau 1

Si vous ne définissez pas du tout announcementPriority, la valeur par défaut dépend du contenu du boss : un boss qui a un message d'apparition/de mort/d'évasion configuré aura par défaut la priorité 1, tandis qu'un boss sans contenu d'annonce aura par défaut la priorité 0 (silencieux). Pour forcer un boss à rester silencieux même s'il possède des messages, définissez explicitement announcementPriority: 0.

Le Boss Personnalisé pourra envoyer des messages dans le chat s'il est configuré pour le faire. Il enverra des messages d'apparition, de mort et d'évasion s'il est configuré pour les avoir.

Par défaut, les messages d'apparition sont diffusés à tous les joueurs du serveur. Vous pouvez configurer EliteMobs pour ne diffuser qu'aux joueurs présents dans le même monde que le boss en activant le paramètre 'Only broadcast event message in event worlds' dans events.yml (announcementBroadcastWorldOnly: true).

Le suivi du boss est également activé à ce niveau si un locationMessage est configuré. Les joueurs peuvent cliquer dans le chat pour le suivre lorsqu'il apparaît, ou utiliser le menu /em pour le suivre.

Conditions requises pour le Suivi

Pour que le suivi du boss fonctionne en Priorité 1 ou 2, les éléments suivants doivent être configurés :

  • Définir announcementPriority à 1 ou plus
  • Ajouter un champ locationMessage à la configuration de votre boss personnalisé
  • S'assurer que la config du serveur a showCustomBossLocation activé (par défaut : true)

Le locationMessage peut inclure des placeholders :

  • $distance - Affiche la distance jusqu'au boss
  • $location - Affiche les coordonnées du boss

Niveau 2

Pour les Boss Personnalisés, le Niveau 2 se comporte de manière identique au Niveau 1 — il n'existe pas de chemin de code distinct pour la priorité 2. Chaque type de message suit les mêmes règles en priorité 1 et en priorité 2 :

  • Les messages d'apparition sont diffusés à l'échelle du serveur, sauf si announcementBroadcastWorldOnly: true est défini, auquel cas ils ne sont envoyés qu'aux joueurs présents dans le monde du boss.
  • Les messages de mort sont diffusés à l'échelle du serveur pour toute priorité de 1 ou plus.
  • Les messages d'évasion sont toujours envoyés uniquement aux joueurs présents dans le monde du boss pour toute priorité de 1 ou plus.

Le suivi du boss est également activé à ce niveau si un locationMessage est configuré.

Note : Le suivi nécessite à la fois une priorité d'annonce de 1 ou plus ET un champ locationMessage configuré.

Niveau 3

Le Boss Personnalisé aura le même comportement qu'au Niveau 1, et enverra également des messages dans le salon Discord configuré pour recevoir les notifications d'EliteMobs. La page expliquant comment configurer cette fonctionnalité se trouve ici. Les messages sur Discord seront identiques aux messages du chat - apparition/mort/évasion

Types de Messages

Les boss personnalisés peuvent avoir trois types d'annonces :

  • Messages d'apparition (spawnMessage) - Envoyés lorsque le boss apparaît
  • Messages de mort (deathMessage) - Envoyés lorsque le boss est tué
  • Messages d'évasion (escapeMessage) - Envoyés lorsque le boss disparaît/s'échappe

Chaque type de message doit être configuré séparément dans votre fichier de boss. Le niveau de priorité d'annonce contrôle si ces messages sont envoyés et qui les reçoit.

Exemple de Configuration

# Boss silencieux - seuls ceux qui infligent des dégâts voient le message de mort
announcementPriority: 0
deathMessage: '&c$name has been defeated!'

# Annonces dans le chat avec suivi
announcementPriority: 1
spawnMessage: '&4$name &chas spawned!'
deathMessage: '&a$name &2has been slain by $damager1name!'
escapeMessage: '&e$name &6has escaped!'
locationMessage: '&6$name &eis $distance blocks away at $location'

# Intégration Discord
announcementPriority: 3
spawnMessage: '&4$name &chas spawned!'
locationMessage: '&6Track $name at $location'