Edita el catálogo de cosméticos
Añade, cambia, oculta o quita cosméticos en los archivos YAML: un archivo por tipo, los campos que comparten todas las entradas, los colores y qué pasa cuando una entrada está mal.
Cada etiqueta, color, fuente y modificador que un jugador puede ponerse es una entrada en un archivo YAML. Editas el archivo, ejecutas /cca reload y el menú muestra el cambio sin reiniciar.
Antes de empezar#
Necesitas poder editar archivos en plugins/ExyliaChatCosmetics/. Los archivos que editas están en la carpeta de tu idioma, lang/<idioma>/cosmetics/ (por ejemplo lang/es/cosmetics/tags.yml), porque los nombres y descripciones son texto que leen los jugadores. Tu idioma es la clave language del config.yml del plugin, mira Idiomas.
Añade o cambia un cosmético#
Abre el archivo de su tipo
Elígelo en la tabla de abajo. Una etiqueta va en lang/<idioma>/cosmetics/tags.yml.
Copia una entrada
Copia una entrada existente bajo la sección del tipo (tags: para etiquetas), ponle un id nuevo y cambia name, category y lo que dibuja.
Recarga
Ejecuta /cca reload. Los jugadores siguen conectados y conservan lo que llevan.
Búscalo
Ejecuta /cc tags (o el menú de ese tipo). Tu entrada está en su pestaña.
tags:
mvp:
category: premium
name: '{primary}&lMVP'
icon: GOLD_INGOT
description: 'Reservada para los {highlight}mejores jugadores.'
priority: 1Un archivo por tipo#
| Tipo | Archivo | Sección | Se lleva |
|---|---|---|---|
| Etiqueta | tags.yml | tags | una |
| Color de nick | nick-colors.yml | nick_colors | uno |
| Color de rango | rank-colors.yml | rank_colors | uno |
| Color de chat | chat-colors.yml | chat_colors | uno |
| Color de sombra | shadow-colors.yml | shadow_colors | uno |
| Fuente | fonts.yml | fonts | una |
| Modificador | modifiers.yml | modifiers | varios a la vez |
animations.yml está en la misma carpeta pero no es un tipo: es la biblioteca de movimiento que cualquier entrada nombra con animation:, mira Animaciones. Los cuatro tipos custom no tienen archivo, los escriben los jugadores, mira Cosméticos personalizados. Los preajustes tienen su propio archivo, presets.yml.
Comprueba que funciona#
- El cosmético aparece en su pestaña del menú.
- Tras
/cca reload, la consola no muestra ninguna línea con el nombre de tu archivo. Un problema es una línea con el archivo, la entrada y el campo. /cca give <jugador> tag:mvpse lo da a un jugador de prueba (la forma siempre estipo:id).
Ir más lejos#
Pestañas#
Todo archivo empieza con una sección categories. Cada entrada es una pestaña del menú y priority es el orden, de menor a mayor. Borra una pestaña y el menú se redibuja con el resto.
categories:
premium:
name: '{primary}&lPREMIUM'
icon: NETHER_STAR
priority: 7Una entrada que nombra una pestaña que nadie declaró se carga igualmente y un comando puede darla, pero ninguna pestaña la lista y la consola lo avisa.
Oculta un cosmético#
Pon hidden: true. Sale del menú, pero una concesión sigue equipándolo. Úsalo para premios que solo das con /cca give.
De pago o gratis#
Por defecto un jugador posee una entrada si tiene el permiso exyliachatcosmetics.<tipo>.<id> o una concesión. Pon permission: false y solo la poseen las concesiones. Los colores de rango son la excepción: su valor por defecto también es permission: true, y lo que lo hace gratis es permission: false sin groups, mira Colores. Poseer, caducidad y permisos están en Concesiones.
Escribe colores#
Donde se escriba un color (color:, un tramo dentro de gradient:) vale cualquiera de estos:
| Escrito | Significa |
|---|---|
#8a51c4, a51c4, 8a51c4 | un color |
gold, dark_aqua | uno de los dieciséis colores con nombre |
{primary}, {accent}, {highlight} | un token de paleta que sigue tus colores |
#a:#b, #a:#b:#c | un degradado por dos o más colores |
Un token de paleta sigue a tu servidor: cambia la paleta, recarga y todo cosmético escrito con él cambia. Un hash necesita exactamente seis dígitos. shadow-colors.yml también acepta #rrggbbaa, auto y none, mira Colores.
Cuando una entrada está mal#
No se lanza ningún error. La entrada se salta y la consola indica el archivo, la entrada y el campo, así una errata no cuesta las demás entradas:
cosmetics/tags.yml tags.mvp.display: is missing, so there is nothing to drawSi un cosmético que acabas de escribir no está en el menú, el motivo es una línea en la consola tras /cca reload.
Campos que comparten todas las entradas
| Clave | Por defecto | Significa |
|---|---|---|
category | other | la pestaña donde vive |
name | el id | cómo lo llama el menú |
icon | NAME_TAG | el objeto del menú; también vale material: |
description | ninguna | una línea o una lista; también vale lore: |
priority | 999 | orden dentro de la pestaña, de menor a mayor; el empate se resuelve por id |
permission | true | si exyliachatcosmetics.<tipo>.<id> lo da |
requirement | ninguno | se lee, pero nada lo evalúa: no cuentes con ello |
hidden | false | lo saca del menú; una concesión lo sigue equipando |
metadata | ninguno | pares clave: valor libres que otro plugin puede leer |
name y description aceptan tokens de paleta, códigos & y MiniMessage. Además, cada tipo añade sus claves: display y head en una etiqueta, color o gradient en un color, alphabet en una fuente, decoration en un modificador.
Un id se recorta, se pasa a minúsculas, los espacios pasan a guion bajo y lo que no sea a-z, 0-9, _ o - se elimina, así que MVP y mvp son lo mismo. El id none está reservado. En comandos, concesiones y placeholders un cosmético es siempre tipo:id, como tag:mvp.
| Problema | Qué pasa |
|---|---|
| Falta un campo imprescindible | esa entrada se salta, el resto carga |
| La entrada no es una sección o su id queda vacío | igual |
| Nombra una categoría sin declarar | se carga, pero ninguna pestaña la lista |
Falta categories | el archivo carga sin pestañas |
| Falta la sección de entradas | el servidor no tiene nada de ese tipo |
El catálogo de un tipo se reemplaza entero al recargar, así que un menú nunca muestra medio archivo.
¿Falta algo en esta página? Dínoslo en Discord