Configuración
Todas las claves de config.yml con su valor por defecto, y qué vive en messages.yml en vez de aquí.
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.enabledpasó amodules.chat,rank-colors.repaintpasó arank-colors.keep,chat.default-colordio paso a la seccióndefaults, y la secciónmenuse movió alang/<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#
| Clave | Por defecto | Significado |
|---|---|---|
language | default | El 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.
| Clave | Qué enciende |
|---|---|
chat | El 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. |
tags | Etiquetas delante del nombre |
nick-colors | Colores para el nombre del jugador |
rank-colors | Colores para el prefijo y el sufijo del rango |
chat-colors | Colores para el mensaje |
shadows | Sombras bajo el nombre, el rango y el mensaje; cada una necesita su módulo de color |
custom | Etiquetas y colores que los jugadores crean con tokens; cada uno necesita su módulo de etiqueta o de color |
fonts | Fuentes para el mensaje |
modifiers | Negrita, cursiva y el resto de modificadores del mensaje |
presets | Looks completos que monta el servidor (lang/<idioma>/cosmetics/presets.yml) |
loadouts | Looks que los jugadores guardan y se vuelven a poner |
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.
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| Clave | Nombra una entrada de |
|---|---|
tag | lang/<idioma>/cosmetics/tags.yml |
nick-color | lang/<idioma>/cosmetics/nick-colors.yml |
rank-color | lang/<idioma>/cosmetics/rank-colors.yml |
chat-color | lang/<idioma>/cosmetics/chat-colors.yml |
shadow-color, nick-shadow, rank-shadow | lang/<idioma>/cosmetics/shadow-colors.yml — las tres sombras son un mismo catálogo que se lleva en tres sitios |
font | lang/<idioma>/cosmetics/fonts.yml |
modifier | lang/<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;
noneno 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. Elunequipy elcleardel 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-markertras su nombre, y los placeholders_idy_namelo 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
nonea una entrada. - Un archivo escrito con los antiguos bloques
grupo: idse convierte al arrancar: cada grupo pasa a una líneagroup.<nombre>en el orden escrito, ydefaulta la última línea, con permiso vacío.
chat#
| Clave | Por defecto | Significado |
|---|---|---|
hook | decorate | Cómo se estiliza el cuerpo del mensaje. Los cuatro modos están abajo. |
priority | NORMAL | Prioridad del evento para chat_event y legacy_event: LOWEST, LOW, NORMAL, HIGH, HIGHEST, MONITOR. Cualquier otra cosa cae a NORMAL con un aviso. |
sanitize | true | El 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#
| Modo | Qué pasa | Elígelo cuando |
|---|---|---|
decorate | AsyncChatDecorateEvent: 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_event | AsyncChatEvent.message(...), en la priority de arriba. | El plugin de chat ignora la decoración pero lee message(). |
legacy_event | AsyncPlayerChatEvent.setMessage(...), escrito con códigos § y hex. | El plugin de chat todavía usa el evento de cadena. |
off | El 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#
| Clave | Por defecto | Significado |
|---|---|---|
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#
| Clave | Por defecto | Significado |
|---|---|---|
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.
| Clave | Por defecto | Significado |
|---|---|---|
min-length | 2 | |
max-length | 16 | Un 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 |
unique | true | Dos jugadores no pueden tener el mismo texto |
custom-colors#
| Clave | Por defecto | Significado |
|---|---|---|
max-stops | 4 | Por cuántos colores puede pasar un degradado propio. Un rango lo sube con exyliachatcosmetics.customcolor.stops.<n>; gana el más alto |
loadouts#
| Clave | Por defecto | Significado |
|---|---|---|
limit | 3 | Cuántos looks puede tener guardados un jugador. Un rango lo sube con exyliachatcosmetics.loadouts.<n>; gana el más alto |
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#
| Clave | Por defecto | Significado |
|---|---|---|
tick | 2 | Ticks entre fotogramas de animación. Más bajo va más suave y cuesta más. |
preview#
| Clave | Por defecto | Significado |
|---|---|---|
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#
| Clave | Por defecto | Significado |
|---|---|---|
notify-on-join | true | Al 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-days | 30 | Cuánto se queda en la tabla una concesión caducada o revocada, para auditoría, antes de que la barrida diaria la borre |
placeholders#
| Clave | Por defecto | Significado |
|---|---|---|
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.
| Clave | Por defecto | Significado |
|---|---|---|
enabled | true | Si un cosmético bloqueado con precio se puede comprar desde el menú |
tier-prices | common: 500, rare: 1500, epic: 4000, legendary: 10000 | El 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:
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
| Clave | Por defecto | Significado |
|---|---|---|
ownership.scope | global | global (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ón | Qué hay dentro |
|---|---|
general | recargado, solo-jugador, sin-permiso, cosmético / tipo / jugador desconocido, clave inválida, duración inválida |
entitlements | concedido 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 |
equip | equipado, desequipado, desequipado-por-tipo, no-poseído, nada-equipado, todo-quitado |
favorites | añadido, quitado |
loadouts | guardado, aplicado, borrado, límite, desconocido, vacío, inválido, las líneas de list |
custom | creado 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 |
tokens | sin-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 |
presets | aplicado, aplicado-en-parte, no-poseído, desconocido, las líneas de list |
prompts | los títulos y las pistas de las entradas de texto: etiqueta propia, color, editar cualquiera de las dos, nombre de loadout |
menu | types (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 |
admin | las muestras que dibujan /cca preview, render y chat line, permanent, y los interruptores ON/OFF de las pantallas de admin del chat |
confirm | las 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