Préfixes de grade LuckPerms avec badges en image (ItemsAdder)

Comment fonctionnent les préfixes en image

Le chat de Minecraft ne peut afficher que du texte. Un resource pack peut ajouter de nouveaux caractères à une police, et ItemsAdder transforme n’importe quel PNG en un tel caractère, appelé font image. Une fois le pack chargé, le badge n’est qu’un caractère de plus dans la ligne.

Trois plugins se partagent le travail :

• ItemsAdder génère le resource pack et remplace %img_<name>% (PlaceholderAPI) ou son propre tag :<name>: par le caractère du badge.
• LuckPerms enregistre quel groupe porte quel préfixe et décide selon la priorité quand un joueur en a plusieurs.
• Tes plugins de chat et de tab lisent le préfixe LuckPerms, via Vault ou le placeholder PlaceholderAPI %luckperms_prefix%, et l’affichent. LuckPerms lui-même ne formate pas le chat.

Étape 1 : crée les images des badges

Conçois tes grades dans le générateur de préfixes de grade. Chaque badge fait 8 pixels de haut par défaut, comme le demande le wiki ItemsAdder, et il est aussi large que son texte. Mets les grades dans l’ordre : le haut de la liste reçoit la priorité LuckPerms la plus élevée. Définis un namespace (le nom du dossier, ranks par défaut) et clique sur Tout télécharger en ZIP.

Le ZIP contient un PNG par grade, un ranks.yml et un README avec toutes les commandes :

ranks/
  configs/ranks.yml
  textures/admin.png
  textures/vip.png
README.txt

Étape 2 : ajoute les font images à ItemsAdder

Copie le dossier ranks dans plugins/ItemsAdder/contents/. La config déclare chaque badge comme font image :

info:
  namespace: ranks
font_images:
  admin:
    permission: "ranks.admin"
    show_in_gui: true
    suggest_in_command: false
    path: "admin.png"
    scale_ratio: 8
    y_position: 7
  vip:
    permission: "ranks.vip"
    show_in_gui: true
    suggest_in_command: false
    path: "vip.png"
    scale_ratio: 8
    y_position: 7

• scale_ratio: 8 correspond à l’image de 8 pixels, donc un pixel de l’image vaut un pixel de police, et y_position: 7 place le badge sur la ligne de texte. Si tu choisis une autre hauteur, le générateur adapte les deux valeurs. ItemsAdder exige que y_position soit inférieur ou égal à scale_ratio.
• La ligne permission décide seulement qui peut taper le badge comme emoji dans le chat. Qui le porte devant son pseudo, c’est LuckPerms qui le décide.
• path pointe vers le PNG dans le dossier textures du namespace.

Lance /iazip dans la console et attends que le resource pack soit régénéré. Les joueurs ne voient les badges qu’une fois le nouveau pack chargé.

Étape 3 : définis le préfixe avec LuckPerms

Crée les groupes s’ils n’existent pas encore, puis définis le préfixe de chaque groupe. Le générateur écrit ces lignes pour tous les grades d’un coup :

lp creategroup admin
lp creategroup vip
lp group admin meta setprefix 20 "%img_admin% "
lp group vip meta setprefix 10 "%img_vip% "
lp user Steve parent add vip

• Le nombre est la priorité. Si un joueur est dans plusieurs groupes, LuckPerms affiche le préfixe qui a la priorité la plus élevée. Le générateur donne le nombre le plus élevé au grade le plus haut, par pas de dix.
• setprefix remplace les préfixes existants de ce groupe dans le même contexte. addprefix en ajouterait un autre à côté.
• Les guillemets sont nécessaires car le préfixe se termine par un espace, qui sépare le badge du pseudo.
• Supprime un préfixe avec lp group vip meta removeprefix 10.

Tu veux plusieurs badges à la suite, par exemple un badge de grade et un badge de donateur ? LuckPerms peut empiler les préfixes avec la section meta-formatting de son config.yml (format, duplicates, start-spacer, middle-spacer, end-spacer).

Étape 4 : affiche le badge dans le chat et le tab

Le préfixe contient maintenant %img_admin%. Quelque chose doit remplacer ce placeholder par le badge. Le plugin de chat ou de tab doit afficher le préfixe LuckPerms et interpréter les placeholders PlaceholderAPI qu’il contient.

1. Installe PlaceholderAPI et l’extension LuckPerms : /papi ecloud download LuckPerms, puis /papi reload.
2. Utilise %luckperms_prefix% dans ton format de chat, ou laisse le plugin de chat lire le préfixe via Vault.
3. Pour la liste tab, le wiki d’ItemsAdder montre le plugin TAB avec le placeholder d’image directement dans le préfixe du groupe, puis /tab reload :

  Admin:
    tabprefix: '%img_admin%  '
    tagprefix: '%img_admin%  '

Le tag :admin: propre à ItemsAdder fonctionne là où ItemsAdder remplace lui-même le texte. Les plugins qui ne comprennent que PlaceholderAPI ont besoin de %img_admin% à la place, c’est pourquoi le générateur utilise la forme placeholder.

Préfixes texte sans resource pack

Si tu ne veux pas de resource pack, des préfixes en texte coloré fonctionnent aussi. Le générateur les écrit également avec des couleurs hex &# et du gras :

lp group vip meta setprefix 10 "&#0599AD&lVIP &r"

Les couleurs hex nécessitent Minecraft 1.16 ou plus récent et un plugin de chat qui comprend &#RRGGBB. Pour les plugins de chat qui lisent MiniMessage, copie plutôt les lignes MiniMessage avec <gradient>. Tu trouveras plus d’infos sur les formats de couleur dans le guide des couleurs du MOTD, hex et dégradés.

Erreurs fréquentes et solutions

La même technique de font image permet aussi de dessiner des fonds de menu entiers, vois les fonds de GUI personnalisés dans DeluxeMenus avec ItemsAdder. Et si tes grades viennent avec des avantages de vote, le guide des récompenses de vote avec VotingPlugin montre comment les distribuer.