Effets de pseudo

Un effet de pseudo anime le nom du joueur partout où il est affiché via les placeholders du plugin : chat, tab, plaque au-dessus de la tête. Le joueur possède des effets, en choisit un seul actif, et peut le retirer à tout moment.

Les 15 effets fournis

Identifiant	Nom	Description
eclat	Éclat Cobalt	Une lame de lumière traverse le pseudo toutes les 2 secondes.
eclat_jumeau	Éclat Jumeau	Deux éclats de lumière filent sur le pseudo.
ressac	Ressac	La lumière va et vient sur le pseudo comme une vague.
poussiere	Poussière d’Étoile	Des étoiles scintillent au bout du pseudo.
aura	Aura Mystique	Un halo mystique enveloppe le pseudo.
houle	Houle	Les lettres ondulent doucement.
lucioles	Lucioles	Les lettres s’illuminent une à une.
souffle	Souffle Vital	Le pseudo respire doucement.
flottement	Flottement	Le pseudo flotte comme une bouée.
battement	Battement	Le pseudo bat comme un cœur toutes les 3 secondes.
reflet	Reflet	Une lueur douce glisse sur le pseudo toutes les 5 secondes.
prisme	Prisme	Un reflet arc-en-ciel traverse le pseudo toutes les 6 secondes.
ricochet	Ricochet	Un petit saut passe de lettre en lettre toutes les 4 secondes.
echo	Écho	Un écho du pseudo s’envole toutes les 5 secondes.
gonfle	Gonfle	Le pseudo gonfle légèrement toutes les 4 secondes.

Vous pouvez renommer, retirer ou ajouter des effets dans la section effets de config.yml.

Comment fonctionne l’animation

Côté plugin

Le plugin calcule, lettre par lettre, la couleur du pseudo : dégradé du grade sans effet, ou couleur déclencheur de l’effet pour ce grade quand un effet est actif.

Côté pack de ressources

Un shader de texte du pack de ressources reconnaît ces couleurs déclencheurs et joue l’animation correspondante, en restituant la couleur du grade.

