Contenido generado con IA — puede contener errores.

ExyliaChatCosmetics/Módulo de chatActualizada en v1.3.0

El módulo de chat

Lleva el chat de tu servidor con ExyliaChatCosmetics, o apaga el chat integrado y conserva tu plugin de chat.

Página 13 de 304 min de lectura

Con el módulo de chat activado, ExyliaChatCosmetics es el chat de tu servidor: canales, formatos, mensajes privados, filtro de palabras, menciones, emojis, renders de objetos y anuncios, con las etiquetas y los nombres de color dibujados directamente en la línea. Esta página te enseña a activarlo o apagarlo y dónde se configura cada parte.

Antes de empezar#

El chat integrado necesita Paper. Los cosméticos solos también funcionan en Spigot. Folia está soportado.

Pasos#

Decide quién lleva el chat

El módulo viene activado. Para conservar otro plugin de chat, abre plugins/ExyliaChatCosmetics/config.yml y pon modules: chat: false.

Aplícalo

Ejecuta /cca reload. El módulo arranca o se detiene según el ajuste. Apagado, el plugin da estilo al cuerpo del mensaje y deja la entrega a tu plugin de chat; pon los placeholders en el formato de ese plugin, mira Placeholders.

Activa o apaga partes sueltas

Ejecuta /cca menu, pulsa Ajustes y luego Comandos del chat o Funciones del chat. O edita chat/config.yml y ejecuta /cca chat reload.

Si un archivo del chat no se puede leer, el módulo se niega a arrancar, lo dice en la consola y el plugin vuelve a solo dar estilo a los mensajes. Una lista de palabras rota te cuesta el módulo, nunca los cosméticos.

Comprueba que funciona#

Escribe un mensaje en el chat. Deberías ver tu rango, tu nombre y el mensaje en la línea que trae el plugin. Luego ejecuta /cca chat line hola: te envía tu propia línea de chat y escribe en la consola qué partes comparten hover y clic.

Edita el chat#

Dos recargas#

/cca reload relee todo y enciende o apaga el módulo según modules.chat. /cca chat reload relee solo los archivos del módulo y no toca los cosméticos. También vuelve a registrar los comandos de chat, así que un comando que apagaste en chat/config.yml deja de responder sin reiniciar.

La línea de chat va en letras normales#

Si tu servidor usa las versalitas de ExyliaLib, los menús y mensajes se dibujan con ellas, pero la línea de chat no: el mensaje, la etiqueta, el nombre, los susurros y las piezas con clic conservan las letras con que se escribieron. Quien escribe BIENVENIDO lee BIENVENIDO. Los anuncios son el servidor hablando, así que mantienen las versalitas. Mira Mensajes.

Archivos del módulo de chat
chat/
  config.yml         interruptores: comandos, menciones, emojis, renders, enlaces, cross-server
  filter/            config.yml, rules.yml, whitelist.yml, leet.yml, punishments.yml
  text/              emojis.yml, grammar.yml
lang/<idioma>/chat/
  channels.yml       adónde va un mensaje
  formats/           vienen default.yml y msg.yml; cualquier otro .yml que añadas también se lee
  messages.yml       cada línea que envía el módulo, con su propio prefijo
  announcements.yml  la rotación de anuncios

channels.yml, formats/, filter/punishments.yml y text/emojis.yml contienen palabras que leen los jugadores, así que existen una vez por idioma, en lang/<idioma>/chat/. El resto es común a todos los idiomas.

Una versión anterior guardaba estos archivos sueltos en chat/ (filter.yml, rules.yml, whitelist.yml, leet.yml, punishments.yml, emojis.yml, grammar.yml). Cada uno se mueve a su carpeta en el primer arranque, conservando tus ediciones.

El recorrido de un mensaje

Los procesadores corren por etapas y luego por prioridad (menor primero). Uno que cancela detiene el recorrido. Un procesador que lanza error se salta, salvo en GATE y FILTER, donde el mensaje se cancela: una lista de emojis rota nunca pierde una línea, un filtro de palabras roto sí.

EtapaQué hace
GATEChat silenciado, permiso del canal, mensaje en blanco, cooldown
FILTERDemasiado parecido al anterior, flood, mayúsculas, ip/url/dominio/teléfono/unicode, reglas de palabras
TRANSFORMGramática, emojis, renders [item], sugerencias de /comando, enlaces, menciones
COSMETICSFuente, modificadores y color del texto
FORMATApunta los puntos del filtro, elige el formato, construye la línea
DELIVERYLanza ChatMessageEvent, aviso de mención, inicia el cooldown

La entrega toma el evento de chat en listener-priority (HIGHEST por defecto, así que los demás plugins ya han opinado). Recorta los lectores a los del canal, menos quienes ignoran al emisor, y fija un renderizador. Nunca cancela un mensaje que el recorrido dejó pasar, así que el servidor lo entrega firmado como siempre. Un mensaje bloqueado por el filtro de palabras se sigue mostrando al staff con exyliachatcosmetics.chat.staff.filtered, con el prefijo filtered-marker. Otros plugins pueden añadir procesadores, mira API.

Los comandos y permisos del módulo están en Comandos y Permisos.

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