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.
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/*.ymlUna 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#
language: defaultDe 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.
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
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: ["@"]| Clave | Por defecto | Qué hace |
|---|---|---|
max-members | 30 | Tope base de miembros, antes de los bonus de nivel. exyliaclans.members.<n> en el líder lo sustituye |
max-alliances | 5 | Tope base de alianzas. exyliaclans.allies.<n> en el líder lo sustituye |
max-rivals | 10 | Tope base de rivales. exyliaclans.rivals.<n> en el líder lo sustituye |
invite-expire-seconds | 60 | Cuánto duran una invitación de clan y una petición de alianza. 0 no caduca |
invite-cooldown-seconds | 60 | Por clan, antes de poder invitar otra vez al mismo jugador. 0 lo desactiva |
create-cooldown-seconds | 120 | Por jugador, entre crear dos clanes. 0 lo desactiva. exyliaclans.createcooldown.<n> lo sustituye |
home-warmup-seconds | 5 | Cuenta atrás en /clan home. 0 es instantáneo. exyliaclans.homewarmup.<n> lo sustituye |
home-cancel-on-move | true | Moverse cancela el warmup |
home-cancel-on-damage | true | El daño lo cancela |
home-warmup-tick-sound | UI_BUTTON_CLICK|0.6|1.3 | NOMBRE|VOLUMEN|TONO por segundo. Vacío para silencio |
regroup-* | igual que los home-* | Los mismos cuatro para /clan regroup join |
regroup-cooldown-seconds | 60 | Por clan, entre llamadas. 0 lo desactiva. exyliaclans.regroupcooldown.<n> en el líder lo sustituye |
regroup-expire-seconds | 60 | Cuánto sigue disponible un punto de regroup. 0 no caduca |
clan-name-min-length | 3 | Nombre de clan más corto |
clan-name-max-length | 16 | El más largo |
clan-name-regex | ^[a-zA-Z0-9_]+$ | Patrón que debe cumplir un nombre |
visibility-mode | DISABLED | DISABLED, 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#
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.
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
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: WORLDGUARDAlcance en red#
claims-scope: server
war-arenas-scope: defaultQué 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.
| Valor | Lo comparten |
|---|---|
default | Los servidores del grupo de red de este servidor (network-group en el config.yml de ExyliaLib); sin grupo, todos |
global | Todos los servidores de la base de datos |
server | Solo este servidor |
| un nombre de grupo | Los 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
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 ventajasmodifiersde cada nivel) ykill-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 enmessages.yml, enrelations. Mira Placeholders.bossbars:focus,campyrally, cada uno conenabledy unconfigdecolorystyle; los dos marcadores aceptan ademásmax-distanceyduration-seconds. Lo que dice cada barra está enmessages.yml, enbossbars. Mira Herramientas de guerra.kick-protection:enabled(true) da tregua a un jugador expulsado yduration-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) ynotify-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) ytest-cooldown-seconds(10) son por clan;0desactiva cada uno. Mira Webhooks de Discord.mail:expiry-days(14),expiry-check-interval-minutes(30),max-message-length(256),max-mails-per-clan(100) ysend-cooldown-seconds(30, por jugador;0lo 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:
home-effects:
warmup-title:
fade-in: 0
stay: 10
fade-out: 0
teleport-title:
fade-in: 10
stay: 50
fade-out: 15Los 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.ymlylfp.yml:settingsmás un bloquecategoriesque 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ón | Qué lleva |
|---|---|
clan | Todo /clan: creación, invitaciones, rangos, banco, home, chat y las diez peticiones por chat |
claim | Reclamar, liberar, el mapa y el nombre y lore de la propia herramienta |
errors | Cada negativa, incluidas module-disabled, kick-protection y role-name-invalid |
level | Subidas y bajadas de nivel, líneas de EXP |
dtr | La visualización del DTR y las líneas de detalle congelado, regenerando y raidable |
placeholders | Palabras cortas que sustituyen los menús y la capa de PlaceholderAPI |
logs | Las cinco plantillas de línea del registro: con objetivo, sin objetivo, detalle, sin detalle y actor desconocido |
lfc, lfp | Los tablones de reclutamiento en los dos sentidos |
mail | El buzón del clan |
admin | Todo lo que dice /clanadmin |
confirm | El texto de la pantalla de confirmación compartida |
relations | Las cuatro etiquetas relacionales: member, ally, enemy, none |
war, war-admin | Guerras de clanes: la petición, la pelea, el resultado, y la preparación de arenas y kits |
bossbars | Lo que dicen las barras de focus, camp y rally |
teleport | Las líneas de cuenta atrás y llegada de home y regroup |
style | Las 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 claveprefix, 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