Aller au contenu

Bandeau

Le bandeau remplace la barre d’action classique par des cartouches dessinés au-dessus de la hotbar. Il sert à afficher les messages éphémères — ceux qui n’ont pas besoin de rester dans le chat — sans jamais que deux textes se chevauchent.

Éléments fixes — à gauche

Des informations qui se mettent à jour en continu : gain d’XP de métier, compteur de la zone AFK. Chaque élément a un identifiant et reste affiché tant qu’il est rafraîchi, puis disparaît après la durée configurée.

Notifications — à droite

Les messages ponctuels (effet activé, mention, achat…) passent un par un dans une file d’attente. Chacun reste affiché la durée configurée ; si 3 messages ou plus attendent, la durée est raccourcie à 2 secondes pour rattraper le retard.

Chaque cartouche a un fond, un trait d’accent coloré selon le type du message, et une largeur calculée au pixel près (le texte trop long est coupé avec « … »). Si la ligne est pleine, les éléments fixes les plus anciens laissent la place aux plus récents.

config.yml
bandeau:
duree: 5 # secondes d'affichage d'une notification / d'un élément fixe
couleurs: # couleur du trait d'accent par type
succes: "#6CF08A"
info: "#6FE2E8"
avert: "#FFD84A"
refus: "#FF5A5A"
xp: "#6CF08A"
afk: "#F7C43A"
vote: "#F7C43A"
xp: "<white><icone><metier></white> <#6CF08A>+<gain> XP <gray>(<white><xp></white><dark_gray>/</dark_gray><white><max></white><gray>)"
messages: # clés de messages envoyées dans le bandeau au lieu du chat
- "active"
- "retire"
- "mention"
textes: # version courte (facultative) de ces messages pour le bandeau
active: "<white></white> <gray><white><nom></white> brille sur ton pseudo"
mention: "<white></white> <gray><white><joueur></white> t'a mentionné"
icones_metiers: # glyphe affiché devant le nom du métier (police Nexo)
Mineur: "ꑉ"
Pêcheur: "ꑍ"
  1. Ajoutez la clé du message (voir Messages) dans bandeau.messages.
  2. Facultatif : donnez-lui une version courte dans bandeau.textes (mêmes balises que le message d’origine). Sans version courte, le message complet est utilisé.
  3. /effets reload.

Le type (donc la couleur d’accent) est déduit du premier caractère du message : glyphe → refus, → avert, → succes, tout le reste → info.

Les messages envoyés à la console ou à un joueur dont la clé n’est pas listée continuent d’aller dans le chat.

Avec Jobs Reborn, chaque gain d’XP affiche un élément fixe par métier, construit avec le modèle bandeau.xp :

Balise Valeur
<icone> Glyphe de icones_metiers pour ce métier (suivi d’une espace), ou rien
<metier> Nom affiché du métier
<gain> XP gagnée, cumulée tant que l’élément reste affiché
<xp> / <max> XP actuelle / XP du niveau suivant

Les clés de icones_metiers sont les noms affichés des métiers (par exemple Mineur), sans codes couleur.

/bandeau <joueur|*> <id> <type|#couleur> <message>
Argument Description
<joueur|*> Un joueur en ligne, ou * pour tous les joueurs
<id> Identifiant libre de la notification (pour la retrouver dans la file)
<type|#couleur> Un type de bandeau.couleurs (succes, info, avert, refus, vote, xp, afk) ou une couleur #RRGGBB
<message> Texte MiniMessage ; <joueur> est remplacé par le pseudo du destinataire
Exemples
/bandeau * annonce info <white>Événement <gold>chasse au trésor</gold> dans 5 minutes !
/bandeau Steve vote vote <gray>Merci pour ton vote, <white><joueur></white> !

Permission : cobaltia.bandeau.admin. La commande est pensée pour être appelée par d’autres plugins (votes, quêtes, box) afin que tous les messages éphémères du serveur passent par la même file.