Fundo de GUI no DeluxeMenus com Nexo ou Oraxen

Como um glyph se torna o fundo de um menu

Um menu de baú escreve o título no canto superior esquerdo, e esse título pode conter caracteres do resource pack do servidor. Um glyph é um carácter destes, desenhado a partir do teu PNG. Coloca um glyph grande no título e o cliente pinta-o por cima de todo o ecrã do baú.

Dois valores definem a posição. Um shift negativo move o cursor para a esquerda antes do glyph, para que a imagem comece na borda do baú e não no recuo do título. O ascent do glyph move-o na vertical até cobrir o menu. Os slots continuam a ser slots a sério: onde a imagem mostra um botão, o menu tem um slot vazio com material: air que continua a executar ações ao clicar.

Se usares o ItemsAdder, lê a versão deste guia para o ItemsAdder. A ideia é a mesma; só mudam a config e os nomes dos placeholders.

O que precisas

• DeluxeMenus e PlaceholderAPI no teu servidor. O DeluxeMenus interpreta placeholders do PlaceholderAPI em menu_title.
• Nexo ou Oraxen, que constroem o resource pack e fornecem os placeholders de glyph e de shift.
• Para o Oraxen: os glyphs em títulos de inventário funcionam nativamente em Paper 1.21.2 ou mais recente. Servidores mais antigos precisam do PacketEvents, segundo a documentação do Oraxen.
• Um PNG de fundo com no máximo 256×256 píxeis. Texturas maiores não são permitidas num único glyph.

Passo 1: Desenha o fundo

Cria o menu no criador de GUI: escolhe as linhas, um preset ou tema e desenha botões grandes sobre vários slots. Na exportação, escolhe Nexo ou Oraxen, define um namespace (por exemplo mymenus) e um nome de menu (por exemplo shop).

O PNG tem 256 píxeis de largura e entre 164 píxeis (uma linha) e 254 píxeis (seis linhas) de altura. A margem à volta do baú dá espaço às molduras para saírem do contorno normal do menu.

Passo 2a: Config do glyph no Nexo

O Nexo lê glyphs de qualquer ficheiro YAML na sua pasta de glyphs. A textura escreve-se como namespace:path, aqui o PNG em plugins/Nexo/pack/assets/mymenus/textures/gui/shop.png:

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

• height é a altura desenhada. Usa a altura real do PNG em píxeis.
• ascent move o glyph para cima. O Nexo diz que a altura nunca pode ser menor do que o ascent.
• Os placeholders são %nexo_gui_shop% para o glyph e %nexo_shift_<pixels>% para espaço, que pode ser negativo.

Passo 2b: Config do glyph no Oraxen

O Oraxen lê glyphs de plugins/Oraxen/glyphs/. O caminho da textura é relativo a pack/textures/, por isso o PNG vai para plugins/Oraxen/pack/textures/gui/shop.png:

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

• O Oraxen exige que height seja maior ou igual a ascent; é o Minecraft que o impõe.
• O placeholder do glyph é %oraxen_gui_shop%. Os shifts têm dois placeholders: %oraxen_shift_<pixels>% move para a direita e %oraxen_neg_shift_<pixels>% move para a esquerda. Cada um suporta até 2047 píxeis.
• Existe uma chave char para escolheres tu o carácter, mas é opcional.

Passo 3: O título do menu no DeluxeMenus

O título junta a cor, um shift para a esquerda, o glyph, um shift de volta e o texto do título. Para o 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'

Para o Oraxen só muda o título, porque os shifts para a esquerda têm o seu próprio placeholder:

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

1. &f mantém a imagem nas suas próprias cores em vez de a tingir com a cor do título.
2. O primeiro shift move o cursor 48 píxeis para a esquerda: o criador de GUI conta 8 píxeis do recuo do título do baú mais a margem de 40 píxeis da sua tela.
3. O segundo shift traz o cursor de volta para que &8Shop fique por cima da imagem. O valor depende da largura da tua imagem; o criador de GUI calcula-o.

O Nexo e o Oraxen também têm tags MiniMessage como <glyph:gui_shop> e <shift:-48>. O criador de GUI escreve a forma %…%, porque o DeluxeMenus documenta placeholders do PlaceholderAPI para menu_title.

Passo 4: Regista o menu e recarrega

gui_menus:
  shop:
    file: shop.yml

1. Reconstrói o pack: /nexo reload (ou /nexo reload pack) no Nexo, /oraxen reload all no Oraxen.
2. Executa /dm reload e testa com /dm open shop.
3. Reinicia o servidor uma vez. O DeluxeMenus só regista /shop a partir de register_command: true ao arrancar.
4. Volta a entrar para receberes o novo resource pack.

Erros comuns e soluções