Fond de GUI DeluxeMenus avec Nexo ou Oraxen

Comment un glyphe devient un fond de menu

Un menu de coffre affiche son titre en haut à gauche, et ce titre peut contenir des caractères issus du resource pack du serveur. Un glyphe est un tel caractère, dessiné à partir de ton PNG. Place un grand glyphe dans le titre et le client le peint par-dessus tout l’écran du coffre.

Deux valeurs le positionnent. Un shift négatif déplace le curseur vers la gauche avant le glyphe, pour que l’image commence au bord du coffre et non au retrait du titre. L’ascent du glyphe le déplace verticalement jusqu’à ce qu’il couvre le menu. Les slots restent de vrais slots : là où l’image montre un bouton, le menu a un slot vide avec material: air qui exécute quand même des actions de clic.

Si tu utilises plutôt ItemsAdder, lis la version ItemsAdder de ce guide. Le principe est le même, seuls la config et les noms des placeholders changent.

Ce qu’il te faut

• DeluxeMenus et PlaceholderAPI sur ton serveur. DeluxeMenus interprète les placeholders PlaceholderAPI dans menu_title.
• Nexo ou Oraxen, qui génèrent le resource pack et fournissent les placeholders de glyphe et de shift.
• Pour Oraxen : les glyphes dans les titres d’inventaire fonctionnent nativement sur Paper 1.21.2 ou plus récent. Les serveurs plus anciens ont besoin de PacketEvents, selon la doc d’Oraxen.
• Un PNG de fond de 256×256 pixels maximum. Les textures plus grandes ne sont pas autorisées pour un seul glyphe.

Étape 1 : conçois le fond

Crée le menu dans le GUI Maker : choisis le nombre de lignes, un preset ou un thème, et dessine de grands boutons sur plusieurs slots. Dans l’export, choisis Nexo ou Oraxen, définis un namespace (par exemple mymenus) et un nom de menu (par exemple shop).

Le PNG fait 256 pixels de large et entre 164 pixels (une ligne) et 254 pixels (six lignes) de haut. La marge autour du coffre laisse aux cadres la place de dépasser du contour normal du menu.

Étape 2a : config du glyphe pour Nexo

Nexo lit les glyphes depuis n’importe quel fichier YAML de son dossier glyphs. La texture s’écrit namespace:path, ici le PNG situé dans plugins/Nexo/pack/assets/mymenus/textures/gui/shop.png :

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

• height est la hauteur dessinée. Utilise la vraie hauteur en pixels du PNG.
• ascent déplace le glyphe vers le haut. Selon Nexo, la hauteur ne doit jamais être inférieure à l’ascent.
• Les placeholders sont %nexo_gui_shop% pour le glyphe et %nexo_shift_<pixels>% pour l’espace, qui peut être négatif.

Étape 2b : config du glyphe pour Oraxen

Oraxen lit les glyphes depuis plugins/Oraxen/glyphs/. Son chemin de texture est relatif à pack/textures/, donc le PNG va dans plugins/Oraxen/pack/textures/gui/shop.png :

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

• Oraxen exige que height soit supérieur ou égal à ascent ; c’est Minecraft qui l’impose.
• Le placeholder du glyphe est %oraxen_gui_shop%. Les shifts ont deux placeholders : %oraxen_shift_<pixels>% déplace vers la droite, %oraxen_neg_shift_<pixels>% vers la gauche. Chacun gère jusqu’à 2047 pixels.
• Une clé char permet de choisir le caractère toi-même, mais elle est facultative.

Étape 3 : le titre du menu DeluxeMenus

Le titre combine une couleur, un shift vers la gauche, le glyphe, un shift de retour et le texte du titre. Pour 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'

Pour Oraxen, seul le titre change, car les shifts vers la gauche ont leur propre placeholder :

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

1. &f garde l’image dans ses propres couleurs au lieu de la teinter avec la couleur du titre.
2. Le premier shift déplace le curseur de 48 pixels vers la gauche : le GUI Maker compte 8 pixels pour le retrait du titre du coffre, plus la marge de 40 pixels de son canevas.
3. Le second shift ramène le curseur pour que &8Shop se place sur l’image. Sa valeur dépend de la largeur de ton image ; le GUI Maker la calcule.

Nexo et Oraxen ont aussi des tags MiniMessage comme <glyph:gui_shop> et <shift:-48>. Le GUI Maker écrit la forme %…%, car DeluxeMenus documente les placeholders PlaceholderAPI pour menu_title.

Étape 4 : enregistre le menu et recharge

gui_menus:
  shop:
    file: shop.yml

1. Régénère le pack : /nexo reload (ou /nexo reload pack) pour Nexo, /oraxen reload all pour Oraxen.
2. Lance /dm reload et teste avec /dm open shop.
3. Redémarre le serveur une fois. DeluxeMenus n’enregistre /shop via register_command: true qu’au démarrage.
4. Reconnecte-toi pour recevoir le nouveau resource pack.

Erreurs fréquentes et solutions