Reference

Configuration

Complete reference for config.yml and the plugin's other files.

The files live in plugins/ExyliaFFA/. All of them are generated on the first boot with their defaults and with comments explaining each key.

config.yml

leaderboard

leaderboard:
  max-entries: 50

max-entriesintegerpor defecto 50

How many players a leaderboard holds, and the highest position a leaderboard placeholder can answer.

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

Covered in Combat.

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 ..."

The ladder itself is in killstreaks.yml. See Kill streaks.

respawn

respawn:
  leave-on-death: false

leave-on-deathbooleanpor defecto false

true sends whoever dies to the lobby. false leaves them in spectator mode with a menu to respawn or leave, which is what most servers want.

kill-commands

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

Commands the console runs on each counted kill and on each death. They accept %killer% and %victim%.

kill-commands:
  on-kill:
    - "eco give %killer% 25"
  on-death:
    - "title %victim% actionbar &7Killed by &c%killer%"

Anti-farmkill does not filter these commands

on-kill runs on every kill, including one the anti-farmkill discarded for statistics. If you hand out money per kill, two accounts on the same IP can fund themselves by killing each other. To prevent it, gate the reward inside the command itself or in your economy plugin.

chat

chat:
  isolation: true

isolationbooleanpor defecto true

Keeps an arena's chat inside that arena: whoever is fighting or watching there reads that arena and nothing else, and the rest of the server reads none of it. Two arenas never share a room either. Set it to false to leave chat exactly as the server's chat plugin delivers it.

The message is never cancelled or re-sent — its format, hover text and click events are whatever the chat plugin gave it, and only the audience is smaller. The console keeps the full line. A chat plugin that cancels the event and sends each line itself has taken delivery over, and isolation quietly does not apply.

messages.yml

Every text the plugin sends, grouped by system:

Section	Contains
`prefix`	The prefix that fills `%prefix%` in every other message.
`common`	Shared errors and responses.
`ffa`	Joining, leaving, dying, arena not found, arena full, regeneration notices.
`stats`	Names, icons and formatting of the nine counters.
`combat`	Entering and leaving combat, blocked command.
`spectator-toggle`	Spectator mode messages.
`kit-editor`	Saving, cancelling and resetting a layout.
`invite`	Invitations between players.
`kill-streaks`	Streak notifications and announcements.
`anti-freehit`	The 1v1 link notice.
`admin`	Admin panel responses.
`player-settings`	Settings menu texts.

They all begin with %prefix%; delete it from a specific line to send that one without a prefix.

scoreboards.yml

See Scoreboard.

killstreaks.yml

See Kill streaks.

database.yml

See Installation · Database.

menus/

Menus are editable YAML, in two folders:

menus/
├── user/          FFA selector, kits, spawns, stats, spectator, settings
│   └── es/        the same screens in Spanish
└── admin/         panel, arenas, rules, kits, spawns, data, confirmations

You can change titles, sizes, icons, slots, lore and sounds. The action keys on each button are what tie it to what it does: keep them.

Migrations

The plugin versions its files and migrates them on its own, keeping your edits.

File	Version	What it migrates
`config.yml`	3	Reshapes the two action bars and corrects the countdown token to `%time%`.
`scoreboards.yml`	2	Points the lines at the renamed occupancy placeholder.

Unknown keys are deleted

A key no file declares is removed on load and reported once as UNKNOWN_KEY. That is what keeps the files clean after an update, and also why adding keys of your own to these files is a bad idea.

Something missing on this page? Tell us on Discord