Contenido generado con IA — puede contener errores.

Personaliza los menús

Cambia lo que ven los jugadores en los menús de cosméticos: edita un archivo de menú, recarga y compruébalo en el juego. Referencia de cada archivo, acción y valor.

Página 10 de 3016 min de lectura

Cambia lo que muestran los menús de cosméticos editando sus archivos en lang/<idioma>/menus/ y recargando.

Antes de empezar#

Necesitas el permiso exyliachatcosmetics.admin y acceso a los archivos del servidor. Los archivos de menú son menús de ExyliaLib, así que la gramática se explica una vez en ExyliaLib: Menús y los colores en Colores.

Edita un menú#

Abre el archivo

Ve a plugins/ExyliaChatCosmetics/lang/<idioma>/menus/ y abre el archivo de la pantalla que quieras, por ejemplo main.yml para /cc. La tabla de la referencia de abajo dice qué archivo es cada uno.

Cambia el ítem

Edita el name, el lore o el material del ítem. Usa tokens de paleta como {primary} en lugar de colores fijos para que la pantalla siga tus ajustes de color.

Recarga

Ejecuta /cca reload. Los menús abiertos recogen el cambio la próxima vez que se abran.

Comprueba que funciona#

Ejecuta /cc y abre la pantalla que editaste. Si el archivo tiene un error, el menú conserva su diseño anterior y la consola dice por qué.

Para ir más lejos#

  • Las palabras de las filas, como la línea de estado y la de la estrella, están en messages.yml bajo menu.*, no en el archivo de menú.
  • Con el estilo SCREEN de ExyliaLib, /cc abre una app con barra lateral. Edita lang/<idioma>/screens/main.yml para sus textos, pon tus reglas en custom.css y ejecuta /exylialib screens check para listar errores.
  • Los ajustes se abren desde la tarjeta de ajustes de /cca menu. Los números se escriben, los interruptores cambian con un clic y el clic derecho con mayúsculas restablece el valor.
Archivos de menú, acciones y valores

Todas las pantallas que ve un jugador son menús de ExyliaLib, un archivo cada una bajo plugins/ExyliaChatCosmetics/lang/<idioma>/menus/, en el idioma del plugin. Se escriben en el primer arranque y después se refrescan a través de ExyliaLib: una clave que añade una versión llega a tu copia editada, un valor por defecto cambiado espera en /exylialib updates, y /cca reload levanta lo que cambiaste. Solo un archivo que viene con un menu-version más alto sustituye a tu copia, para un arreglo que no puede esperar.

La gramática vive en ExyliaLib

Plantillas, secciones, rellenos, condition, depends-on, refresh, sonidos, navegación y los tokens de paleta son todos de ExyliaLib, y aquí se comportan exactamente igual que en cualquier otro sitio. Ver ExyliaLib — Menús. Esta página solo lista lo que estos archivos pueden decir y ningún otro menú puede.

Los archivos de jugador#

ArchivoTamañoSe abre desdeContiene
main.yml27/cc, chatcosmetics:open mainpreview, identity, message, favorites, loadouts, presets, collection, unequip
identity.yml27chatcosmetics:open identitypreview, tags, nick, rank, back
message.yml27chatcosmetics:open messagepreview, colors, fonts, modifiers, back
browser.yml54chatcosmetics:browse <type>, /cc tags, /tags, /nickcolors …las secciones categories y cosmetics, más create, custom, shadow, preview, unequip, back
favorites.yml54chatcosmetics:open favorites, /cc favoritesla sección cosmetics, más preview, unequip, back
loadouts.yml45chatcosmetics:open loadouts, /cc loadoutsla sección loadouts, más preview, save, unequip, back
presets.yml45chatcosmetics:open presets, /cc presetsla sección presets, más preview, unequip, back

Las pantallas de staff van junto a estas — admin.yml (27, /cca menu), admin_players.yml (54), admin_player.yml (45), admin_history.yml (54), admin_grants.yml (54), admin_tokens.yml (36), admin_filter.yml (45) y admin_announcer.yml (54) — detrás de exyliachatcosmetics.admin. admin_player.yml es la ficha de un jugador: su situación en el chat y las puertas a su historial de chat, sus concesiones (cada una se revoca con un clic, tras confirmar) y sus saldos de tokens (se dan, se quitan o se fijan desde la pantalla). /cca list <player> y /cca chat history <player> abren esas páginas directamente; las de concesiones y tokens funcionan con el módulo de chat apagado.

No hay un archivo aparte para lo que hacen los jugadores. Los colores de nick que un jugador mezcló viven en un botón del navegador de colores de nick, y no en una pantalla propia — ver Lo que hizo el jugador.

