Contenido generado con IA — puede contener errores.

ExyliaChatCosmetics/El catálogoActualizada en v1.3.0

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.

Página 4 de 305 min de lectura

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.

yaml
tags:
  mvp:
    category: premium
    name: '{primary}&lMVP'
    icon: GOLD_INGOT
    description: 'Reservada para los {highlight}mejores jugadores.'
    priority: 1

Un archivo por tipo#

TipoArchivoSecciónSe lleva
Etiquetatags.ymltagsuna
Color de nicknick-colors.ymlnick_colorsuno
Color de rangorank-colors.ymlrank_colorsuno
Color de chatchat-colors.ymlchat_colorsuno
Color de sombrashadow-colors.ymlshadow_colorsuno
Fuentefonts.ymlfontsuna
Modificadormodifiers.ymlmodifiersvarios 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:mvp se lo da a un jugador de prueba (la forma siempre es tipo: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.

yaml
categories:
  premium:
    name: '{primary}&lPREMIUM'
    icon: NETHER_STAR
    priority: 7

Una 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:

EscritoSignifica
#8a51c4, &#8a51c4, 8a51c4un color
gold, dark_aquauno de los dieciséis colores con nombre
{primary}, {accent}, {highlight}un token de paleta que sigue tus colores
#a:#b, #a:#b:#cun 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 draw

Si 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
ClavePor defectoSignifica
categoryotherla pestaña donde vive
nameel idcómo lo llama el menú
iconNAME_TAGel objeto del menú; también vale material:
descriptionningunauna línea o una lista; también vale lore:
priority999orden dentro de la pestaña, de menor a mayor; el empate se resuelve por id
permissiontruesi exyliachatcosmetics.<tipo>.<id> lo da
requirementningunose lee, pero nada lo evalúa: no cuentes con ello
hiddenfalselo saca del menú; una concesión lo sigue equipando
metadataningunopares 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.

ProblemaQué pasa
Falta un campo imprescindibleesa entrada se salta, el resto carga
La entrada no es una sección o su id queda vacíoigual
Nombra una categoría sin declararse carga, pero ninguna pestaña la lista
Falta categoriesel archivo carga sin pestañas
Falta la sección de entradasel 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