Pantallas
Escribir un menú a pantalla completa en HTML y CSS: el elemento screen, las etiquetas, el estado y dónde está la referencia completa.
Una pantalla es un archivo HTML en plugins/ExyliaScreens/screens/. Se dibuja delante del jugador con cursor de ratón y sin resource pack. El cliente debe ser Java 1.20.2 o superior y el servidor
necesita PacketEvents; para el resto, escribe una alternativa.
Guarda una pantalla y se muestra en dos segundos. /screensadmin check lista lo que no entiende, con la línea y la columna.
El marcado, el subconjunto de CSS, las expresiones, los componentes, el movimiento y las imágenes son de ExyliaLib (su docs/screens.md, screens-markup.md y screens-cookbook.md). Esta página
cubre lo que necesita un servidor para construir menús sin Java. /exylialib screens gallery muestra cada elemento en el juego.
La pantalla más pequeña
<screen command="rules" aliases="r">
<panel>
<h1>{primary}Reglas</h1>
<p>Sé amable. Sin trampas. Diviértete.</p>
<button action="close">Entendido</button>
</panel>
</screen>El elemento <screen>
| Atributo | Qué hace |
|---|---|
command, aliases | Los comandos que la abren, instalados al cargar y con /screensadmin reload. Los alias se separan con espacios. |
permission | Quién puede abrirla; sin él, todos. |
require, deny | Una expresión que se comprueba antes de abrir, y las líneas que se ejecutan cuando falla. |
fallback, min-client, args, on-open | Consulta Apertura y alternativas. |
size, backdrop, scene, keys="navigate", wheel | De ExyliaLib: tamaño en píxeles (400x225), fondo, imagen, foco de teclado, rueda del ratón. |
Etiquetas que más usarás
Estas son las principales; ExyliaLib tiene la lista completa.
| Etiqueta | Qué hace |
|---|---|
panel, column, row, box | Cajas. panel es una columna con tema, row va en horizontal. |
h1, h2, b, small, p, span, text | Texto. |
button, card | Cajas con tema en las que se puede hacer clic. card suele ser una celda de cuadrícula. |
tabs/tab, chips/chip | Opciones que fijan un valor de estado al hacer clic. |
grid, list, pager | Repiten hijos sobre una fuente, con páginas. |
item | Un modelo de objeto real sin resource pack: material, head, texture o url. |
img | Una imagen de la carpeta del marcado, o skin="%player_name%" / face="%player_name%" para un jugador. |
toggle, progress, modal, search | Interruptor, una barra, un diálogo y un campo de búsqueda. |
Cualquier etiqueta admite id, class, style, if/else, action, action-right, action-shift, require/deny, cooldown y t="clave". %placeholder% y ${expresión} funcionan en cualquier texto. Los
colores son tokens de la paleta como {primary}, así que colors.yml lo recolorea todo.
Estado
set tab food, toggle open y clear tab cambian el estado propio de la pantalla, que se lee como %tab% o tab en las expresiones. <tabs state="tab" default="play"> y <chips> lo fijan al
hacer clic. open shop tab=food abre otra pantalla con ese estado ya puesto.
Los ejemplos
Se incluyen seis pantallas listas para usar: un selector de servidores, recompensas diarias, un tour de bienvenida, un hub, un perfil y una tienda. Muestran contadores de servidor en directo, rachas por jugador con una espera diaria, páginas, precios que cambian cuando el jugador no puede pagar, diálogos de confirmación, enlaces entre pantallas y todos los tipos de movimiento. Consulta Pantallas de ejemplo y léelas antes de escribir las tuyas.
¿Falta algo en esta página? Dínoslo en Discord