Las pantallas de ajustes#

La tarjeta SETTINGS de admin.yml (chatcosmetics:admin_settings) abre un hub de páginas hechas a mano, una por tema: admin_settings_modules.yml, _cosmetics.yml, _features.yml, _commands.yml, _moderation.yml y _filter.yml. Cada tarjeta muestra qué hace un valor, su valor actual y el de por defecto; los números y las duraciones se escriben, los interruptores se cambian con un clic, y un clic derecho con shift restablece el valor. Las listas de defaults también se editan aquí. Las acciones son settings_hub, settings_page <id> y setting <page> <key>, todas tras exyliachatcosmetics.admin.

El estilo de pantalla#

Con el estilo de menú SCREEN de ExyliaLib, /cc abre una sola app con barra lateral en vez de los menús de cofre. Sustituye a main, identity, message, browser, favorites, loadouts y presets, y lee los mismos valores y filas. Es screens/main.html con screens/theme.css; sus textos están en lang/<idioma>/screens/main.yml, y tus propias reglas van en un custom.css junto al tema para que los archivos que vienen sigan actualizándose. /exylialib screens check lista lo que falle de un archivo, con línea y columna. Un archivo roto por una edición conserva su menú de cofre y lo explica en la consola.

Las acciones#

Todos los botones de estos archivos ejecutan chatcosmetics:<name> [argumento]. Las propias de ExyliaLib — back, close, next_page y previous_page — funcionan aquí como en todas partes.

AcciónHace
open <main|identity|message|favorites|loadouts|presets>abre una pantalla fija; cualquier otra cosa abre main
browse <type>abre browser.yml en ese tipo
category <id>cambia la pestaña del navegador desde el que se hizo clic
filteralterna el navegador o los favoritos entre todos los cosméticos y solo los que posee el jugador; se recuerda entre aperturas
equip <type:id>se lo pone — o se lo quita, si es un tipo de uno solo y ya lo lleva
favorite <type:id>marca o desmarca con estrella
preview <type:id>envía en el chat la línea que produciría ese cosmético
edit <type:id>vuelve a hacer las preguntas de una fila que hizo el jugador; se ignora en una fila del catálogo
delete <type:id>borra una fila que hizo el jugador; se ignora en una del catálogo
create <type>hace las preguntas que escriben uno nuevo
unequip <type>quita todo lo de un tipo
clearquita todos los tipos de una vez
loadout_apply <id>, loadout_overwrite <id>, loadout_delete <id>un look guardado
loadout_savepide un nombre y guarda lo que lleva puesto

Un verbo que cambia el perfil actúa sobre el jugador, no sobre la ventana: todas las pantallas abiertas que muestran ese perfil las redibuja el store. Solo category actúa sobre la ventana desde la que se hizo clic.

Sin botón de cerrar, y dónde va back#

Ninguna de las seis pantallas lleva botón de cerrar. Un jugador cierra esta ventana igual que cierra todas las demás, y un hueco gastado en decirlo es un hueco que podría haber tenido un cosmético.

back va en el centro de la fila de abajo en todas las pantallas que lo tienen — el hueco size - 5, o sea 22 en las de 27, 40 en loadouts.yml y 49 en las dos de 54. main.yml no tiene back, porque no hay nada por encima.

Los dos navegadores paginados llevan parent: "main", que es adónde va su back cuando al jugador lo mandó ahí directamente /tags o /nickcolors en vez de la puerta principal.

Quitarse cosas#

Un menú que solo sabe poner no tiene forma de decir "nada de esto". Dos acciones sí:

AcciónHaceDónde viene
chatcosmetics:unequip <type>quita todo lo de un tipoQuitar en el navegador (hueco 53), y clic derecho sobre un tipo en identity.yml / message.yml
chatcosmetics:clearquita todos los tipos de una vezQuitarlo todo en main.yml (26), favorites.yml (53) y loadouts.yml (43)

Los dos botones llevan condition: "%equipped_any% == true", así que solo se dibujan cuando hay algo que quitar; si no, el hueco cae en el relleno.

%equipped_any% es el jugador entero en todas las pantallas — y solo ese tipo dentro de un navegador, donde un botón de quitar habla del tipo que está en pantalla. Para preguntar por un tipo en cualquier sitio, %<type>_worn% dice lo mismo.

Hacer clic en un cosmético que ya se lleva también lo quita, pero solo en los tipos que se llevan de uno en uno. Los modificadores se llevan en conjunto, así que el botón es la única forma de no llevar ninguno.

browser.yml#

