Formatos
Cambia cómo se ve una línea de chat, añade la etiqueta o dale a un rango su propia línea con hovers y clics.
Un formato es una línea de chat entera, descrita por un archivo. Editándolo eliges qué va antes del mensaje, qué sale al pasar el ratón y qué hace un clic. Puedes dar uno distinto a cada rango.
Antes de empezar#
El chat integrado debe estar activado, mira El módulo de chat. Los formatos viven en plugins/ExyliaChatCosmetics/lang/<idioma>/chat/formats/, por ejemplo lang/es/chat/formats/. Vienen dos: default.yml (el chat público) y msg.yml (mensajes privados).
El plugin reemplaza default.yml cuando una versión nueva corrige la línea, y guarda tu copia antigua como default.yml.v<número>. Pon tus cambios en un archivo propio, como abajo.
Pasos: crea tu propia línea#
Copia la de por defecto
En lang/es/chat/formats/, copia default.yml como vip.yml.
Elige quién la recibe
Arriba en vip.yml pon permission: exyliachatcosmetics.chat.format.vip (quítalo para todos) y weight: 10. Un jugador que cumple varios formatos recibe el de más peso.
Edita las piezas
Bajo components: cada bloque es una pieza de la línea, dibujada según su priority (la menor primero). Cambia un text o añade un bloque. Para mostrar la etiqueta, añade:
tag:
priority: 5
text: '{tag}'Recarga
Ejecuta /cca chat reload y da el permiso al rango en tu plugin de permisos.
El default.yml que viene no tiene pieza de etiqueta: dibuja el rango ({prefix} ), el nombre ({nick}{suffix}), una flecha y el mensaje. La etiqueta solo sale cuando tu formato lleva {tag}.
Comprueba que funciona#
Como jugador con el permiso, escribe un mensaje: la línea debería usar tu disposición de piezas. Ejecuta /cca chat line hola para ver tu línea y, en la consola, dónde termina cada hover y clic. Quita una pieza poniéndole enabled: false.
Añade un hover o un clic#
Cada pieza admite hover (una línea o una lista) y click, que es RUN_COMMAND:/x, SUGGEST_COMMAND:/x, OPEN_URL:https://x o COPY:texto. Un shift-click pone texto en la caja del chat. La pieza del nombre que viene sugiere /msg {name} , y la del mensaje ofrece un reporte con Mayús + clic que ejecuta /report: tu servidor necesita un comando /report, o quítalo. Los tokens funcionan en todos.
Tokens#
| Token | Dibuja |
|---|---|
{message} | El mensaje con estilo |
{name} | El nombre sin más |
{nick} | El nombre con el color de nick |
{tag} | La etiqueta equipada |
{prefix} / {suffix} | El prefijo y el sufijo del rango, con el color de rango |
{channel} | El nombre del canal |
Los mensajes privados usan {message}, {sender}, {sender_nick}, {sender_tag}, {receiver}, {receiver_nick} y {receiver_tag}. También funciona cualquier %placeholder% de ExyliaLib o PlaceholderAPI. Los colores son tokens de la paleta de ExyliaLib, mira Colores.
Haz que la línea dependa de quien lee#
Los placeholders se resuelven para el emisor. Con per-viewer: true cada lector recibe su propio render: %player_…% pasa a ser el lector y %target_…% sigue siendo el emisor. Un placeholder %rel_…% lo hace por sí solo. Cuesta un render por lector en vez de uno por mensaje, así que úsalo solo si hace falta.
Fija un formato a un canal#
Pon format: vip en un canal de channels.yml para usar siempre ese archivo, mira Canales.
Cómo se elige un formato y reglas del archivo
Gana el format del propio canal si ese archivo cargó. Si no, el de más peso cuyo permission tenga el emisor (o que no tenga). Si no, default. Si default falta o está roto, la consola lo dice y los mensajes salen sin formato.
Un archivo con components: en la raíz es un formato con el nombre del archivo. Uno sin él se lee bloque a bloque y cada bloque con components: pasa a ser archivo.bloque: así msg.yml da msg.sender y msg.receiver, cada uno con una única pieza line. Los formatos de bloque solo se usan cuando una función los pide por nombre.
| Clave | Por defecto | Significado |
|---|---|---|
permission | vacío | Quién puede recibir este formato |
weight | 0 | Gana el de más peso que cumpla |
per-viewer | false | Un render por lector |
components.<nombre> | Una pieza. Una pieza sin text se salta y se avisa. El nombre no significa nada para el plugin | |
priority | orden del archivo | Dónde va la pieza; la menor primero |
enabled | true | false quita la pieza pero la deja escrita |
text, hover, click, shift-click | Qué se dibuja y qué hace |
Un click que no sea de los cuatro tipos se avisa al cargar el archivo. Los espacios con que se rellena una pieza se dibujan fuera de su hover y clic, así que el hueco entre dos piezas no responde a ninguna. Un cliente que detecta el ratón unos píxeles desplazado (un glifo de cabeza, un mod de avatares) puede responder con la pieza vecina: junta las piezas en una y usa shift-click para la segunda acción. /cca chat line muestra a qué responde cada carácter.
¿Falta algo en esta página? Dínoslo en Discord