Fons de GUI a DeluxeMenus amb Nexo o Oraxen

Com un glif es converteix en fons de menú

Un menú de cofre escriu el seu títol a la cantonada superior esquerra, i aquest títol pot contenir caràcters del paquet de recursos (resource pack) del servidor. Un glif és un d’aquests caràcters, dibuixat a partir del teu PNG. Si poses un glif gran al títol, el client el pinta sobre tota la pantalla del cofre.

Dos valors el col·loquen. Un shift negatiu mou el cursor cap a l’esquerra abans del glif, així la imatge comença a la vora del cofre i no al sagnat del títol. L’ascent del glif el mou en vertical fins que cobreix el menú. Els slots continuen sent slots reals: on la imatge mostra un botó, el menú té un slot buit amb material: air que continua executant accions en fer-hi clic.

Si fas servir ItemsAdder, llegeix la versió d’aquesta guia per a ItemsAdder. La idea és la mateixa; només canvien la configuració i els noms dels placeholders.

Què necessites

• DeluxeMenus i PlaceholderAPI al teu servidor. DeluxeMenus interpreta els placeholders de PlaceholderAPI a menu_title.
• Nexo o Oraxen, que generen el paquet de recursos i ofereixen els placeholders de glifs i de shift.
• Per a Oraxen: segons la seva documentació, els glifs als títols d’inventari funcionen de manera nativa a Paper 1.21.2 o superior. Els servidors més antics necessiten PacketEvents.
• Un PNG de fons de 256×256 píxels com a màxim. Un sol glif no admet textures més grans.

Pas 1: dissenya el fons

Crea el menú al Creador de GUI: tria les files, una plantilla o un tema i dibuixa botons grans sobre diversos slots. A l’exportació tria Nexo o Oraxen, posa un namespace (per exemple mymenus) i un nom de menú (per exemple shop).

El PNG fa 256 píxels d’amplada i entre 164 píxels (una fila) i 254 píxels (sis files) d’alçada. El marge al voltant del cofre deixa lloc perquè els marcs sobresurtin del contorn normal del menú.

Pas 2a: configuració del glif a Nexo

Nexo llegeix els glifs de qualsevol fitxer YAML de la seva carpeta de glifs. La textura s’escriu com a namespace:ruta, aquí el PNG a plugins/Nexo/pack/assets/mymenus/textures/gui/shop.png:

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

• height és l’alçada amb què es dibuixa. Fes servir l’alçada real en píxels del PNG.
• ascent puja el glif. Nexo indica que l’alçada mai no ha de ser més petita que l’ascent.
• Els placeholders són %nexo_gui_shop% per al glif i %nexo_shift_<píxels>% per a l’espai, que pot ser negatiu.

Pas 2b: configuració del glif a Oraxen

Oraxen llegeix els glifs de plugins/Oraxen/glyphs/. La seva ruta de textura és relativa a pack/textures/, així que el PNG va a plugins/Oraxen/pack/textures/gui/shop.png:

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

• Oraxen exigeix que height sigui més gran o igual que ascent; Minecraft ho imposa.
• El placeholder del glif és %oraxen_gui_shop%. Els desplaçaments tenen dos placeholders: %oraxen_shift_<píxels>% mou cap a la dreta i %oraxen_neg_shift_<píxels>% cap a l’esquerra. Cadascun admet fins a 2047 píxels.
• Hi ha una clau char per triar tu mateix el caràcter, però és opcional.

Pas 3: el títol del menú a DeluxeMenus

El títol combina el color, un desplaçament cap a l’esquerra, el glif, un desplaçament de tornada i el text del títol. Per a 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'

Per a Oraxen només canvia el títol, perquè els desplaçaments cap a l’esquerra tenen el seu propi placeholder:

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

1. &f manté la imatge amb els seus propis colors en lloc de tenyir-la amb el color del títol.
2. El primer desplaçament mou el cursor 48 píxels cap a l’esquerra: el Creador de GUI compta 8 píxels del sagnat del títol del cofre més el marge de 40 píxels del seu llenç.
3. El segon desplaçament torna el cursor enrere perquè &8Shop quedi sobre la imatge. El seu valor depèn de l’amplada de la teva imatge; el Creador de GUI el calcula.

Nexo i Oraxen també tenen etiquetes MiniMessage com <glyph:gui_shop> i <shift:-48>. El Creador de GUI escriu la forma %…% perquè DeluxeMenus documenta els placeholders de PlaceholderAPI per a menu_title.

Pas 4: registra el menú i recarrega

gui_menus:
  shop:
    file: shop.yml

1. Regenera el paquet: /nexo reload (o /nexo reload pack) a Nexo i /oraxen reload all a Oraxen.
2. Executa /dm reload i prova-ho amb /dm open shop.
3. Reinicia el servidor una vegada. DeluxeMenus registra /shop a partir de register_command: true només quan arrenca.
4. Torna a entrar per rebre el paquet de recursos nou.

Errors comuns i solucions