Un solo archivo dibuja el navegador de todos los tipos; el título toma %type_name%, que sale de menu.types en messages.yml. El título no lleva contador de páginas a propósito: una pantalla con dos listas no tiene una sola página que la librería pueda contar.

Valores que pueden leer los ítems fijos:

ValorEs
%type%el tipo en pantalla
%type_name%cómo lo llama menu.types
%type_custom%true cuando Crear uno escribiría algo aquí
%owned_count%cuántos de este tipo posee este jugador
%total_count%cuántos de este tipo hay
%equipped_name%el nombre de lo que lleva de este tipo
%equipped_any%true cuando lleva algo de este tipo
%custom_type%el tipo que escribe Crear uno
%create_tokens%el saldo de creación de ese tipo — ver Tokens
%edit_tokens%el saldo de edición de ese tipo
%preview%la línea de chat completa del jugador tal como está ahora

%preview% va en un ítem con depends-on: [preview], que es lo que hace que se redibuje después de cada clic y no solo con el temporizador.

Las pestañas#

La sección categories ocupa los huecos 2–6, con flechas propias en el 1 y el 7 cuando un tipo tiene más pestañas de las que caben. Toma dos plantillas — item_template para una pestaña y open_template para aquella en la que está el jugador — y lee %category_id%, %category_name%, %category_icon%, %category_total% y %category_owned%. Su clic es chatcosmetics:category %category_id%. Un tipo sin categorías se salta la fila entera.

La pestaña en la que el jugador dejó un tipo se recuerda, así que el navegador se reabre donde estaba.

La rejilla#

La sección cosmetics es una rejilla de 4×7 en los huecos 10-16,19-25,28-34,37-43, con flechas de página en el 48 y el 50. Toma una plantilla por estado, y la que falte cae en item_template:

PlantillaSe dibuja para
item_templateposeído, sin llevar puesto, sin reloj encima
selected_templatepuesto ahora mismo
expiring_templateposeído, pero solo hasta que caduque una concesión
locked_templateno poseído

Las filas bloqueadas se ordenan al final, para que lo que un jugador puede ponerse esté donde va a mirar y no detrás de una página de lo que no puede.

Valor de filaEs
%cosmetic_key%la clave entera de la fila, tipo:id
%cosmetic_id%el id de la fila a secas
%cosmetic_type%el id del tipo de la fila
%cosmetic_type_name%cómo llama menu.types a ese tipo
%cosmetic_name%el nombre de la entrada, del catálogo
%cosmetic_description%la descripción de la entrada, del catálogo
%cosmetic_icon%el material de la entrada; material: "%cosmetic_icon%" dibuja el ícono de la propia entrada
%cosmetic_status%una de las cuatro líneas de menu.status
%cosmetic_favorite%menu.favorite-on o menu.favorite-off
%cosmetic_expires%lo que queda de una concesión temporal
%cosmetic_sample%la línea de chat entera dibujada como si llevara este puesto
%cosmetic_manage%los avisos de cambiar y borrar (menu.custom-hints) en una fila que hizo el jugador, y una línea en blanco en todas las demás

%cosmetic_sample% es una línea entera y no una muestra suelta a propósito: un color se juzga mejor al lado de la etiqueta y del nombre con los que va a convivir, y un solo renderizador que responde por todos los tipos no puede desviarse de lo que dibuja el chat de verdad.

%cosmetic_manage% es un valor de fila y no líneas de lore porque un solo archivo dibuja todos los tipos. Una fila del catálogo lo expande a la línea en blanco que la maquetación quería ahí de todas formas, en vez de prometer dos clics que no harían nada.

Lo que hizo el jugador#

Un tipo que un jugador puede escribirse lo nombra el tipo con el que se empareja — tag responde customtag, nick_color responde customnick, chat_color responde customcolor, rank_color responde customrank. La pareja recibe un botón, custom en el hueco 46, que cambia la rejilla a lo que hizo ese jugador, y vuelve a la primera pestaña del catálogo con un segundo clic.

Un hueco propio en vez de una pestaña: un tipo del que nadie ha hecho nada le quitaría una pestaña a las del catálogo, y así el botón se lee igual en todos los navegadores. Sus valores son

ValorEs
%custom_state%none cuando este tipo no se empareja con nada o no tiene pestañas de catálogo a las que volver; si no, closed u open
%custom_glow%true mientras la lista está abierta
%custom_toggle%a qué cambia un clic — la lista propia, o la primera pestaña del catálogo
%custom_name%cómo se llama el tipo emparejado
%custom_icon%el material con el que se dibuja el tipo emparejado
%custom_count%cuántos ha hecho este jugador

