Contenido generado con IA — puede contener errores.

ExyliaClans/ReferenciaActualizada en v1.5.0

Configuración

Dónde guarda ExyliaClans sus archivos, cómo recargarlos y los ajustes que más se tocan: idioma, límites, moneda del banco, terrenos y DTR.

Página 19 de 2912 min de lectura
      

La mayoría de ajustes se cambian desde un menú, así que rara vez necesitas el archivo. Abre esta página cuando quieras saber dónde está un archivo, un valor por defecto o todas las claves de un bloque.

Dónde están los archivos#

Seis archivos, todos generados en el primer arranque desde valores tipados, comentarios incluidos. config.yml y wars.yml están en plugins/ExyliaClans/; messages.yml, webhooks.yml, lfc.yml, lfp.yml y los menús están en una carpeta de idioma a su lado:

plugins/ExyliaClans/
  config.yml
  wars.yml
  lang/es/messages.yml
  lang/es/webhooks.yml
  lang/es/lfc.yml
  lang/es/lfp.yml
  lang/es/menus/*.yml

Una clave que el plugin no reconoce se elimina en el siguiente arranque en vez de ignorarse. Cuatro bloques conservan claves que escribes tú: default-roles, levels.level-definitions, levels.kill-streak-bonuses y el bloque categories de cada archivo de reclutamiento.

Editar en el juego#

/clanadmin abre la lista de clanes. Su botón Plugin ▸ Ajustes (requiere exyliaclans.admin) abre un centro con una tarjeta por tema: general, módulos, teletransportes, terrenos, DTR, niveles, rivales, correo y registros, guerras de clanes (wars.yml) y reclutamiento (recruitment.yml). La página de un módulo apagado lo muestra como apagado.

Cada página explica sus valores y muestra el actual y el de fábrica. Clic para editar (números y duraciones se escriben); shift-clic derecho para restablecer. Un cambio se escribe en el archivo y se aplica como una recarga. Lo que no está en una página (base de datos, sonidos, listas de rangos) sigue en el YAML.

Recargar#

Ejecuta /clanadmin reload. Vuelve a leer los seis archivos (los de idioma, del idioma que se nombre ahora), reconstruye la tabla de niveles, arranca o para los módulos cuyo interruptor cambió, relee las categorías de reclutamiento, aplica a todo el que esté conectado un visibility-mode cambiado y recompila los menús. Los cambios en default-roles solo llegan a los clanes creados después.

language#

yaml
language: default

De qué carpeta de plugins/ExyliaClans/lang/ se leen los menús y los mensajes. default sigue el language del propio config.yml de ExyliaLib, así que una línea allí cambia todos los plugins de Exylia. en, es, pt, fr, ru o tr fijan solo este plugin. Cada idioma es una carpeta completa que puedes editar.

El inglés es la base sobre la que se ponen los demás, así que una línea aún sin traducir llega en inglés. Cualquier otro código que inventes empieza como inglés para que lo reescribas. Un language cambiado entra con /clanadmin reload. Los colores, etiquetas y listas de mensajes funcionan como en Colores y Mensajes e idiomas; los menús se editan como en Editar menús.

Los servidores que venían de 1.1.0 conservan sus cambios

En el primer arranque de 1.2.0 los antiguos messages.yml, lfc.yml, lfp.yml y menus/ se mueven a lang/custom/, y config.yml apunta ahí con language: custom, así que no se pierde nada de lo que el servidor editó. Pon language en default o en un código para pasar a las traducciones que vienen.

Límites y esperas#

El bloque settings guarda los topes de miembros, alianzas y rivales (30, 5 y 10 por defecto), las esperas de invitación y creación, los warmups de /clan home y /clan regroup y las reglas del nombre del clan (de 3 a 16 caracteres, letras, números y _). Un permiso de rango como exyliaclans.members.<n> sustituye al número base; mira Permisos. La tabla completa va abajo.

settings: todas las claves
yaml
settings:
  max-members: 30
  max-alliances: 5
  max-rivals: 10
  invite-expire-seconds: 60
  invite-cooldown-seconds: 60
  create-cooldown-seconds: 120
  home-warmup-seconds: 5
  home-cancel-on-move: true
  home-cancel-on-damage: true
  home-warmup-tick-sound: "UI_BUTTON_CLICK|0.6|1.3"
  regroup-warmup-seconds: 5
  regroup-cancel-on-move: true
  regroup-cancel-on-damage: true
  regroup-warmup-tick-sound: "UI_BUTTON_CLICK|0.6|1.3"
  regroup-cooldown-seconds: 60
  regroup-expire-seconds: 60
  clan-name-min-length: 3
  clan-name-max-length: 16
  clan-name-regex: "^[a-zA-Z0-9_]+$"
  visibility-mode: DISABLED
  forced-ff-worlds: []
  chat:
    quick-clan-prefixes: ["."]
    quick-ally-prefixes: ["@"]
ClavePor defectoQué hace
max-members30Tope base de miembros, antes de los bonus de nivel. exyliaclans.members.<n> en el líder lo sustituye
max-alliances5Tope base de alianzas. exyliaclans.allies.<n> en el líder lo sustituye
max-rivals10Tope base de rivales. exyliaclans.rivals.<n> en el líder lo sustituye
invite-expire-seconds60Cuánto duran una invitación de clan y una petición de alianza. 0 no caduca
invite-cooldown-seconds60Por clan, antes de poder invitar otra vez al mismo jugador. 0 lo desactiva
create-cooldown-seconds120Por jugador, entre crear dos clanes. 0 lo desactiva. exyliaclans.createcooldown.<n> lo sustituye
home-warmup-seconds5Cuenta atrás en /clan home. 0 es instantáneo. exyliaclans.homewarmup.<n> lo sustituye
home-cancel-on-movetrueMoverse cancela el warmup
home-cancel-on-damagetrueEl daño lo cancela
home-warmup-tick-soundUI_BUTTON_CLICK|0.6|1.3NOMBRE|VOLUMEN|TONO por segundo. Vacío para silencio
regroup-*igual que los home-*Los mismos cuatro para /clan regroup join
regroup-cooldown-seconds60Por clan, entre llamadas. 0 lo desactiva. exyliaclans.regroupcooldown.<n> en el líder lo sustituye
regroup-expire-seconds60Cuánto sigue disponible un punto de regroup. 0 no caduca
clan-name-min-length3Nombre de clan más corto
clan-name-max-length16El más largo
clan-name-regex^[a-zA-Z0-9_]+$Patrón que debe cumplir un nombre
visibility-modeDISABLEDDISABLED, CLAN_ONLY, ALLY_ONLY, CLAN_AND_ALLY_MIXED o UNIFIED, en mayúsculas o minúsculas. Un valor desconocido se avisa en consola y se lee como DISABLED. Mira Relaciones
forced-ff-worlds[]Mundos donde el friendly fire está siempre activo
chat.quick-clan-prefixes["."]Prefijos que envían una línea al chat de clan
chat.quick-ally-prefixes["@"]Prefijos que envían una línea al clan y a los aliados

Una invitación se compara con invite-expire-seconds cada vez que se lee, así que una pasada de tiempo nunca deja entrar a nadie. Una pasada cada treinta segundos borra las filas caducadas y avisa a quien esté conectado: al jugador invitado en una invitación, al clan que la pidió en una petición de alianza. Las invitaciones escritas antes de 1.2.0 no llevan hora de envío y cuentan como enviadas en la actualización.

Los nodos <n> son números por rango: en los topes gana el mayor, en las esperas el menor. Los de todo el clan se leen del líder mientras está conectado; el resto del tiempo vale el valor del archivo.

bank-currency#

yaml
bank-currency: ""

La moneda que guarda el banco del clan y con la que se pagan los terrenos: cualquier id de moneda del economy.yml de ExyliaLib, objetos y experiencia incluidos. Vacío es la moneda por defecto. Los depósitos, las retiradas, los precios de claim y reclaim, /clanadmin setbalance, el menú del banco y el ranking la usan y escriben las cantidades como las formatea esa moneda.

Cambiarla no convierte los saldos

Lo que guarda un banco es un número. Si cambias bank-currency con el servidor en marcha, cada banco lee el mismo número en la moneda nueva.

Módulos#

El bloque modules son trece booleanos, todos a true. Apaga uno para que deje de responder sus comandos y de dibujar sus menús. Mira Módulos.

Terrenos#

El bloque claims fija precios, límites de área y quién protege la tierra. Mira Terrenos.

claims: todas las claves
yaml
claims:
  base-price: 500.0
  price-per-block: 1.0
  min-area: 25
  max-area: 10000
  pillar-duration-seconds: 10
  min-separation: 5
  map-radius: 200
  reclaim-enabled: true
  reclaim-fee: 0.0
  protection-mode: WORLDGUARD

Alcance en red#

yaml
claims-scope: server
war-arenas-scope: default

Qué servidores de una base de datos compartida comparten terrenos y arenas de guerra. Los terrenos pertenecen al nombre de un mundo, así que uno hecho en un servidor no debe proteger un mundo con el mismo nombre en otro.

ValorLo comparten
defaultLos servidores del grupo de red de este servidor (network-group en el config.yml de ExyliaLib); sin grupo, todos
globalTodos los servidores de la base de datos
serverSolo este servidor
un nombre de grupoLos servidores de ese grupo

claims-scope viene como server y war-arenas-scope como default. Cambiarlo conserva las filas existentes: la tabla nueva parte de la vieja. La base de datos se configura en Base de datos.

DTR#

El bloque dtr guarda las reglas de protección contra raids. Mira DTR.

dtr: todas las claves
yaml
dtr:
  no-loss-worlds: []
  death-loss: 0.9
  members-per-point: 3
  frozen-duration-seconds: 600
  regen-amount: 0.1
  regen-interval-seconds: 45
  min-dtr: -1.0
  color-normal: "&a"
  color-regenerating: "&e"
  color-frozen: "&b"
  color-raidable: "&c"

Otros bloques#

  • levels: max-level, exp-actions, level-definitions (con las ventajas modifiers de cada nivel) y kill-streak-bonuses. Mira Niveles.
  • default-roles: los rangos con los que nace un clan. Mira Rangos.
  • relational-placeholders: los cuatro colores con los que se dibuja a un jugador para otro. Las cuatro etiquetas viven en messages.yml, en relations. Mira Placeholders.
  • bossbars: focus, camp y rally, cada uno con enabled y un config de color y style; los dos marcadores aceptan además max-distance y duration-seconds. Lo que dice cada barra está en messages.yml, en bossbars. Mira Herramientas de guerra.
  • kick-protection: enabled (true) da tregua a un jugador expulsado y duration-seconds (120) fija cuánto dura. La regla entera está en Relaciones.
  • logs: max-entries-per-clan (200).
  • rivals: kill-exp-multiplier (2.0), kill-stat-multiplier (1.0) y notify-target-on-declare (true).
  • webhooks: enabled (true) deja que los clanes conecten un webhook de Discord; apagado, el botón de ajustes desaparece y todo comando del webhook se niega. set-cooldown-seconds (30) y test-cooldown-seconds (10) son por clan; 0 desactiva cada uno. Mira Webhooks de Discord.
  • mail: expiry-days (14), expiry-check-interval-minutes (30), max-message-length (256), max-mails-per-clan (100) y send-cooldown-seconds (30, por jugador; 0 lo desactiva). Mira Chat y correo.
home-effects y regroup-effects

Dos bloques idénticos, uno por teletransporte, que solo guardan cuánto dura cada título:

yaml
home-effects:
  warmup-title:
    fade-in: 0
    stay: 10
    fade-out: 0
  teleport-title:
    fade-in: 10
    stay: 50
    fade-out: 15

Los tiempos van en ticks: veinte por segundo. Las palabras están en messages.yml, en teleport.home y teleport.regroup: warmup-actionbar, warmup-title, warmup-subtitle, arrival-title y arrival-subtitle. %time% son los segundos que faltan.

Las etiquetas relacionales, los textos de las bossbars y los títulos de teletransporte vivían en config.yml. En el primer arranque de 1.2.0 se sacan de ahí y se escriben en messages.yml en sus claves nuevas, salvo que ese archivo ya diga algo allí, así que la redacción propia del servidor sobrevive al cambio.

Los otros archivos#

  • wars.yml: tamaños de equipo, tiempos, el anuncio del resultado y los comandos permitidos durante una guerra. Mira Guerras de clanes.
  • webhooks.yml: las líneas del juego de la función de webhook (messages) y una plantilla de Discord por evento (events). Mira Webhooks de Discord.
  • lfc.yml y lfp.yml: settings más un bloque categories que escribes tú. Mira Reclutamiento.
  • messages.yml: cada línea que puede mandar el plugin; no queda nada de cara al jugador escrito a fuego. Detalles abajo.

Algunas líneas se muestran en el HUD del jugador en vez de en el chat, con la etiqueta [hud:grupo], y vuelven al chat para quien no lo ve: clan.member-joined y clan.member-left (hud:members), clan.member-promoted y clan.member-demoted (hud:roles), clan.bank-deposited y clan.bank-withdrew (hud:bank) y level.level-up (hud:level). Nuevo en v1.5.0

messages.yml: secciones y trucos

Dieciocho secciones bajo un prefix: clan, claim, errors, level, dtr, placeholders, logs, lfc, lfp, mail, admin, confirm, relations, bossbars, teleport, war, war-admin y style. Vive en lang/<idioma>/.

SecciónQué lleva
clanTodo /clan: creación, invitaciones, rangos, banco, home, chat y las diez peticiones por chat
claimReclamar, liberar, el mapa y el nombre y lore de la propia herramienta
errorsCada negativa, incluidas module-disabled, kick-protection y role-name-invalid
levelSubidas y bajadas de nivel, líneas de EXP
dtrLa visualización del DTR y las líneas de detalle congelado, regenerando y raidable
placeholdersPalabras cortas que sustituyen los menús y la capa de PlaceholderAPI
logsLas cinco plantillas de línea del registro: con objetivo, sin objetivo, detalle, sin detalle y actor desconocido
lfc, lfpLos tablones de reclutamiento en los dos sentidos
mailEl buzón del clan
adminTodo lo que dice /clanadmin
confirmEl texto de la pantalla de confirmación compartida
relationsLas cuatro etiquetas relacionales: member, ally, enemy, none
war, war-adminGuerras de clanes: la petición, la pelea, el resultado, y la preparación de arenas y kits
bossbarsLo que dicen las barras de focus, camp y rally
teleportLas líneas de cuenta atrás y llegada de home y regroup
styleLas líneas de /clan style, que colorea el nombre del clan
  • Los colores son tokens de paleta. {primary}, {error}, {highlight}, {success}, {warning}, {muted}, {info}, {letters}, así que recolorear el servidor nunca pasa por editar este archivo.
  • Una línea puede empezar con una etiqueta de efecto. [sound:ENTITY_VILLAGER_NO|1.0|1.0] reproduce un sonido y no llega nunca a la pantalla. Casi todas las líneas que vienen llevan una.
  • %prefix% se sustituye desde la clave prefix, y funcionan las etiquetas de clic y hover de MiniMessage.
  • Un mensaje puede ser una lista de líneas, y una línea que empieza con [center] se centra en el chat. Las peticiones que piden al jugador actuar vienen así (invitación de clan, petición de alianza, llamada de regroup, correo nuevo, perfil LFC caducado, solicitud LFP nueva, el mapa de terrenos al apagarse) como un bloque corto centrado con un botón clicable. Un servidor que nunca editó esas líneas recibe el bloque nuevo al actualizar; uno editado se respeta.

La sección placeholders guarda palabras cortas que se sustituyen (Sí, No, Activado, Conectado, los caracteres de la barra de progreso) para que sesenta y cinco archivos de menú no escriban cada uno los suyos. Dos de sus claves las lee además la capa de PlaceholderAPI: placeholders.none es lo que responden %exyliaclans_clan_name% y %exyliaclans_clan_role% para un jugador sin clan, y placeholders.na es lo que responde un hueco vacío de la plantilla o una posición sin clasificar. Mira Placeholders.

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