Saltar al contenido principal

Comprender un menú GUI

Una entrada Open GUI contiene todo lo que necesita un menú: el tipo de ventana, el título, un conjunto de layouts y las opciones de la sesión. Esta página explica el vocabulario y el orden en que conviene construir un menú.

Vocabulario​

TérminoSignificado
layoutPoolLos layouts con nombre del menú.
mainLayoutIdEl id del layout que se dibuja primero (la raíz).
LayoutUna regla que coloca ranuras: cuadrícula, filas, páginas, área desplazable, marcos o capas.
ItemLa descripción de una ranura: objeto, nombre, lore, posición, permisos y acciones de clic.
InteractionLo que ocurre con un tipo de clic: comandos, triggers, cerrar o volver atrás.
SessionEl estado de un menú abierto para un jugador: historial, página actual, posición de desplazamiento y vista activa.
ViewportLa parte de un layout desplazable que está visible en ese momento.

Orden de construcción​

  1. Crea la entrada Open GUI y elige guiType, size y title.
  2. Añade un layout simple con un id y escribe ese id en mainLayoutId.
  3. Añade primero los items decorativos (bordes, fondos) y después los botones.
  4. Añade entradas interactionList a los botones.
  5. Solo entonces añade frame, scrollable, paginated o views.

Repetición de ranuras​

count, direction, gap y repeatY repiten un item. Un solo item con count 9 y direction right llena una fila. Estos campos colocan ranuras; nunca cambian el tamaño de la pila del objeto. gap es un paso: 1 coloca ranuras adyacentes y 2 deja una ranura vacía entre copias. Sin direction, los tres campos se ignoran y se coloca una sola ranura.

Las ranuras que quedarían fuera de la cuadrícula se descartan y se listan en la consola con el id del layout y las coordenadas.

Visibilidad y clics​

  • criteria oculta la ranura a los jugadores que no la cumplen.
  • viewPermission oculta la ranura a los jugadores sin el permiso.
  • clickPermission dibuja la ranura pero la deja inerte.
  • allowPickup permite al jugador sacar el objeto del menú; está desactivado por defecto.

Todos son opcionales, y un permiso en blanco no restringe nada.

Abrir, volver y cerrar​

  • Cualquier entrada que pueda activar una acción puede lanzar el Open GUI.
  • executeReturn en una interacción vuelve al menú anterior de la sesión.
  • closeMenu en una interacción cierra la ventana.
  • Cerrar con Escape termina la sesión.

Siguientes pasos​