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.
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.ymlbajomenu.*, no en el archivo de menú. - Con el estilo SCREEN de ExyliaLib,
/ccabre una app con barra lateral. Editalang/<idioma>/screens/main.ymlpara sus textos, pon tus reglas encustom.cssy ejecuta/exylialib screens checkpara 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.
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#
| Archivo | Tamaño | Se abre desde | Contiene |
|---|---|---|---|
main.yml | 27 | /cc, chatcosmetics:open main | preview, identity, message, favorites, loadouts, presets, collection, unequip |
identity.yml | 27 | chatcosmetics:open identity | preview, tags, nick, rank, back |
message.yml | 27 | chatcosmetics:open message | preview, colors, fonts, modifiers, back |
browser.yml | 54 | chatcosmetics:browse <type>, /cc tags, /tags, /nickcolors … | las secciones categories y cosmetics, más create, custom, shadow, preview, unequip, back |
favorites.yml | 54 | chatcosmetics:open favorites, /cc favorites | la sección cosmetics, más preview, unequip, back |
loadouts.yml | 45 | chatcosmetics:open loadouts, /cc loadouts | la sección loadouts, más preview, save, unequip, back |
presets.yml | 45 | chatcosmetics:open presets, /cc presets | la 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ón | Hace |
|---|---|
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 |
filter | alterna 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 |
clear | quita todos los tipos de una vez |
loadout_apply <id>, loadout_overwrite <id>, loadout_delete <id> | un look guardado |
loadout_save | pide 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ón | Hace | Dónde viene |
|---|---|---|
chatcosmetics:unequip <type> | quita todo lo de un tipo | Quitar en el navegador (hueco 53), y clic derecho sobre un tipo en identity.yml / message.yml |
chatcosmetics:clear | quita todos los tipos de una vez | Quitarlo 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:
| Valor | Es |
|---|---|
%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:
| Plantilla | Se dibuja para |
|---|---|
item_template | poseído, sin llevar puesto, sin reloj encima |
selected_template | puesto ahora mismo |
expiring_template | poseído, pero solo hasta que caduque una concesión |
locked_template | no 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 fila | Es |
|---|---|
%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
| Valor | Es |
|---|---|
%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 elcolors.ymlde 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_templateen 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-offymenu.custom-hintsenmessages.yml, no texto del archivo de menú.menu.sample-messagees 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 decideanimations.tickenconfig.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