LuckPerms-Rang-Präfixe mit Bild-Abzeichen (ItemsAdder)

So funktionieren Bild-Präfixe

Der Minecraft-Chat kann nur Text anzeigen. Ein Ressourcenpaket kann einer Schrift aber neue Zeichen hinzufügen, und ItemsAdder macht aus jedem PNG so ein Zeichen, ein sogenanntes Font-Image. Sobald das Paket geladen ist, ist das Abzeichen einfach ein weiteres Zeichen in der Zeile.

Drei Plugins teilen sich die Arbeit:

• ItemsAdder baut das Ressourcenpaket und ersetzt %img_<name>% (PlaceholderAPI) oder seinen eigenen Tag :<name>: durch das Abzeichen-Zeichen.
• LuckPerms speichert, welche Gruppe welches Präfix trägt, und entscheidet über die Priorität, wenn ein Spieler mehrere hat.
• Deine Chat- und Tab-Plugins lesen das LuckPerms-Präfix über Vault oder den PlaceholderAPI-Platzhalter %luckperms_prefix% und zeigen es an. LuckPerms selbst formatiert den Chat nicht.

Schritt 1: Die Abzeichen gestalten

Gestalte deine Ränge im Rang-Präfix-Generator. Jedes Abzeichen ist standardmäßig 8 Pixel hoch, wie es das ItemsAdder-Wiki vorgibt, und so breit wie sein Text. Die Reihenfolge zählt: Der oberste Rang bekommt die höchste LuckPerms-Priorität. Leg einen Namespace fest (der Ordnername, standardmäßig ranks) und klick auf Alle als ZIP herunterladen.

In der ZIP liegen ein PNG pro Rang, eine ranks.yml und eine README mit allen Befehlen:

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

Schritt 2: Font-Images in ItemsAdder eintragen

Kopier den Ordner ranks nach plugins/ItemsAdder/contents/. Die Config meldet jedes Abzeichen als Font-Image an:

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 passt zum 8 Pixel hohen Bild, ein Bildpixel ist also ein Schriftpixel, und y_position: 7 setzt das Abzeichen auf die Textzeile. Wählst du eine andere Höhe, ändert der Generator beide Werte mit. ItemsAdder verlangt, dass y_position kleiner oder gleich scale_ratio ist.
• Die Zeile permission entscheidet nur, wer das Abzeichen als Chat-Emoji tippen darf. Wer es vor dem Namen trägt, legt LuckPerms fest.
• path zeigt auf das PNG im Ordner textures des Namespaces.

Führ in der Konsole /iazip aus und warte, bis das Ressourcenpaket neu gebaut ist. Spieler sehen die Abzeichen erst, wenn sie das neue Paket geladen haben.

Schritt 3: Das Präfix mit LuckPerms setzen

Leg die Gruppen an, falls es sie noch nicht gibt, und setz dann das Präfix jeder Gruppe. Der Generator schreibt dir diese Zeilen für alle Ränge auf einmal:

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

• Die Zahl ist die Priorität. Ist ein Spieler in mehreren Gruppen, zeigt LuckPerms das Präfix mit der höchsten Priorität. Der Generator gibt dem obersten Rang die höchste Zahl, in Zehnerschritten.
• setprefix ersetzt vorhandene Präfixe dieser Gruppe im selben Kontext. addprefix würde ein weiteres daneben anlegen.
• Die Anführungszeichen braucht es, weil das Präfix mit einem Leerzeichen endet. Das trennt das Abzeichen vom Namen.
• Entfernen kannst du ein Präfix mit lp group vip meta removeprefix 10.

Du willst mehrere Abzeichen nebeneinander, etwa Rang und Unterstützer? LuckPerms kann Präfixe über den Abschnitt meta-formatting in seiner config.yml stapeln (format, duplicates, start-spacer, middle-spacer, end-spacer).

Schritt 4: Abzeichen in Chat und Tab anzeigen

Im Präfix steht jetzt %img_admin%. Irgendein Plugin muss diesen Platzhalter durch das Abzeichen ersetzen. Dein Chat- oder Tab-Plugin muss also das LuckPerms-Präfix anzeigen und PlaceholderAPI-Platzhalter darin auflösen.

1. Installier PlaceholderAPI und die LuckPerms-Erweiterung: /papi ecloud download LuckPerms, danach /papi reload.
2. Nutz %luckperms_prefix% im Chatformat, oder lass das Chat-Plugin das Präfix über Vault lesen.
3. Für die Tabliste zeigt das ItemsAdder-Wiki das Plugin TAB mit dem Bild-Platzhalter direkt im Gruppen-Präfix, danach /tab reload:

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

Der eigene ItemsAdder-Tag :admin: funktioniert überall dort, wo ItemsAdder den Text selbst ersetzt. Plugins, die nur PlaceholderAPI verstehen, brauchen stattdessen %img_admin%. Deshalb nutzt der Generator die Platzhalter-Form.

Text-Präfixe ohne Ressourcenpaket

Wenn du kein Ressourcenpaket willst, gehen auch farbige Text-Präfixe. Der Generator schreibt sie dir ebenfalls, mit &#-Hexfarben und fett:

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

Hexfarben brauchen Minecraft 1.16 oder neuer und ein Chat-Plugin, das &#RRGGBB versteht. Für Chat-Plugins mit MiniMessage kopierst du stattdessen die MiniMessage-Zeilen mit <gradient>. Mehr zu Farbformaten steht in der Anleitung zu MOTD-Farben, Hex und Verläufen.

Typische Fehler und Lösungen

Mit derselben Font-Image-Technik entstehen auch ganze Menü-Hintergründe, siehe eigener GUI-Hintergrund in DeluxeMenus mit ItemsAdder. Und wenn deine Ränge Vote-Vorteile haben, zeigt dir die Anleitung zu Vote-Belohnungen mit VotingPlugin, wie du sie verteilst.