Un valor en vez de dos banderas, porque un condition en un archivo de menú es una sola comparación: "hay uno, y está abierto" tiene que poder decirse en una palabra. El archivo que viene incluido esconde el botón con condition: "%custom_state% != none".

Crear uno, el ítem create del hueco 45, lleva condition: "%type_custom% == true" y ejecuta chatcosmetics:create %custom_type%. Se dibuja en el navegador de un tipo que hace el jugador, y en uno del catálogo solo mientras la lista propia está abierta — o sea, aparece exactamente donde escribir uno tendría sentido.

Un jugador que busca un color para su nombre busca un color para su nombre; si lo escribió el servidor o lo escribió él es un clic, no una pantalla.

favorites.yml#

El navegador y esta pantalla llevan un botón Filtro en el hueco 51. Lista solo los cosméticos que posee el jugador, en todas las pestañas, y un segundo clic vuelve a listar todo. %filter_status% trae su línea (menu.filter-all, menu.filter-owned), y una lista que el filtro deja vacía muestra none_owned_template en vez de parecer rota.

Todos los cosméticos marcados de todos los tipos, en el orden en el que el jugador los marcó, en una rejilla de 5×7 en los huecos 1-7,10-16,19-25,28-34,37-43. Las mismas cuatro plantillas de estado y los mismos valores de fila que el navegador, y %cosmetic_type_name% se gana su sitio aquí porque las filas son de tipos mezclados.

Marcar con estrella no exige poseerlo — un favorito es tanto una lista de deseos como una lista corta — así que aquí puede haber una fila bloqueada, y su plantilla lo dice. No se ordena nada: el orden de las estrellas es el orden.

loadouts.yml#

La sección loadouts ocupa los huecos 10-16,19-25 y toma dos plantillas, item_template y active_template para el que se lleva puesto. Lee %loadout_id%, %loadout_name% y %loadout_slots% — lo que contiene el loadout, por nombre, un tipo por línea — y sus clics son chatcosmetics:loadout_apply, loadout_overwrite y loadout_delete con %loadout_id%.

Guardar este look, en el hueco 37, ejecuta chatcosmetics:loadout_save, que pide un nombre. El relleno de paginación es donde a un jugador sin loadouts se le explica cómo hacer el primero.

%loadout_count%, %loadout_limit% y %active_loadout% se pueden leer en cualquier parte de la pantalla.

Valores que tienen todas las pantallas#

Además de %preview%, los seis archivos pueden leer %equipped_summary% (cada tipo y qué lleva de él), %equipped_any%, %owned_count%, %favorites_count%, %loadout_count%, %loadout_limit% y %active_loadout%.

Por tipo, en cualquier sitio: %<type>_owned%, %<type>_total%, %<type>_equipped% y %<type>_worn% — para que un botón que lleva a algún lado pueda decir qué hay detrás. Una pantalla de casillas que dicen todas la misma frase es una pantalla que nadie lee de un vistazo. Los tipos que hace el jugador llevan además %<type>_create_tokens% y %<type>_edit_tokens%.

Cuando un tipo no tiene nada puesto, %<type>_equipped% y %equipped_summary% caen en menu.none. Un tipo puesto solo porque el servidor se lo da al rango muestra el nombre seguido de menu.default-marker, y cuenta como puesto.

Cambiar el estilo#

  • Los colores son tokens de paleta ({primary}, {letters}, {letters_black}, {muted}, {success}, {warning}, {error}). Recolorea el servidor entero desde el colors.yml de ExyliaLib, no desde aquí.
  • Renombra una plantilla solo junto con la lista de estados de arriba; una plantilla de estado que falta cae en item_template en vez de fallar.
  • Los valores de fila que traen formato — %cosmetic_name%, %cosmetic_sample%, %cosmetic_status%, %preview%, %equipped_summary% — se insertan ya con su estilo; los ids y las claves son literales. Un color suelto no puede ser un valor, así que dale estilo a la frase entera en la plantilla.
  • Las palabras de la línea de estado de una fila, de su línea de estrella y de los avisos de cambiar y borrar son menu.status, menu.favorite-on / menu.favorite-off y menu.custom-hints en messages.yml, no texto del archivo de menú. menu.sample-message es la frase con la que se dibujan todas las vistas previas.
  • refresh: { mode: SMART } redibuja solo lo que puede cambiar. Un menú abierto también se redibuja cuando cambia el perfil — llega una concesión, se acaba un rango — y una vez por fotograma de animación, para que un color animado se mueva en pantalla. Cada cuánto es eso lo decide animations.tick en config.yml: la misma perilla que decide cuán suave es una animación en el chat decide lo que cuesta mantener un menú abierto en movimiento.

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