Contenido generado con IA — puede contener errores.

ExyliaChatCosmetics/El catálogoActualizada en v1.3.0

Etiquetas

Añade, edita y muestra la pequeña marca delante del nombre de un jugador: desde las 180 etiquetas incluidas hasta tus propios sprites y cabezas.

Página 5 de 305 min de lectura

Una etiqueta es una pequeña marca delante de un nombre, que el jugador elige en un menú. Ya tienes 180 en siete pestañas, y unas pocas líneas de YAML añaden las tuyas.

Una etiqueta no es un rango: el rango dice lo que alguien es, la etiqueta es algo que le gustó. Mantén cada una en un solo símbolo, sprite o cabeza, sin corchetes ni palabras.

Antes de empezar#

  • Las etiquetas salen en el chat solo si tu formato tiene una pieza {tag}. El default.yml incluido no la trae, así que mira primero Formatos.
  • Los sprites y <head:> necesitan un cliente de Minecraft 1.21.9. Los símbolos normales funcionan en todos.

Mostrar etiquetas en el chat#

Añade la pieza

Abre tu archivo de formato en lang/<idioma>/chat/formats/ y añade {tag} antes del nombre, como se explica en Formatos.

Recarga

Ejecuta /cca reload.

Equipa una

Ejecuta /cc tags, pulsa una etiqueta y escribe en el chat. La etiqueta aparece delante de tu nombre.

Añadir tu propia etiqueta#

Abre el archivo

Edita lang/<idioma>/cosmetics/tags.yml (en la carpeta de tu idioma).

Escribe la entrada

Copia el ejemplo de abajo, cambia el id (mvp) por uno nuevo y pon lo que se dibuja en display.

Recarga y prueba

Ejecuta /cca reload, luego /cca give <jugador> tag:mvp y abre /cc tags.

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

Una entrada necesita display o head. Sin ninguno, se avisa en la consola y se omite. Por defecto el jugador necesita el permiso exyliachatcosmetics.tag.item.<id> (o exyliachatcosmetics.tag.category.<categoría>) para tenerla, o se la das con /cca give. Con permission: false solo la tienen quienes reciban una concesión.

Comprobar que funciona#

  • /cc tags muestra tu etiqueta en su categoría.
  • Al equiparla, una línea del chat muestra la marca delante de tu nombre.
  • La consola no avisa de ningún problema; el aviso nombra el archivo y la clave que falla.

Las siete pestañas#

PestañaCantidadQué contiene
SÍMBOLOS24caracteres normales: corazones, estrellas, flechas
ANIMADO31sprites que el cliente anima solo
PARTÍCULAS24texturas de partículas, quietas
ICONOS24texturas de objetos y bloques
INTERFAZ20sprites del HUD: corazones, hambre, efectos
BANDERAS43banderas de países, cada una una skin de cabeza
PREMIUM14las que conviene dejar tras un permiso

Borra las pestañas que no quieras y el menú se redibuja con las que queden.

Dibujar sprites y cabezas#

Los caracteres normales son la opción segura. Lo de abajo necesita un cliente 1.21.9; uno más antiguo muestra el texto tal como está escrito en vez de fallar.

Se escribeDibuja
<sprite:'minecraft:block/sea_lantern'>una textura de bloque
<sprite:'minecraft:items':'minecraft:item/diamond'>una textura de objeto
<sprite:'minecraft:particles':'minecraft:heart'>una partícula
<sprite:'minecraft:gui':'minecraft:hud/heart/full'>un sprite del HUD
<head:'Notch'>una cuenta real, por nombre
<head:'entity/player/wide/steve'>una skin que trae el juego

Pon <white> delante de cada sprite, como hace el archivo incluido. Sin él, el sprite toma el color de alrededor y sale teñido. Otro color en su lugar lo tiñe a propósito.

Un atlas equivocado es la razón habitual de un sprite que no dibuja nada. Las partículas y la GUI no llevan carpeta ('minecraft:heart', no 'minecraft:particle/heart'); los bloques conservan block/ y los objetos item/.

Etiquetas que se mueven#

El cliente anima solo algunas texturas (fuego, lava, portales), y la pestaña ANIMADO son justo esas. No hay que configurar nada.

animation: es el otro tipo. Repinta las letras fotograma a fotograma, así que mueve símbolos y no sprites. Usa ids de Animaciones, por ejemplo animation: shine.

Hacer una etiqueta de bandera o cabeza#

Una skin que nadie lleva, como una bandera, va en la clave head: de la propia entrada. Acepta el valor base64, el hash de la textura o la URL completa de una web de cabezas. La cabeza se dibuja antes del display. El icono del menú toma el mismo valor como basehead-<valor>.

yaml
  flag_argentina:
    category: flags
    name: '{primary}&lARGENTINA'
    head: 'eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6…In19fQ=='
    icon: basehead-eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6…In19fQ==
    description: "Argentina, dibujada como cabeza."
    priority: 1

Espacio alrededor de la etiqueta#

tags.format en config.yml decide cómo se coloca cada etiqueta junto al nombre. Por defecto es %tag% : la etiqueta y un espacio. Una entrada puede poner su propio format: para una etiqueta sin espacio o con un corchete. Pon el espacio ahí, no en display.

Claves de la entrada
ClaveSignifica
displaylo que se dibuja; funcionan los tokens de paleta, los códigos & y MiniMessage
headuna skin dibujada como cabeza justo antes del display
formatcómo se coloca la etiqueta junto al nombre, sustituye a tags.format
animationun id de animations.yml
category, name, icon, description, priority, permission, requirement, hidden, metadatalos campos compartidos, mira el catálogo
Por qué las cabezas necesitan ecc_head

El lore de los menús y los placeholders son cadenas de texto, y ninguna etiqueta MiniMessage estándar puede escribir una skin. Por eso el plugin añade ecc_head, que lleva la skin a través de una cadena y reconstruye la cabeza al otro lado. Una cabeza dada como cuenta o como skin del juego no lo necesita.

Si una cabeza llega aun así como un <head> pelado, con la skin perdida, se elimina. El placeholder devuelve entonces el resto de la línea sin la cabeza, nunca la cara de un desconocido.

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