Configuración

Cuatro archivos, todos generados desde records tipados en el primer arranque, comentarios incluidos. Una clave que el lector no reconoce se poda, así que una línea suelta desaparece en el siguiente arranque en vez de ignorarse en silencio. Cinco bloques están exentos porque sus claves son tuyas: default-roles, levels.level-definitions, levels.kill-streak-bonuses y el bloque categories de cada archivo de reclutamiento.

settings

settings:
  max-members: 30
  max-alliances: 5
  max-rivals: 10
  invite-expire-seconds: 60
  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: ["@"]

modules

Doce booleanos, todos a true. Ver Módulos.

logs

logs:
  max-entries-per-clan: 200

mail

mail:
  expiry-days: 14
  expiry-check-interval-minutes: 30
  max-message-length: 256
  max-mails-per-clan: 100

rivals

rivals:
  kill-exp-multiplier: 2.0
  kill-stat-multiplier: 1.0
  notify-target-on-declare: true

claims

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

Ver Terrenos.

dtr

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"

Ver DTR.

levels

max-level, exp-actions, level-definitions y kill-streak-bonuses. Ver Niveles.

kick-protection

kick-protection:
  enabled: true
  duration-seconds: 120

La regla entera — a quién cubre y por qué gana a forced-ff-worlds — está en Relaciones.

relational-placeholders

Las cuatro etiquetas y los cuatro colores con los que se dibuja a un jugador para otro. Ver Placeholders.

bossbars

focus, camp y rally, cada uno con enabled y un config de text, color y style; los dos marcadores aceptan además max-distance y duration-seconds. Ver Herramientas de guerra.

home-effects y regroup-effects

Dos bloques idénticos, uno por teletransporte:

home-effects:
  warmup-actionbar:
    text: "{primary}⏳ Clan Home {muted}| {primary}Teleportando en {highlight}%time%"
  warmup-title:
    title: "{highlight}%time%"
    subtitle: "{muted}Do not move!"
    fade-in: 0
    stay: 10
    fade-out: 0
  teleport-title:
    title: "{primary}&lCLAN HOME"
    subtitle: "{muted}Welcome back!"
    fade-in: 10
    stay: 50
    fade-out: 15

%time% son los segundos que faltan. Los tiempos van en ticks: veinte por segundo. Queda una sola cadena en español entre las que vienen: home-effects.warmup-actionbar.text, que dice Teleportando en. Todo lo demás de los dos bloques está en inglés.

default-roles

Los rangos con los que nace un clan. Ver Rangos.

messages.yml

Trece secciones bajo un prefix: clan, claim, errors, level, dtr, placeholders, logs, lfc, lfp, mail, admin y confirm. Unas 460 claves entre todas: cada línea que puede mandar el plugin está aquí, y no queda nada escrito a fuego.

Tres cosas que conviene saber:

• 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: la línea de invitación que viene es un botón Aceptar clicable.

La sección placeholders es un saco de palabras cortas que se sustituyen — Sí, No, Activado, Conectado, los caracteres de la barra de progreso — para que treinta y siete 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.

lfc.yml y lfp.yml

settings más un bloque categories que escribes tú. Ver Reclutamiento.

Recargar

/clanadmin reload vuelve a leer los cuatro archivos, reconstruye la tabla de niveles, 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.