Referencia

Configuración

Referencia completa de config.yml y de los demás archivos del plugin.

Los archivos viven en plugins/ExyliaFFA/. Todos se generan en el primer arranque con sus valores por defecto y con comentarios que explican cada clave.

config.yml

leaderboard

leaderboard:
  max-entries: 50

max-entriesenteropor defecto 50

Cuántos jugadores caben en un leaderboard, y la posición más alta que un placeholder de leaderboard puede responder.

combat

combat:
  tag-duration: 20.0
  blocked-commands: [spawn, hub, lobby, warp, home, tpa, tpaccept, tpyes, rtp, back]
  combat-actionbar:
    action-bar:
      text: "{primary}⚔ {error}Combat {muted}%time%s"
      duration: 0
      countdown: 0
      time-style: tenths

Detallado en Combate.

anti-farmkill

anti-farmkill:
  enabled: true
  same-player-enabled: true
  same-player-max-kills: 3
  same-player-window-seconds: 120
  same-ip-enabled: true

command-whitelist

command-whitelist:
  enabled: true
  commands: [msg, message, tell, w, whisper, reply, r, respond, ffa, ffaadmin]

anti-freehit

anti-freehit:
  hit-reset-window-seconds: 8
  linked-actionbar:
    action-bar:
      text: "{primary}⚔ {highlight}%linked_name% {error}%linked_hearts%❤ {primary}%linked_ping%ms {muted}| {warning}%time%s"
      duration: 0
      countdown: 0
      time-style: tenths

kill-streaks

kill-streaks:
  enabled: true
  reset-on-death: true
  break-min-streak: 3
  break-message: "<#b9a5cc>%killer% ended %player%'s ..."

La escalera está en killstreaks.yml. Ver Rachas.

respawn

respawn:
  leave-on-death: false

leave-on-deathbooleanopor defecto false

true envía al lobby a quien muere. false lo deja en modo espectador con un menú para reaparecer o salir, que es lo que la mayoría de servidores quiere.

kill-commands

kill-commands:
  on-kill: []
  on-death: []

Comandos que ejecuta la consola en cada baja contada y en cada muerte. Aceptan %killer% y %victim%.

kill-commands:
  on-kill:
    - "eco give %killer% 25"
  on-death:
    - "title %victim% actionbar &7Te mató &c%killer%"

El anti-farmkill no filtra estos comandos

on-kill se ejecuta en toda baja, incluida la que el anti-farmkill descartó para las estadísticas. Si das dinero por baja, dos cuentas con la misma IP pueden financiarse matándose entre ellas. Para evitarlo, condiciona la recompensa desde el propio comando o desde tu plugin de economía.

chat

chat:
  isolation: true

isolationbooleanpor defecto true

Mantiene el chat de una arena dentro de esa arena: quien pelea o mira ahí lee esa arena y nada más, y el resto del servidor no lee nada de ella. Dos arenas tampoco comparten sala. Ponlo en false para dejar el chat exactamente como lo entregue el plugin de chat del servidor.

El mensaje nunca se cancela ni se reenvía — su formato, su hover y sus clics son los que le dio el plugin de chat, y solo la audiencia es menor. La consola conserva la línea completa. Un plugin de chat que cancele el evento y mande cada línea por su cuenta se queda con la entrega, y el aislamiento simplemente no se aplica.

messages.yml

Todos los textos del plugin, agrupados por sistema:

Sección	Contiene
`prefix`	El prefijo que rellena `%prefix%` en el resto de mensajes.
`common`	Errores y respuestas compartidas.
`ffa`	Entrar, salir, morir, arena no encontrada, arena llena, avisos de regeneración.
`stats`	Nombres, iconos y formato de los nueve contadores.
`combat`	Entrar y salir de combate, comando bloqueado.
`spectator-toggle`	Mensajes del modo espectador.
`kit-editor`	Guardar, cancelar y resetear layout.
`invite`	Invitaciones entre jugadores.
`kill-streaks`	Notificaciones y anuncios de racha.
`anti-freehit`	El aviso de enlace 1v1.
`admin`	Respuestas del panel de administración.
`player-settings`	Textos del menú de ajustes.

Todos empiezan con %prefix%; bórralo de una línea concreta si la quieres sin prefijo.

scoreboards.yml

Ver Scoreboard.

killstreaks.yml

Ver Rachas.

database.yml

Ver Instalación · Base de datos.

menus/

Los menús son YAML editables, en dos carpetas:

menus/
├── user/          selector de FFA, kits, spawns, stats, espectador, ajustes
│   └── es/        las mismas pantallas en español
└── admin/         panel, arenas, reglas, kits, spawns, datos, confirmaciones

Puedes cambiar títulos, tamaños, iconos, posiciones, lore y sonidos. Las claves de acción de cada botón son las que lo enlazan con lo que hace: consérvalas.

Migraciones

El plugin versiona sus archivos y los migra solo, conservando tus ediciones.

Archivo	Versión	Qué migra
`config.yml`	3	Reestructura las dos barras de acción y corrige el token de cuenta atrás a `%time%`.
`scoreboards.yml`	2	Apunta las líneas al placeholder de ocupación renombrado.

Claves desconocidas se eliminan

Una clave que ningún archivo declara se borra en la carga y se reporta una vez como UNKNOWN_KEY. Es lo que mantiene los archivos limpios tras una actualización, y también por qué no conviene añadir claves propias a estos archivos.

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