Placeholders
Tous les placeholders utilisent l’identifiant cobaltiaeffets : %cobaltiaeffets_<paramètre>%. L’extension est intégrée au plugin (aucun /papi ecloud download nécessaire) et reste enregistrée après un /papi reload.
Référence
Section intitulée « Référence »22 résultats
%cobaltiaeffets_top_<classement>_<rang>_<nom|score>%Nom ou score du joueur classé au <rang> (1 à 10) du <classement> de la saison ; vide ou 0 si la place est libre.
%cobaltiaeffets_top_<classement>_hebdo_<rang>_<nom|score>%Nom ou score du joueur classé au <rang> (1 à 10) du <classement> de la semaine ; vide ou 0 si la place est libre.
%cobaltiaeffets_booster_<1-5>_<type|facteur|restant>%Type (jobs, minerais, drop, generateur, familiers), facteur ou temps restant du n-ième booster actif du joueur ; vide sans booster.
%cobaltiaeffets_pseudo%Pseudo du joueur coloré selon son grade et son effet actif, en codes couleur legacy (§).
%cobaltiaeffets_pseudo_mm%Pseudo du joueur coloré selon son grade et son effet actif, au format MiniMessage.
%cobaltiaeffets_plaque_fond%Ligne préfixe, titres, pseudo et suffixe du joueur recolorée d'une couleur repère, au format MiniMessage, pour dessiner le fond de la plaque de nom.
%cobaltiaeffets_prefixe%Préfixe de grade du joueur, avec l'animation de son effet actif, en codes couleur legacy (§).
%cobaltiaeffets_prefixe_mm%Préfixe de grade du joueur, avec l'animation de son effet actif, au format MiniMessage.
%cobaltiaeffets_monde%Nom affiché du groupe de mondes où se trouve le joueur (par exemple Survie), ou nom du monde à défaut.
%cobaltiaeffets_monde_joueurs%Nombre de joueurs en ligne dans le même groupe de mondes que le joueur.
%cobaltiaeffets_titres%Titres équipés affichés avant le pseudo du joueur, en codes couleur legacy (§).
%cobaltiaeffets_titres_mm%Titres équipés affichés avant le pseudo du joueur, au format MiniMessage.
%cobaltiaeffets_suffixe%Suffixe du joueur (titres placés après le pseudo), avec l'animation de son effet actif, en codes couleur legacy (§).
%cobaltiaeffets_suffixe_mm%Suffixe du joueur (titres placés après le pseudo), avec l'animation de son effet actif, au format MiniMessage.
%cobaltiaeffets_chat_infos%Bloc rangs de classement et clan affiché dans le chat, selon les choix /chatinfos du joueur ; rafraîchi toutes les 20 secondes.
%cobaltiaeffets_chat_infos_clan%État de l'affichage du clan dans le chat : affiche ou masque.
%cobaltiaeffets_chat_infos_classements%État de l'affichage des classements dans le chat : affiche ou masque.
%cobaltiaeffets_effet%Identifiant de l'effet de pseudo actif du joueur, ou aucun.
%cobaltiaeffets_effet_nom%Nom affiché de l'effet de pseudo actif du joueur ; vide si aucun.
%cobaltiaeffets_possede_<effet>%Indique si le joueur possède l'effet de pseudo <effet> : oui ou non.
%cobaltiaeffets_apercu_<effet>%Pseudo du joueur rendu avec l'effet <effet> et les couleurs de son grade, en codes legacy (§), pour un aperçu avant achat ou choix.
%cobaltiaeffets_apercu_<effet>_mm%Pseudo du joueur rendu avec l'effet <effet> et les couleurs de son grade, au format MiniMessage, pour un aperçu.
- Aucune entrée.
Deux formats : § et MiniMessage
Section intitulée « Deux formats : § et MiniMessage »La plupart des placeholders d’affichage existent en deux versions :
| Suffixe | Format | À utiliser dans |
|---|---|---|
| (aucun) | Codes couleur §x§R§R§G§G§B§B |
Plugins qui attendent du texte « legacy » (la plupart des plugins de tab, de chat ou de scoreboard) |
_mm |
Balises MiniMessage <#RRGGBB> |
Plugins compatibles MiniMessage |
Les deux versions produisent exactement les mêmes couleurs, donc les mêmes animations.
Placeholders à paramètre
Section intitulée « Placeholders à paramètre »| Placeholder | Valeur |
|---|---|
%cobaltiaeffets_apercu_<effet>% |
Pseudo du joueur rendu avec cet effet et les couleurs de son grade (même s’il ne le possède pas) |
%cobaltiaeffets_apercu_<effet>_mm% |
Idem, en MiniMessage |
%cobaltiaeffets_possede_<effet>% |
oui ou non |
Exemple : %cobaltiaeffets_apercu_prisme_mm%.
Ces placeholders lisent les classements du plugin « Cobaltia » et ne dépendent pas du joueur :
| Placeholder | Valeur |
|---|---|
%cobaltiaeffets_top_<catégorie>_<rang>_nom% |
Nom du joueur classé <rang> (1 à 10) sur la saison |
%cobaltiaeffets_top_<catégorie>_<rang>_score% |
Son score, avec séparateurs de milliers |
%cobaltiaeffets_top_<catégorie>_hebdo_<rang>_nom% |
Idem pour le classement de la semaine |
%cobaltiaeffets_top_<catégorie>_hebdo_<rang>_score% |
Idem |
Les classements sont chargés à la première demande puis rafraîchis toutes les minutes en arrière-plan : ils peuvent être affichés sur des hologrammes sans coût. Rang vide : nom vide et score 0.
Les boosters actifs du joueur (lus dans le plugin « Cobaltia »), numérotés de 1 à 5 dans l’ordre jobs, minerais, drop, générateur, familiers :
| Placeholder | Valeur |
|---|---|
%cobaltiaeffets_booster_<n>_type% |
Type du n-ième booster actif (jobs, minerais…) |
%cobaltiaeffets_booster_<n>_facteur% |
Multiplicateur (2…) |
%cobaltiaeffets_booster_<n>_restant% |
Temps restant (12:34 ou 1:02:03) |
Valeur vide s’il y a moins de n boosters actifs. Résultat mis en cache une seconde par joueur, idéal pour un HUD.
Exemples d’intégration
Section intitulée « Exemples d’intégration »%cobaltiaeffets_chat_infos%%cobaltiaeffets_prefixe%%cobaltiaeffets_titres%%cobaltiaeffets_pseudo%%cobaltiaeffets_suffixe% » {message}%cobaltiaeffets_prefixe%%cobaltiaeffets_pseudo%%cobaltiaeffets_suffixe%Monde : %cobaltiaeffets_monde% (%cobaltiaeffets_monde_joueurs% joueurs)