Aller au contenu principal

Cookbook

Quatre modèles à adapter. Chacun liste les layouts concernés et les champs à renseigner dans l'entrée Open GUI.

1. Liste défilante avec flèches​

Layouts : composite, scrollable, deux simple.

  1. Créez un layout simple list_content contenant les lignes de la liste. Il peut être plus haut que la fenêtre : placez des objets de y 0 à 14.
  2. Créez un layout scrollable list_scroll avec innerId list_content, virtualWidth 9 et virtualHeight 15.
  3. Dans ses buttons, ajoutez un bouton direction UP à x 8, y 0 et un bouton DOWN à x 8, y 5, chacun avec step 1 et un objet en forme de flèche.
  4. Créez un layout simple border avec une vitre à x 8, y 1, count 4, direction down, displayName composé d'un seul espace.
  5. Créez un layout composite main avec pour children list_scroll puis border, et définissez mainLayoutId sur main.

Les boutons restent ancrés à la fenêtre et disparaissent lorsqu'il n'y a plus rien à faire défiler dans leur direction.

2. Liste paginée​

Layouts : composite, simple, paginated.

  1. Créez un layout paginated shop avec itemsPerPage 21 et slots 10 à 16, 19 à 25 et 28 à 34.
  2. Ajoutez un objet par produit dans items, avec une interaction LEFT_CLICK qui exécute votre commande ou votre trigger.
  3. Dans navigationButtons, ajoutez un bouton PREVIOUS à x 0, y 5, un bouton NEXT à x 8, y 5 et un INDICATOR à x 4, y 5 avec le nom <gray>{page_indicator}.
  4. Placez un layout simple avec la bordure dans un composite en dessous.

Pour une vraie boutique avec des prix et du stock, utilisez Shops, qui remplit un layout paginé à votre place.

3. Menu de confirmation​

Illustre closeMenu, executeReturn et l'historique de session.

  1. Ouvrez la confirmation depuis le bouton dangereux : ajoutez une commande gui:open <confirm menu entry id> à son interaction, ou liez l'entrée Open GUI dans triggers.
  2. Créez un Open GUI avec guiType CUSTOM, size SIZE_27 et un layout simple.
  3. Ajoutez une laine verte à x 2, y 1 avec une interaction LEFT_CLICK qui exécute la commande, avec closeMenu activé.
  4. Ajoutez une laine rouge à x 6, y 1 avec une interaction LEFT_CLICK et executeReturn activé. Elle ramène au menu qui a ouvert celui-ci, quel qu'il soit.

4. Dépôt avec quota​

Illustre les emplacements de stockage, un objet requis et un trigger.

  1. Créez un artifact GUI Storage.
  2. Dans le storagePool de l'Open GUI, ajoutez une configuration avec un id tel que iron_bank, l'artifact dans entry, requiredItem un lingot de fer, requiredAmount 32 et l'entrée de déblocage dans onReachRequired. Définissez placeholder sur une vitre grise.
  3. Dans un layout simple, ajoutez un objet à x 4, y 1 avec storageId iron_bank. Son nom et son lore peuvent utiliser {stored_name}, {stored_amount} et {stored_max}.

Laissez group vide pour un stockage par joueur, ou choisissez une entrée de groupe (une île, une guilde) pour partager le stockage.

Astuces​

  • L'ordre des couches dans un composite est l'ordre de dessin : l'arrière-plan d'abord, les boutons en dernier.
  • Donnez un id unique à chaque layout scrollable et paginé.
  • Utilisez criteria sur les objets pour afficher ou masquer des boutons selon le joueur.
  • Définissez le displayName des vitres décoratives sur un seul espace pour masquer le nom de l'objet vanilla.