Spring til indhold

DeluxeMenus-GUI-baggrund med Nexo eller Oraxen

Egne menuskærme i Minecraft er et trick: baggrundsbilledet er ét enkelt tegn i menutitlen. Nexo og Oraxen kalder disse tegn glyphs. Denne guide viser glyph-configen til begge plugins, de shift-placeholders, der flytter billedet på plads, og hvordan du forbinder det hele med DeluxeMenus.

Opdateret:

Sådan bliver et glyph til en menubaggrund

En kistemenu skriver sin titel i øverste venstre hjørne, og titlen kan indeholde tegn fra serverens resource pack. Et glyph er sådan et tegn, tegnet ud fra din PNG. Sæt et stort glyph ind i titlen, så maler klienten det hen over hele kisteskærmen.

To værdier placerer det. Et negativt shift flytter markøren til venstre før glyphet, så billedet starter ved kistens kant og ikke ved titlens indrykning. Glyphets ascent flytter det lodret, indtil det dækker menuen. Slots forbliver rigtige slots: hvor billedet viser en knap, har menuen et tomt slot med material: air, der stadig kører klik-actions.

Bruger du ItemsAdder i stedet, så læs ItemsAdder-versionen af denne guide. Idéen er den samme, kun configen og navnene på placeholders er forskellige.

Det skal du bruge

  • DeluxeMenus og PlaceholderAPI på din server. DeluxeMenus fortolker PlaceholderAPI-placeholders i menu_title.
  • Nexo eller Oraxen, som bygger resource packen og leverer glyph- og shift-placeholders.
  • Til Oraxen: glyphs i inventory-titler virker indbygget på Paper 1.21.2 eller nyere. Ældre servere kræver PacketEvents ifølge Oraxen-dokumentationen.
  • En baggrunds-PNG på højst 256×256 pixels. Større teksturer er ikke tilladt til ét glyph.

Trin 1: Design baggrunden

Byg menuen i GUI-makeren: vælg rækkerne, en skabelon eller et tema, og tegn store knapper hen over flere slots. Under eksport vælger du Nexo eller Oraxen og angiver et namespace (f.eks. mymenus) og et menunavn (f.eks. shop).

PNG’en er 256 pixels bred og mellem 164 pixels (én række) og 254 pixels (seks rækker) høj. Margenen omkring kisten giver rammer plads til at stikke ud over menuens normale omrids.

Trin 2a: Glyph-config til Nexo

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

plugins/Nexo/glyphs/gui_shop.yml
gui_shop:
  texture: mymenus:gui/shop
  ascent: 45
  height: 254
  • height er den tegnede højde. Brug PNG’ens rigtige højde i pixels.
  • ascent flytter glyphet op. Ifølge Nexo må height aldrig være lavere end ascent.
  • Placeholderne er %nexo_gui_shop% til glyphet og %nexo_shift_<pixels>% til mellemrum, som godt må være negativt.

Trin 2b: Glyph-config til Oraxen

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

plugins/Oraxen/glyphs/gui_shop.yml
gui_shop:
  texture: gui/shop
  ascent: 45
  height: 254
  • Oraxen kræver, at height er større end eller lig med ascent; det håndhæver Minecraft.
  • Glyph-placeholderen er %oraxen_gui_shop%. Til shifts er der to placeholders: %oraxen_shift_<pixels>% flytter til højre, %oraxen_neg_shift_<pixels>% flytter til venstre. Hver af dem klarer op til 2047 pixels.
  • Der findes en char-nøgle, hvis du selv vil vælge tegnet, men den er valgfri.

Trin 3: DeluxeMenus-menuens titel

Titlen kombinerer farve, et shift til venstre, glyphet, et shift tilbage og titelteksten. Til Nexo:

plugins/DeluxeMenus/gui_menus/shop.yml
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'

Til Oraxen ændrer kun titlen sig, fordi shifts til venstre har deres egen placeholder:

plugins/DeluxeMenus/gui_menus/shop.yml
menu_title: '&f%oraxen_neg_shift_48%%oraxen_gui_shop%%oraxen_neg_shift_201%&8Shop'
  1. &f holder billedet i dets egne farver i stedet for at farve det med titlens farve.
  2. Det første shift flytter markøren 48 pixels til venstre: GUI-makeren regner med 8 pixels for kistetitlens indrykning plus lærredets margen på 40 pixels.
  3. Det andet shift bringer markøren tilbage, så &8Shop står på billedet. Værdien afhænger af billedets bredde; GUI-makeren regner den ud.

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

Trin 4: Registrér menuen, og genindlæs

plugins/DeluxeMenus/config.yml
gui_menus:
  shop:
    file: shop.yml
  1. Byg packen igen: /nexo reload (eller /nexo reload pack) til Nexo, /oraxen reload all til Oraxen.
  2. Kør /dm reload, og test med /dm open shop.
  3. Genstart serveren én gang. DeluxeMenus registrerer kun /shop fra register_command: true ved opstart.
  4. Join igen, så du får den nye resource pack.

Typiske fejl og løsninger

Det ser duÅrsag og løsning
%nexo_gui_shop% eller %oraxen_gui_shop% som tekstPlaceholderAPI mangler, eller glyph-ID’et i placeholderen passer ikke med nøglen i glyph-filen.
En tom boks eller et forkert symbolPacken er ikke bygget igen, eller spilleren har den gamle pack. Genindlæs pluginet, og join igen.
Oraxen-glyph mangler kun i menutitlerServeren er ældre end Paper 1.21.2, og PacketEvents er ikke installeret.
Billedet er forskudtShift eller ascent passer ikke med PNG’en. Eksportér igen fra samme design.
Billedet er mørkere end PNG’en&f mangler før den første placeholder.
Glyphet afvises ved indlæsningascent er højere end height, eller PNG’en er større end 256×256.
/shop gør ingentingMenuen står ikke i config.yml, eller serveren er ikke genstartet, efter den blev tilføjet.

Ofte stillede spørgsmål

Er opsætningen forskellig for Nexo og Oraxen?

Kun i detaljerne. Nexo skriver teksturen som namespace:path og bruger %nexo_shift_N% med negative tal. Oraxen tager en sti relativ til pack/textures/ og har %oraxen_neg_shift_N% til at flytte til venstre.

Hvorfor vises mit glyph ikke i DeluxeMenus-titlen?

Som regel bliver placeholderen ikke erstattet (PlaceholderAPI mangler eller forkert glyph-ID), resource packen er ikke bygget igen, eller spilleren har ikke indlæst den nye pack. Med Oraxen på servere ældre end Paper 1.21.2 kræves PacketEvents til titler.

Hvilken reload-kommando skal jeg bruge?

Til Nexo /nexo reload, som genindlæser alt, eller /nexo reload pack kun til packen. Til Oraxen /oraxen reload all. Derefter /dm reload til menufilen.

Kan jeg bruge en tekstur større end 256×256 pixels?

Ikke som ét glyph. Minecraft begrænser glyphs til 256×256 pixels. En menubaggrund fra GUI-makeren holder sig inden for den grænse ved alle antal rækker.

Kilder

Tjekket mod den officielle dokumentation: