Aller au contenu principal

Comprendre un menu GUI

Une entrée Open GUI contient tout ce dont un menu a besoin : le type de fenêtre, le titre, un pool de dispositions et les options de la session. Cette page explique le vocabulaire et l'ordre dans lequel construire un menu.

Vocabulaire​

TermeSignification
layoutPoolLes dispositions nommées du menu.
mainLayoutIdL'id de la disposition dessinée en premier (la racine).
Disposition (layout)Une règle qui place des emplacements : grille, lignes, pages, zone défilante, cadres ou calques.
Objet (item)La description d'un emplacement : objet, nom, lore, position, permissions et actions de clic.
InteractionCe qui se passe pour un type de clic : commandes, triggers, fermeture ou retour.
SessionL'état d'un menu ouvert pour un joueur : historique, page courante, position de défilement et vue active.
ViewportLa partie d'une disposition défilante actuellement visible.

Ordre de construction​

  1. Créez l'entrée Open GUI, puis choisissez guiType, size et title.
  2. Ajoutez une disposition simple avec un id, et écrivez cet id dans mainLayoutId.
  3. Ajoutez d'abord les objets décoratifs (bordures, arrière-plans), puis les boutons.
  4. Ajoutez des entrées interactionList aux boutons.
  5. Ajoutez seulement ensuite frame, scrollable, paginated ou views.

Répétition d'emplacements​

count, direction, gap et repeatY répètent un objet. Un seul objet avec count 9 et direction right remplit une ligne. Ces champs placent des emplacements ; ils ne modifient jamais la taille de pile de l'objet. gap est un pas : 1 place des emplacements adjacents et 2 laisse un emplacement vide entre les copies. Sans direction, ces trois champs sont ignorés et un seul emplacement est placé.

Les emplacements qui tomberaient en dehors de la grille sont supprimés et listés dans la console avec l'id de la disposition et les coordonnées.

Visibilité et clics​

  • criteria masque l'emplacement pour les joueurs qui ne correspondent pas.
  • viewPermission masque l'emplacement pour les joueurs sans la permission.
  • clickPermission dessine l'emplacement mais le rend inerte.
  • allowPickup permet au joueur de sortir l'objet du menu ; désactivé par défaut.

Tous sont facultatifs, et une permission vide ne contrôle rien.

Ouvrir, revenir et fermer​

  • Toute entrée capable de déclencher une action peut déclencher l'Open GUI.
  • executeReturn sur une interaction revient au menu précédent de la session.
  • closeMenu sur une interaction ferme la fenêtre.
  • Fermer avec Échap met fin à la session.

Étapes suivantes​