Contenido generado con IA — puede contener errores.

ExyliaChatCosmetics/Módulo de chatActualizada en v1.3.0

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.

Página 15 de 304 min de lectura

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).

No edites default.yml

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:

yaml
  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#

TokenDibuja
{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.

ClavePor defectoSignificado
permissionvacíoQuién puede recibir este formato
weight0Gana el de más peso que cumpla
per-viewerfalseUn render por lector
components.<nombre>Una pieza. Una pieza sin text se salta y se avisa. El nombre no significa nada para el plugin
priorityorden del archivoDónde va la pieza; la menor primero
enabledtruefalse quita la pieza pero la deja escrita
text, hover, click, shift-clickQué 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