Fondo de GUI en DeluxeMenus con Nexo u Oraxen

Cómo un glifo se convierte en fondo de menú

Un menú de cofre escribe su título en la esquina superior izquierda, y ese título puede contener caracteres del paquete de recursos del servidor. Un glifo es uno de esos caracteres, dibujado a partir de tu PNG. Si pones un glifo grande en el título, el cliente lo pinta sobre toda la pantalla del cofre.

Dos valores lo colocan. Un shift negativo mueve el cursor a la izquierda antes del glifo, así la imagen empieza en el borde del cofre y no en la sangría del título. El ascent del glifo lo mueve en vertical hasta que cubre el menú. Los slots siguen siendo slots reales: donde la imagen muestra un botón, el menú tiene un slot vacío con material: air que sigue ejecutando acciones al hacer clic.

Si usas ItemsAdder, lee la versión de esta guía para ItemsAdder. La idea es la misma; solo cambian la configuración y los nombres de los placeholders.

Qué necesitas

• DeluxeMenus y PlaceholderAPI en tu servidor. DeluxeMenus interpreta los placeholders de PlaceholderAPI en menu_title.
• Nexo u Oraxen, que generan el paquete de recursos y ofrecen los placeholders de glifos y de shift.
• Para Oraxen: según su documentación, los glifos en títulos de inventario funcionan de forma nativa en Paper 1.21.2 o superior. Los servidores más antiguos necesitan PacketEvents.
• Un PNG de fondo de 256×256 píxeles como máximo. Un solo glifo no admite texturas más grandes.

Paso 1: Diseña el fondo

Crea el menú en el Creador de GUI: elige las filas, una plantilla o un tema y dibuja botones grandes sobre varios slots. En la exportación elige Nexo u Oraxen, pon un namespace (por ejemplo mymenus) y un nombre de menú (por ejemplo shop).

El PNG mide 256 píxeles de ancho y entre 164 píxeles (una fila) y 254 píxeles (seis filas) de alto. El margen alrededor del cofre deja sitio para que los marcos sobresalgan del contorno normal del menú.

Paso 2a: Configuración del glifo en Nexo

Nexo lee los glifos de cualquier archivo YAML de su carpeta de glifos. La textura se escribe como namespace:ruta, aquí el PNG en plugins/Nexo/pack/assets/mymenus/textures/gui/shop.png:

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

• height es la altura con la que se dibuja. Usa la altura real en píxeles del PNG.
• ascent sube el glifo. Nexo indica que la altura nunca debe ser menor que el ascent.
• Los placeholders son %nexo_gui_shop% para el glifo y %nexo_shift_<píxeles>% para el espacio, que puede ser negativo.

Paso 2b: Configuración del glifo en Oraxen

Oraxen lee los glifos de plugins/Oraxen/glyphs/. Su ruta de textura es relativa a pack/textures/, así que el PNG va en plugins/Oraxen/pack/textures/gui/shop.png:

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

• Oraxen exige que height sea mayor o igual que ascent; Minecraft lo impone.
• El placeholder del glifo es %oraxen_gui_shop%. Los desplazamientos tienen dos placeholders: %oraxen_shift_<píxeles>% mueve a la derecha y %oraxen_neg_shift_<píxeles>% a la izquierda. Cada uno admite hasta 2047 píxeles.
• Existe una clave char para elegir tú el carácter, pero es opcional.

Paso 3: El título del menú en DeluxeMenus

El título combina el color, un desplazamiento a la izquierda, el glifo, un desplazamiento de vuelta y el texto del título. Para 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 Oraxen solo cambia el título, porque los desplazamientos a la izquierda tienen su propio placeholder:

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

1. &f mantiene la imagen con sus propios colores en lugar de teñirla con el color del título.
2. El primer desplazamiento mueve el cursor 48 píxeles a la izquierda: el Creador de GUI cuenta 8 píxeles de la sangría del título del cofre más el margen de 40 píxeles de su lienzo.
3. El segundo desplazamiento devuelve el cursor para que &8Shop quede sobre la imagen. Su valor depende del ancho de tu imagen; el Creador de GUI lo calcula.

Nexo y Oraxen también tienen etiquetas MiniMessage como <glyph:gui_shop> y <shift:-48>. El Creador de GUI escribe la forma %…% porque DeluxeMenus documenta los placeholders de PlaceholderAPI para menu_title.

Paso 4: Registra el menú y recarga

gui_menus:
  shop:
    file: shop.yml

1. Regenera el paquete: /nexo reload (o /nexo reload pack) en Nexo y /oraxen reload all en Oraxen.
2. Ejecuta /dm reload y pruébalo con /dm open shop.
3. Reinicia el servidor una vez. DeluxeMenus registra /shop a partir de register_command: true solo al arrancar.
4. Vuelve a entrar para recibir el paquete de recursos nuevo.

Errores comunes y soluciones