Menús

Vienen ciento dieciocho archivos de menú, en dos sitios que se comportan de forma completamente distinta.

Un archivo malformado se nombra en el log y se deja sin registrar, en vez de cargarse vacío en silencio.

Cómo se mantienen al día tus menús

Cada carpeta de menús tuyos se refresca al arrancar y en cada recarga, antes de leer los menús. Para cada archivo el plugin compara tres cosas: lo que hay en disco, lo que viene esta vez y los valores por defecto que tenías la última vez, que guarda en .defaults/files/ dentro de la carpeta del plugin.

• Un archivo que falta se escribe.
• Una clave que añade una versión se escribe en tu archivo al momento, comentarios incluidos. Nadie puede haber elegido algo que todavía no existía.
• Un valor por defecto que cambia en una clave que nunca tocaste no se aplica. Espera en /exylialib updates, donde lo aplicas o te quedas con lo que tienes.
• Lo que hayas cambiado o borrado no se toca nunca.

En un servidor que ya tenía los archivos antes de que existiera este seguimiento, cada valor que hay en disco cuenta como tuyo, y una clave que falta en un archivo se ofrece en /exylialib updates en vez de escribirse — puede ser una que borraste tú. Un archivo que no se puede leer se deja como está y se avisa.

Archivos que declaran una versión

Las veintiuna pantallas de protecciones y modules/player-settings/menus/settings.yml llevan menu-version: 4. Cuando una versión trae un número mayor que el del archivo en disco (un archivo sin la clave cuenta como 0), el archivo se sustituye entero, con tus cambios, y el anterior se guarda al lado como <nombre>.yml.v<versión anterior>. Eso queda para un cambio de diseño que un archivo viejo no puede aguantar.

Las cabeceras de modules/crates/menus/history.yml, modules/crates/menus/preview.yml, las tres pantallas de modules/economy/menus/ y menus/currency_select.yml siguen diciendo que se escriben una vez y nunca se sobrescriben. Tus cambios se conservan, pero las claves que añade una versión se escriben en ellos como se explica arriba.

La ventana de intercambio, modules/trade/window.yml, no es un archivo de menú — sus ranuras las fija el plugin — pero se mantiene al día de la misma forma. Consulta Intercambio y baúles.

Los menús de jugador

Estos son los que merece la pena estilizar.

Las pantallas de protecciones se explican en Protecciones.

Las pantallas de administración

Cuarenta y nueve archivos en menus/admin/, un flujo por módulo, alcanzables desde el comando de administración de ese módulo: minas con sus niveles, composición y cadenas de desgaste; cajas con sus premios, animación y pity; plantillas de cofre y cofres colocados; spawners de objetos y sus posiciones; zonas de power-up, sus entradas y sus posiciones; zonas de regeneración y su rejilla de flags; salas de duelo y sus flags; portales; plataformas de salto; zonas AFK; warps; kits; recompensas; recompensas por cabeza; categorías y productos de la tienda; monedas y los ajustes de economía; y actualizaciones de objetos.

Funcionan, y no deberías editarlas. El plugin sustituye la carpeta desde el jar para que un botón añadido en una versión llegue a servidores que ya la tienen.

Fuera de esa carpeta, modules/warps/menus/warp_setup.yml es el editor de warps, y modules/protections/menus/ guarda las pantallas de administración de protecciones — admin, admin_protection, tiers, tier y cleanup, a las que se llega desde /protections admin. Esas seis se conservan como cualquier menú tuyo. Consulta Administrar protecciones.

El esquema de archivo

Un archivo de menú es:

title: "…"
size: 54
type: PAGINATION
open_sounds: ["UI_BUTTON_CLICK|1.0|1.0"]
click_sounds: []
refresh: { mode: SMART, interval: 40 }
filler:
  global: { material: GRAY_STAINED_GLASS_PANE, name: " " }
  pagination: { material: BARRIER, name: "Nada aquí" }
pagination:
  slots: '10-16,19-25,28-34'
  item_template: { material: "%icon%", name: "%name%", lore: [], actions: ["survivalcore:…"] }
  navigation:
    previous: { slot: 45, material: ARROW }
    next:     { slot: 53, material: ARROW }
items:
  close: { slot: 49, material: BARRIER, name: "Cerrar", actions: ["survivalcore:close_menu"] }

Plantillas de estado

Una lista paginada puede dibujar una fila distinta según su estado. modules/kits/menus/list.yml tiene cuatro — item_template, cooldown_template, used_template, locked_template — y la sección de reclamo de la vista previa de kit tiene seis.

Acciones

La clave es siempre actions:, una lista de cadenas. El tipo de clic es un prefijo dentro de la cadena:

actions:
  - "left: survivalcore:mine_edit %mine_id%"
  - "right: survivalcore:mine_delete %mine_id%"
  - "shift_left: survivalcore:mine_set_weight %mine_id%"

left:, right:, middle:, shift_left:, shift_right: y drop: son los prefijos; sin prefijo vale cualquier clic. survivalcore:<nombre> es una de las trescientas treinta y siete acciones de este plugin; close, previous_page y next_page son de ExyliaLib.

Materiales

Un material de Bukkit, un placeholder (%kit_icon%), basehead-<base64>, playerhead-%name% o playerhead:%name%. Las dos formas de cabeza se usan en los archivos que vienen.

Acciones que merece la pena enlazar en otro sitio

El plugin registra 337 acciones bajo el espacio survivalcore:, y funcionan desde cualquier menú de ExyliaLib de cualquier plugin: un selector de hub, un NPC, un objeto de hotbar. Cada una no hace nada mientras su módulo está apagado. Las que más merece la pena conocer: