Menús

Apertura y alternativas

Cómo se abre cada forma, las claves que comparten, límites de cliente, alternativas como enlaces y todas las maneras de abrir un menú.

Las tres formas se abren igual, con las mismas claves.

Atributo de pantalla	Clave de cofre, o clave 3D bajo `menu:`	Qué hace
`command`, `aliases`	`command`, `aliases` (una lista)	Los comandos que lo abren, instalados al cargar y con `/screensadmin reload`.
`permission`	`permission`	Quién puede abrirlo. Sin él, todos.
`require`, `deny`	`require`, `deny`	Una expresión que se comprueba antes de abrir, y las líneas que se ejecutan cuando falla. Sin `deny`, el jugador recibe un mensaje de falta de permiso.
`fallback`	`fallback`	El id del menú que recibe un cliente que no puede dibujar este.
`min-client`	`min-client`	El cliente más antiguo que recibe este menú (`1.21.4`); los más viejos usan la alternativa.
`args`	`args` (una lista)	Las palabras después del comando, por nombre.
`on-open`	`on-open`	Líneas de interacción que se ejecutan al abrir.

Argumentos

args="player" hace que /stats Bob rellene %player% en un menú de cofre o 3D y ${player} en una pantalla. Un argumento son letras, dígitos y _.:-, hasta 64 caracteres; cualquier otra cosa, o faltar palabras, responde con la línea de uso. Los comandos son solo para jugadores.

Las alternativas son enlaces, nunca copias

hub.html con fallback="hub_chest" se abre como pantalla, y un cliente que no puede dibujar pantallas recibe menus/hub_chest.yml, que escribiste tú. El plugin nunca crea uno por ti.

Una alternativa puede tener la suya: hub_3d va a hub, que va a hub_chest.
Un menú sin alternativa le dice a ese cliente que no funciona allí.
Un menú de cofre lo dibuja cualquier cliente, así que su fallback nunca se usa.
Un jugador que eligió ventanas de cofre en /settings también recibe la alternativa de una pantalla o menú 3D que la tenga, salvo que pongas follow-player-style: false en config.yml. Un menú sin alternativa se abre igualmente.
/screensadmin check nombra una alternativa que no existe o que forma un círculo.

Qué clientes dibujan qué: las pantallas necesitan Java 1.20.2 o superior (no Bedrock), los menús 3D Java 1.21.4 o superior, y min-client puede subir cualquiera de los dos. Los importadores escriben el menú de cofre y lo enlazan por ti; es la única vez que se crea una alternativa, y es la salida del importador, no un comportamiento automático.

Maneras de abrir un menú

Desde	Cómo
Un comando	El `command` y los `aliases` del menú.
Una pantalla	`action="open shop"`, u `open shop tab=food` para fijar su estado.
Un clic de cofre o 3D, un holograma, un NPC, un bloque clicable	Cualquier línea de interacción de ExyliaLib: `[SCREEN] shop`.
Acciones de otro plugin	`exyliascreens:open shop`.
Al entrar	`open-on-join: hub` en `config.yml`, tras `open-on-join-delay` ticks.
Un objeto en la mano	`open-items.yml`.
El staff	`/screensadmin open shop <jugador>`.

Abrir pasa siempre por el permiso y el requisito del menú, sea cual sea el camino por el que se llegó.

¿Falta algo en esta página? Dínoslo en Discord