DeluxeMenus-GUI-bakgrunn med Nexo eller Oraxen

Slik blir en glyph til en menybakgrunn

En kistemeny skriver tittelen sin øverst i venstre hjørne, og tittelen kan inneholde tegn fra serverens ressurspakke. En glyph er et slikt tegn, laget av PNG-en din. Sett en stor glyph inn i tittelen, så maler klienten den over hele kisteskjermen.

To verdier plasserer den. Et negativt shift flytter markøren til venstre før glyphen, så bildet starter ved kanten av kisten og ikke ved innrykket i tittelen. Glyphens ascent flytter den loddrett til den dekker menyen. Slotene forblir ekte sloter: der bildet viser en knapp, har menyen en tom slot med material: air som fortsatt kjører klikkhandlinger.

Bruker du ItemsAdder i stedet, kan du lese ItemsAdder-versjonen av denne guiden. Ideen er den samme, bare configen og navnene på placeholderne er forskjellige.

Dette trenger du

• DeluxeMenus og PlaceholderAPI på serveren din. DeluxeMenus tolker PlaceholderAPI-placeholdere i menu_title.
• Nexo eller Oraxen, som bygger ressurspakken og leverer glyph- og shift-placeholderne.
• For Oraxen: glyphs i inventory-titler fungerer innebygd på Paper 1.21.2 eller nyere. Eldre servere trenger PacketEvents, ifølge Oraxen-dokumentasjonen.
• En bakgrunns-PNG på maks 256×256 piksler. Større teksturer er ikke tillatt for én glyph.

Steg 1: Design bakgrunnen

Bygg menyen i GUI-makeren: velg rader, en mal eller et tema, og tegn store knapper over flere sloter. Under eksport velger du Nexo eller Oraxen og angir et namespace (for eksempel mymenus) og et menynavn (for eksempel shop).

PNG-en er 256 piksler bred og mellom 164 piksler (én rad) og 254 piksler (seks rader) høy. Margen rundt kisten gir rammer plass til å stikke utenfor menyens vanlige omriss.

Steg 2a: Glyph-config for Nexo

Nexo leser glyphs fra alle YAML-filer i glyphs-mappen sin. Teksturen skrives som namespace:path, her PNG-en i plugins/Nexo/pack/assets/mymenus/textures/gui/shop.png:

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

• height er den tegnede høyden. Bruk den faktiske høyden til PNG-en i piksler.
• ascent flytter glyphen opp. Ifølge Nexo må height aldri være lavere enn ascent.
• Placeholderne er %nexo_gui_shop% for glyphen og %nexo_shift_<pixels>% for mellomrom, som godt kan være negativt.

Steg 2b: Glyph-config for Oraxen

Oraxen leser glyphs fra plugins/Oraxen/glyphs/. Teksturstien er relativ til pack/textures/, så PNG-en skal ligge i plugins/Oraxen/pack/textures/gui/shop.png:

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

• Oraxen krever at height er større enn eller lik ascent; det er Minecraft som håndhever dette.
• Glyph-placeholderen er %oraxen_gui_shop%. For shifts finnes det to placeholdere: %oraxen_shift_<pixels>% flytter til høyre, %oraxen_neg_shift_<pixels>% flytter til venstre. Hver av dem klarer opptil 2047 piksler.
• Det finnes en char-nøkkel hvis du vil velge tegnet selv, men den er valgfri.

Steg 3: Tittelen på DeluxeMenus-menyen

Tittelen kombinerer farge, et shift til venstre, glyphen, et shift tilbake og tittelteksten. For 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'

For Oraxen endres bare tittelen, fordi shifts til venstre har sin egen placeholder:

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

1. &f holder bildet i sine egne farger i stedet for å farge det med tittelfargen.
2. Det første shiftet flytter markøren 48 piksler til venstre: GUI-makeren regner med 8 piksler for innrykket i kistetittelen pluss lerretets marg på 40 piksler.
3. Det andre shiftet flytter markøren tilbake, så &8Shop står på bildet. Verdien avhenger av bredden på bildet ditt; GUI-makeren regner den ut.

Nexo og Oraxen har også MiniMessage-tagger som <glyph:gui_shop> og <shift:-48>. GUI-makeren skriver %…%-formen, fordi DeluxeMenus dokumenterer PlaceholderAPI-placeholdere for menu_title.

Steg 4: Registrer menyen og last inn på nytt

gui_menus:
  shop:
    file: shop.yml

1. Bygg pakken på nytt: /nexo reload (eller /nexo reload pack) for Nexo, /oraxen reload all for Oraxen.
2. Kjør /dm reload og test med /dm open shop.
3. Start serveren på nytt én gang. DeluxeMenus registrerer /shop fra register_command: true bare ved oppstart.
4. Koble til igjen, så du får den nye ressurspakken.

Vanlige feil og løsninger