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.
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}. Eldefault.ymlincluido 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.
tags:
mvp:
category: premium
name: '{primary}&lMVP'
display: '{highlight}✦'
icon: GOLD_INGOT
description: 'Reservada para los {highlight}mejores jugadores.'
priority: 1Una 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 tagsmuestra 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ña | Cantidad | Qué contiene |
|---|---|---|
| SÍMBOLOS | 24 | caracteres normales: corazones, estrellas, flechas |
| ANIMADO | 31 | sprites que el cliente anima solo |
| PARTÍCULAS | 24 | texturas de partículas, quietas |
| ICONOS | 24 | texturas de objetos y bloques |
| INTERFAZ | 20 | sprites del HUD: corazones, hambre, efectos |
| BANDERAS | 43 | banderas de países, cada una una skin de cabeza |
| PREMIUM | 14 | las 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 escribe | Dibuja |
|---|---|
<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>.
flag_argentina:
category: flags
name: '{primary}&lARGENTINA'
head: 'eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6…In19fQ=='
icon: basehead-eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6…In19fQ==
description: "Argentina, dibujada como cabeza."
priority: 1Espacio 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
| Clave | Significa |
|---|---|
display | lo que se dibuja; funcionan los tokens de paleta, los códigos & y MiniMessage |
head | una skin dibujada como cabeza justo antes del display |
format | cómo se coloca la etiqueta junto al nombre, sustituye a tags.format |
animation | un id de animations.yml |
category, name, icon, description, priority, permission, requirement, hidden, metadata | los 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