Contenido generado con IA — puede contener errores.

ExyliaChatCosmetics/ReferenciaActualizada en v1.4.0

Configuración

Todas las claves de config.yml con su valor por defecto, y qué vive en messages.yml en vez de aquí.

Página 21 de 3014 min de lectura

Los archivos del plugin están en tres sitios: plugins/ExyliaChatCosmetics/config.yml (los ajustes de esta página), lang/<idioma>/cosmetics/*.yml (el catálogo) y lang/<idioma>/messages.yml, menus/ y chat/ (textos y pantallas, mira mensajes e idiomas y editar menús). Ejecuta /cca reload tras editar cualquiera. Los ajustes que más se tocan son modules, defaults, chat y shop; a continuación van las tablas completas de cada sección.

config.yml se genera a partir de los ajustes del propio plugin y lo vuelve a leer /cca reload. Eso conviene saberlo por tres motivos:

  • Una clave que el plugin no reconoce se elimina al cargar, y cada eliminación se reporta una vez en la consola. Una errata no se queda ahí calladita sin hacer nada.
  • Un valor que el plugin no puede leer se reporta y se usa el de por defecto. El servidor arranca igual; nunca se niega a cargar por una línea mala.
  • El archivo lleva una versión y se migra en su sitio. Un archivo escrito por una versión anterior conserva sus claves renombradas o movidas en el primer arranque: chat.module.enabled pasó a modules.chat, rank-colors.repaint pasó a rank-colors.keep, chat.default-color dio paso a la sección defaults, y la sección menu se movió a lang/<idioma>/messages.yml.

Los cosméticos en sí no están aquí. Viven en lang/<idioma>/cosmetics/*.yml y se describen en el catálogo.

config.yml, todos los catálogos, lang/<idioma>/cosmetics/animations.yml y, mientras el módulo de chat está encendido, su configuración y su filtro también se editan desde el navegador con el editor web de ExyliaLib (/exylialib editor ExyliaChatCosmetics). Cada archivo pide exyliachatcosmetics.admin, los catálogos muestran una vista previa de cada entrada tal como la pinta el juego, y un cambio aplicado lo revisa el mismo lector que carga el archivo y después se recarga.

language#

ClavePor defectoSignificado
languagedefaultEl idioma de los menús y los mensajes. default sigue el idioma configurado en el config.yml de ExyliaLib; en, es, pt, fr, ru o tr lo fijan solo para este plugin. Cada uno es una carpeta bajo lang/ que puedes editar; custom guarda los archivos que el servidor tenía antes de que existieran los idiomas.

modules#

Lo que usa este servidor. Un módulo apagado no registra nada — ni clase de cosmético, ni comando, ni botón, ni respuesta de placeholder — y lo que los jugadores ya llevan de él se queda en su perfil, así que volver a encenderlo le devuelve a cada uno sus cosas. Todos los interruptores vienen en true.

ClaveQué enciende
chatEl módulo de chat integrado: canales, formatos, mensajes privados, el filtro, la moderación. Apagado, el plugin es solo cosméticos y tu plugin de chat sigue entregando a través del hook. Se aplica con /cca reload.
tagsEtiquetas delante del nombre
nick-colorsColores para el nombre del jugador
rank-colorsColores para el prefijo y el sufijo del rango
chat-colorsColores para el mensaje
shadowsSombras bajo el nombre, el rango y el mensaje; cada una necesita su módulo de color
customEtiquetas y colores que los jugadores crean con tokens; cada uno necesita su módulo de etiqueta o de color
fontsFuentes para el mensaje
modifiersNegrita, cursiva y el resto de modificadores del mensaje
presetsLooks completos que monta el servidor (lang/<idioma>/cosmetics/presets.yml)
loadoutsLooks que los jugadores guardan y se vuelven a poner
Todos menos chat esperan a un reinicio

Un comando solo se puede añadir mientras el servidor arranca, así que /cca reload aplica chat y nada más. Si cambió cualquier otro interruptor, el reload lo dice en la consola — The modules in config.yml changed; restart the server to apply them. — y el conjunto en marcha se queda como arrancó.

defaults#

Lo que lleva un jugador de una clase de la que no ha elegido nada, según su rango. Una lista por clase, con una línea por entrada: un permission y el id de una entrada del catálogo de esa clase como cosmetic. Las mismas listas se editan en el juego desde la pantalla de ajustes.

plugins/ExyliaChatCosmetics/config.yml
yaml
defaults:
  tag:
    - permission: group.owner   # primero, así gana a vip
      cosmetic: staff
    - permission: group.staff
      cosmetic: none            # el staff no lleva etiqueta por defecto
    - permission: group.vip
      cosmetic: heart
  chat-color:
    - permission: ''            # todos los demás
      cosmetic: snow
ClaveNombra una entrada de
taglang/<idioma>/cosmetics/tags.yml
nick-colorlang/<idioma>/cosmetics/nick-colors.yml
rank-colorlang/<idioma>/cosmetics/rank-colors.yml
chat-colorlang/<idioma>/cosmetics/chat-colors.yml
shadow-color, nick-shadow, rank-shadowlang/<idioma>/cosmetics/shadow-colors.yml — las tres sombras son un mismo catálogo que se lleva en tres sitios
fontlang/<idioma>/cosmetics/fonts.yml
modifierlang/<idioma>/cosmetics/modifiers.yml
  • Gana la primera coincidencia. Las líneas se leen de arriba abajo y vale la primera cuyo permiso tenga el jugador, así que pon primero el rango más alto. Un grupo es el nodo group.<nombre> que pone LuckPerms.
  • Un permiso vacío es todo el mundo; none no da nada a ese grupo y corta la búsqueda.
  • Vacía (como viene cada lista) deja al jugador sin nada de esa clase, así que un servidor nuevo se ve igual que antes.
  • Un valor por defecto lo da el servidor, no lo posee el jugador. No necesita concesión, no se guarda en la fila del jugador, y en cuanto elige algo de esa clase se dibuja lo suyo. Una elección que ya no posee vuelve al valor por defecto.
  • Quitárselo lo mantiene quitado. Un jugador que se quita una clase (el menú o /cc unequip) no recibe el valor por defecto de ella hasta que vuelva a elegir algo. El unequip y el clear del staff, el botón Quitarlo todo y los loadouts devuelven el valor por defecto.
  • Los menús muestran un valor por defecto con menu.default-marker tras su nombre, y los placeholders _id y _name lo informan como cualquier cosa puesta.
  • Un id que no nombra ninguna entrada se reporta en la consola al cargar y al recargar, y esa línea se salta. Ningún catálogo puede llamar none a una entrada.
  • Un archivo escrito con los antiguos bloques grupo: id se convierte al arrancar: cada grupo pasa a una línea group.<nombre> en el orden escrito, y default a la última línea, con permiso vacío.

chat#

ClavePor defectoSignificado
hookdecorateCómo se estiliza el cuerpo del mensaje. Los cuatro modos están abajo.
priorityNORMALPrioridad del evento para chat_event y legacy_event: LOWEST, LOW, NORMAL, HIGH, HIGHEST, MONITOR. Cualquier otra cosa cae a NORMAL con un aviso.
sanitizetrueEl formato que escribe un jugador — &c, <red>, {primary} — se muestra como el texto que escribió. exyliachatcosmetics.chat.format deja pasar colores, degradados y decoraciones. Los clics, los hovers, las fuentes, las cabezas y los saltos de línea siguen siendo texto aunque pongas sanitize: false. El § se neutraliza siempre, con permiso o sin él.

El hook solo actúa mientras modules.chat está apagado. Con el módulo de chat encendido, el hook se desinstala y el módulo estiliza el cuerpo por su cuenta.

Los cuatro modos de hook#

ModoQué pasaElígelo cuando
decorateAsyncChatDecorateEvent: el cuerpo estilizado reemplaza al mensaje decorado antes de que lo vea ningún plugin de chat. No se cancela nada.Paper, con un plugin de chat que dibuja a través del evento — el chat propio de Paper y cualquier plugin basado en renderer. Recomendado.
chat_eventAsyncChatEvent.message(...), en la priority de arriba.El plugin de chat ignora la decoración pero lee message().
legacy_eventAsyncPlayerChatEvent.setMessage(...), escrito con códigos § y hex.El plugin de chat todavía usa el evento de cadena.
offEl chat no se toca nunca.Compones la línea tú mismo con la API, o solo quieres los placeholders de identidad.

Sea cual sea el modo, el mensaje se dibuja únicamente desde estado cacheado. Un dibujo que falla deja el mensaje exactamente como se escribió y se reporta como mucho una vez por minuto, así que un cosmético roto no puede convertirse en un muro de consola.

tags#

ClavePor defectoSignificado
format"%tag% "Cómo se sitúa la etiqueta alrededor del nombre; %tag% es la etiqueta. El espacio final es la razón por la que %exyliachatcosmetics_tag%%exyliachatcosmetics_nick% no necesita nada en medio. Una entrada de etiqueta puede sustituirlo con su propio format.

rank-colors#

ClavePor defectoSignificado
keep[]()<>{}|Los caracteres que un color de rango nunca repinta: el marco que un rango escribe alrededor de su nombre, así que &8[&eVIP&8] conserva sus corchetes grises mientras VIP toma el color nuevo. Todo lo demás se repinta — letras, glifos de un resource pack, la estrella de un sufijo. Un carácter que el rango escribió sin color propio se repinta siempre. Vacío lo repinta todo.

custom-tags#

Las reglas que tiene que pasar una etiqueta que un jugador se escribe. Valen para /cc customtag create, para el botón Crear uno y para /cca customtag set — un administrador se salta el token, no las reglas.

ClavePor defectoSignificado
min-length2
max-length16Un rango lo sube con exyliachatcosmetics.customtag.length.<n>; gana el más alto
pattern[A-Za-z0-9_\-]+Una expresión regular que tiene que cumplir el texto entero. <>{}&§%\ se rechazan diga lo que diga el patrón.
blacklist[admin, staff, owner]Palabras que una etiqueta no puede contener, sin distinguir mayúsculas
uniquetrueDos jugadores no pueden tener el mismo texto

custom-colors#

ClavePor defectoSignificado
max-stops4Por cuántos colores puede pasar un degradado propio. Un rango lo sube con exyliachatcosmetics.customcolor.stops.<n>; gana el más alto

loadouts#

ClavePor defectoSignificado
limit3Cuántos looks puede tener guardados un jugador. Un rango lo sube con exyliachatcosmetics.loadouts.<n>; gana el más alto
Cuántos personalizados puede crear un jugador no es una clave

No hay ningún custom-tags.limit y no lo va a haber. Cuántas etiquetas y colores propios puede escribir un jugador es un saldo, guardado por jugador y por tipo y repartido con /cca tokens give. Crear uno gasta un token create, cambiarlo gasta uno edit, y borrarlo no devuelve nada. Una cuota en config.yml sería el mismo número para todo el mundo; un saldo es algo que puedes vender, premiar o retirar jugador a jugador. Ver Tokens.

animations#

ClavePor defectoSignificado
tick2Ticks entre fotogramas de animación. Más bajo va más suave y cuesta más.

preview#

ClavePor defectoSignificado
format%tag%%prefix% %name%%suffix%{letters_black}: %message%La línea que dibujan /cc preview y las vistas previas del menú. %tag% ya trae su espacio final de tags.format; %prefix% y %suffix% son los del rango, en el color de rango que se esté mirando.

Cómo llaman las cosas los menús#

La sección menu que antes estaba aquí — el nombre de cada clase, las líneas de estado, la estrella, none, el mensaje y el prefijo de muestra, las indicaciones de las filas propias — es texto que ve el jugador, así que ahora vive en lang/<idioma>/messages.yml bajo menu, donde se traduce. Un config.yml de una versión anterior tiene su sección menu movida allí en el primer arranque. Ver messages.yml.

expiry#

ClavePor defectoSignificado
notify-on-jointrueAl entrar: una línea por cada concesión temporal que lleva puesta con el tiempo que le queda, más un recuento de las que se le acabaron mientras no estaba
retention-days30Cuánto se queda en la tabla una concesión caducada o revocada, para auditoría, antes de que la barrida diaria la borre

placeholders#

ClavePor defectoSignificado
none""Lo que devuelve un placeholder que no tiene valor
unknown?Lo que devuelve un placeholder que nombra algo que no existe

shop#

Comprar un cosmético bloqueado con moneda, desde el menú. Necesita ExyliaEconomy o Vault; sin ninguno de los dos, nada muestra un precio.

ClavePor defectoSignificado
enabledtrueSi un cosmético bloqueado con precio se puede comprar desde el menú
tier-pricescommon: 500, rare: 1500, epic: 4000, legendary: 10000El precio de cada nivel, en la moneda por defecto o como {amount, currency}

Una entrada de lang/<idioma>/cosmetics/*.yml entra en un nivel con tier: rare, o pone su propio price, que gana al de su nivel. Una entrada sin ninguno de los dos no está a la venta:

plugins/ExyliaChatCosmetics/cosmetics/tags.yml
yaml
tags:
  crown:
    price: {amount: 50, currency: gems}

Un precio es un número mayor que cero — 500, o 2.5k — o un bloque con amount y currency. Cualquier otra cosa, cero y negativos incluidos, se lee como sin precio, así que una errata deja un cosmético sin poder comprarse en vez de gratis. Un precio en una moneda que ninguna economía acepta tampoco se muestra. /cca reload vuelve a leer los niveles.

ownership#

Dónde cuenta lo que un jugador desbloquea. Se aplica al reiniciar. Nuevo en v1.4.0

ClavePor defectoSignificado
ownership.scopeglobalglobal (un desbloqueo vale en todos los servidores), server, default (el grupo de red de este servidor) o el nombre de un grupo. Lo desbloqueado de forma global siempre cuenta.
ownership.global-currencies[]Monedas cuyas compras valen en todos los servidores, sea cual sea el scope

messages.yml#

Todas las líneas que ve un jugador viven en plugins/ExyliaChatCosmetics/lang/<idioma>/messages.yml, generado a partir del record CosmeticMessages del plugin y recargado con lo demás. prefix — por defecto {primary}&lE-CHAT {letters_black}•<reset> — es a lo que se expande %prefix% en este archivo.

Las líneas se escriben con tokens de paleta de ExyliaLib ({primary}, {success}, {error}, …) en vez de con hex, así que repintar el servidor entero desde colors.yml las repinta también. Los placeholders que acepta cada línea están nombrados en el comentario que tiene encima.

SecciónQué hay dentro
generalrecargado, solo-jugador, sin-permiso, cosmético / tipo / jugador desconocido, clave inválida, duración inválida
entitlementsconcedido y sus dos líneas para el destinatario, revocado, las líneas de list, las de check, caducado, caducado-al-entrar, a-punto-de-caducar
equipequipado, desequipado, desequipado-por-tipo, no-poseído, nada-equipado, todo-quitado
favoritesañadido, quitado
loadoutsguardado, aplicado, borrado, límite, desconocido, vacío, inválido, las líneas de list
customcreado y su línea para el destinatario, editado, borrado, ninguno, no-es-tuyo, muy-corto, muy-largo, patrón, en-lista-negra, ocupado, color-inválido, demasiadas-paradas
tokenssin-create, sin-edit, gastado, dado, quitado y fijado con sus líneas para el destinatario, las líneas de saldo, clase-desconocida, no-es-personalizado
presetsaplicado, aplicado-en-parte, no-poseído, desconocido, las líneas de list
promptslos títulos y las pistas de las entradas de texto: etiqueta propia, color, editar cualquiera de las dos, nombre de loadout
menutypes (cómo se llama cada clase en títulos y lore), status (selected, available, locked, expiring), favorite-on, favorite-off, none, sample-message, sample-prefix, custom-hints
adminlas muestras que dibujan /cca preview, render y chat line, permanent, y los interruptores ON/OFF de las pantallas de admin del chat
confirmlas preguntas que se hacen antes de borrar algo, en los menús y en la línea de comandos

El módulo de chat se queda con su propio lang/<idioma>/chat/messages.yml, con su propio prefijo. Un plugin de chat habla como el chat, no como el plugin de cosméticos, así que el %prefix% de allí nunca se expande a este. Ver el módulo de chat.

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