Chaque déclencheur est une couleur très proche de celle du grade (par exemple #777778 pour un grade gris #777777) : à l’œil nu la différence est invisible, mais le shader sait quelle animation jouer et pour quel grade. Sans le shader dans le pack, le pseudo s’affiche simplement dans la couleur du grade.

Attention

Le shader n’est pas inclus dans le .jar : il fait partie du pack de ressources de votre serveur. Si vous ajoutez un effet ou un grade, les couleurs déclencheurs doivent correspondre à celles attendues par votre shader.

Grades

La section grades décrit les grades dans l’ordre de priorité : le joueur prend le premier grade de la liste dont il possède la permission. Placez donc les grades les plus élevés en premier.

config.yml

grades:
  admin:
    permission: cobaltia.nameplate.admin   # permission qui attribue ce grade
    gras: true                             # pseudo en gras (facultatif)
    couleurs:
      - "#FB0000"                          # une seule couleur : pseudo uni
  vip:
    permission: cobaltia.nameplate.vip
    couleurs:                              # plusieurs couleurs : dégradé sur les lettres
      - "#22ECAF"
      - "#14B871"
  joueur:
    permission: cobaltia.grade.joueur
    couleurs:
      - "#797777"
      - "#6F6D6D"

• permission est obligatoire : c’est elle qui rattache un joueur au grade (donnez-la via vos groupes LuckPerms).
• couleurs est obligatoire : une couleur pour un pseudo uni, plusieurs pour un dégradé réparti sur les lettres.
• gras (facultatif) met le pseudo en gras.
• Un joueur sans aucun grade correspondant garde son pseudo brut, sans couleur ni effet.

Définir un effet

config.yml

effets:
  eclat:                                   # identifiant : minuscules, chiffres et _ uniquement
    nom: "Éclat Cobalt"                    # nom affiché dans les menus et messages
    description: "Une lame de lumière traverse ton pseudo toutes les 2 secondes."
    icone: "LAPIS_LAZULI"                  # matériau Minecraft ou objet Nexo (nexo:<id>)
    declencheurs:                          # une couleur par grade + "badge"
      joueur: "#777778"
      vip: "#24ECAF"
      admin: "#F70000"
      badge: "#FBFFFF"

Une entrée par grade

Chaque effet doit définir un déclencheur pour chacun des grades de la section grades, plus la clé badge. Un oubli rend la configuration invalide et désactive le plugin, avec un message précis (effet eclat : declencheur manquant pour le grade vip).

Options avancées

Marqueurs

Certains effets animent spécifiquement la première et la dernière lettre (par exemple des étoiles au bout du pseudo). La section marqueurs définit une couleur dédiée pour ces lettres, par grade et pour badge :

    marqueurs:
      debut:
        joueur: "#797773"
        # … un par grade …
        badge: "#FFF7FF"
      fin:
        joueur: "#797378"
        badge: "#FFFFF7"

Le marqueur de début n’est appliqué au pseudo que si le préfixe du joueur ne contient pas de glyphe (badge) ; dans ce cas c’est le premier glyphe du préfixe qui le reçoit. Même logique pour la fin et le suffixe.

Positions

Pour les effets qui ont besoin de connaître la position de chaque lettre (par exemple un saut qui passe de lettre en lettre), la section positions donne, par grade, un pas de couleur ajouté au déclencheur selon la place de la lettre dans le pseudo :

    positions:
      joueur: "#000400"
      vip: "#040000"
      # … un par grade (badge non requis)

Le shader déduit alors la position de chaque lettre de l’écart avec le déclencheur.

Badges

Les glyphes (caractères du pack de ressources) présents dans le préfixe LuckPerms du joueur et dans ses titres affichés après le pseudo reçoivent la couleur badge de l’effet actif : vos badges de grade s’animent avec le pseudo.

Possession et choix

1. Posséder un effet = avoir la permission cobaltia.effet.<id> attribuée explicitement (au joueur ou à l’un de ses groupes). Les jokers comme cobaltia.effet.* ne donnent pas les effets, pour éviter qu’un grade staff les débloque tous par accident.

2. Donner un effet : /effets give <joueur> <effet|tous> ajoute la permission de façon permanente (même hors ligne). /effets remove <joueur> <effet|tous> la retire et efface le choix si l’effet retiré était actif.

3. Choisir : le joueur utilise /effets choisir <effet>, l’onglet « Effets de pseudo » de la garde-robe, ou le menu configuré dans menu.

4. Enregistrement : l’effet actif est stocké dans la méta LuckPerms effet_pseudo du joueur. Il suit donc le joueur sur tous les serveurs qui partagent la même base LuckPerms.

5. Rafraîchissement : après chaque changement, les commandes de apres_changement sont exécutées par la console (par exemple pour mettre à jour le tab d’un autre plugin).

config.yml

apres_changement:
  - "cmi tablistupdate"                 # {joueur} est remplacé par le pseudo
menu: "zmenu open effets {joueur} false" # commande console ouverte par /effets ; vide = liste texte

Afficher le pseudo animé

Utilisez les placeholders du plugin dans votre plugin de chat, de tab ou de plaques :

Besoin	Placeholder
Pseudo coloré/animé (codes §)	%cobaltiaeffets_pseudo%
Pseudo coloré/animé (MiniMessage)	%cobaltiaeffets_pseudo_mm%
Préfixe LuckPerms avec badges animés	%cobaltiaeffets_prefixe% / %cobaltiaeffets_prefixe_mm%
Titres affichés devant le pseudo	%cobaltiaeffets_titres% / %cobaltiaeffets_titres_mm%
Titres affichés après le pseudo	%cobaltiaeffets_suffixe% / %cobaltiaeffets_suffixe_mm%
Aperçu d’un effet sur le pseudo du joueur	%cobaltiaeffets_apercu_<effet>% / %cobaltiaeffets_apercu_<effet>_mm%
Effet actif (identifiant ou aucun, puis nom)	%cobaltiaeffets_effet% / %cobaltiaeffets_effet_nom%
Le joueur possède-t-il l’effet ?	%cobaltiaeffets_possede_<effet>% → oui / non

La liste complète est sur la page Placeholders.

Menu d’effets avec aperçu

Dans un menu (zMenu, DeluxeMenus…), combinez %cobaltiaeffets_apercu_<effet>_mm% pour montrer l’effet sur le pseudo du joueur, %cobaltiaeffets_possede_<effet>% pour afficher un cadenas, et /effets choisir <effet> comme action de clic.