DeluxeMenus-GUI-Hintergrund mit Nexo oder Oraxen

Wie eine Glyphe zum Menü-Hintergrund wird

Ein Kistenmenü schreibt seinen Titel oben links, und dieser Titel darf Zeichen aus dem Ressourcenpaket des Servers enthalten. Eine Glyphe ist genau so ein Zeichen, gezeichnet aus deinem PNG. Steht eine große Glyphe im Titel, malt der Client sie über das ganze Kistenmenü.

Zwei Werte bestimmen die Position. Ein negativer Shift schiebt den Cursor vor der Glyphe nach links, damit das Bild am Rand der Kiste beginnt und nicht beim Einzug des Titels. Mit ascent schiebst du die Glyphe senkrecht, bis sie das Menü bedeckt. Die Slots bleiben echte Slots: Wo das Bild einen Knopf zeigt, liegt ein leerer Slot mit material: air, der trotzdem Klick-Aktionen ausführt.

Nutzt du ItemsAdder, lies besser die ItemsAdder-Fassung dieser Anleitung. Die Idee ist dieselbe, nur Config und Platzhalter heißen anders.

Was du brauchst

• DeluxeMenus und PlaceholderAPI auf deinem Server. DeluxeMenus wertet PlaceholderAPI-Platzhalter in menu_title aus.
• Nexo oder Oraxen, die das Ressourcenpaket bauen und die Platzhalter für Glyphen und Shifts liefern.
• Für Oraxen: Laut Doku funktionieren Glyphen in Inventartiteln ab Paper 1.21.2 direkt. Ältere Server brauchen PacketEvents.
• Ein Hintergrund-PNG mit höchstens 256×256 Pixeln. Größere Texturen sind für eine einzelne Glyphe nicht erlaubt.

Schritt 1: Den Hintergrund gestalten

Bau das Menü im GUI-Maker: Reihen festlegen, eine Vorlage oder ein Theme wählen und große Knöpfe über mehrere Slots ziehen. Wähl beim Export Nexo oder Oraxen, gib einen Namespace an (zum Beispiel mymenus) und einen Menünamen (zum Beispiel shop).

Das PNG ist 256 Pixel breit und zwischen 164 Pixel (eine Reihe) und 254 Pixel (sechs Reihen) hoch. Der Rand um die Kiste gibt Rahmen Platz, über den normalen Menüumriss hinauszuragen.

Schritt 2a: Die Nexo-Glyphe einrichten

Nexo liest Glyphen aus jeder YAML-Datei in seinem Glyphen-Ordner. Die Textur schreibst du als namespace:pfad, hier das PNG unter plugins/Nexo/pack/assets/mymenus/textures/gui/shop.png:

gui_shop:
  texture: mymenus:gui/shop
  ascent: 45
  height: 254

• height ist die gezeichnete Höhe. Nimm die echte Pixelhöhe des PNG.
• ascent schiebt die Glyphe nach oben. Laut Nexo darf height nie kleiner als ascent sein.
• Die Platzhalter heißen %nexo_gui_shop% für die Glyphe und %nexo_shift_<pixel>% für Leerraum, der auch negativ sein darf.

Schritt 2b: Die Oraxen-Glyphe einrichten

Oraxen liest Glyphen aus plugins/Oraxen/glyphs/. Der Texturpfad ist relativ zu pack/textures/, das PNG liegt also unter plugins/Oraxen/pack/textures/gui/shop.png:

gui_shop:
  texture: gui/shop
  ascent: 45
  height: 254

• Oraxen verlangt, dass height größer oder gleich ascent ist; Minecraft erzwingt das.
• Der Platzhalter der Glyphe ist %oraxen_gui_shop%. Für Shifts gibt es zwei: %oraxen_shift_<pixel>% schiebt nach rechts, %oraxen_neg_shift_<pixel>% nach links, jeweils bis 2047 Pixel.
• Mit dem Schlüssel char kannst du das Zeichen selbst festlegen, nötig ist das nicht.

Schritt 3: Der Menütitel in DeluxeMenus

Der Titel besteht aus Farbe, einem Shift nach links, der Glyphe, einem Shift zurück und dem Titeltext. Für Nexo:

menu_title: '&f%nexo_shift_-48%%nexo_gui_shop%%nexo_shift_-201%&8Shop'
open_command: 'shop'
register_command: true
size: 54
items:
  button_1_buy:
    material: air
    slots: [10, 11, 19, 20]
    priority: 1
    click_commands:
      - '[openguimenu] shop_buy'

Bei Oraxen ändert sich nur der Titel, weil Verschiebungen nach links einen eigenen Platzhalter haben:

menu_title: '&f%oraxen_neg_shift_48%%oraxen_gui_shop%%oraxen_neg_shift_201%&8Shop'

1. &f lässt das Bild in seinen eigenen Farben, statt es mit der Titelfarbe einzufärben.
2. Der erste Shift schiebt den Cursor 48 Pixel nach links: Der GUI-Maker rechnet 8 Pixel für den Einzug des Kistentitels plus 40 Pixel Rand seiner Leinwand.
3. Der zweite Shift holt den Cursor zurück, damit &8Shop auf dem Bild steht. Der Wert hängt von der Bildbreite ab, der GUI-Maker rechnet ihn aus.

Nexo und Oraxen kennen auch MiniMessage-Tags wie <glyph:gui_shop> und <shift:-48>. Der GUI-Maker schreibt die Form mit %…%, weil DeluxeMenus PlaceholderAPI-Platzhalter für menu_title dokumentiert.

Schritt 4: Menü registrieren und neu laden

gui_menus:
  shop:
    file: shop.yml

1. Bau das Paket neu: /nexo reload (oder /nexo reload pack) bei Nexo, /oraxen reload all bei Oraxen.
2. Führ /dm reload aus und teste mit /dm open shop.
3. Starte den Server einmal neu. DeluxeMenus registriert /shop aus register_command: true nur beim Start.
4. Join neu, damit du das neue Ressourcenpaket bekommst.

Typische Fehler und Lösungen