Configuration

All configuration files are stored inside plugins/AdvancedFFA/

To apply changes after editing any file, run /ffa reload

---

config.yml

This file handles global settings and locations

# ============================================================================== #
#                             AdvancedFFA Configuration                          #
# ============================================================================== #

# Internal config version. Do not modify this manually.
config-version: 1

# Default interval in minutes for arena arena restoration
restoration-interval-minutes: 10

# Afk protection
# When set to 0, players remain invulnerable until they make their first movement
spawn-protection-timeout-seconds: 0

# Spectator countdown duration in seconds before respawning at arena spawn
spectator-countdown-seconds: 3

# Main lobby location where players are teleported on leaving arena
# Set in-game using /ffa setlobby.
lobby:
  world: "world"
  x: 0.5
  y: 64.0
  z: 0.5
  yaw: 0.0
  pitch: 0.0

Setting Details

• restoration-interval-minutes: Frequency at which FAWE restores the arena
• spawn-protection-timeout-seconds: How long a player can stand still before their invulnerability expires. Setting this to 0 leaves them protected indefinitely until their first movement
• spectator-countdown-seconds: Players spectate the arena while a countdown title ticks down before respawning
• lobby: The Lobby location

---

messages.yml

AdvancedFFA supports modern (Kyori Adventure MiniMessage) tags for text styling, hex gradients, hover effects, and built-in sound events with volume and pitch controls

Color & Gradient Support

You can use standard tags like <red>, <green>, <yellow>, <bold>, <italic>, and custom hex gradients

prefix: "<gradient:#00ff88:#00aaff>AdvancedFFA</gradient> <dark_gray>»</dark_gray> "

Sounds Configuration

Each message can support a sound optionally/or remove the sound field to disable sound:

no-permission:
  text: "<red>You do not have permission to execute this command.</red>"
  sound: "ENTITY_VILLAGER_NO"
  volume: 1.0
  pitch: 0.8

join-success:
  text: "<green>Joined arena <white>{arena}</white> with kit <white>{kit}</white>!</green>"
  sound: "ENTITY_PLAYER_LEVELUP"
  volume: 0.8
  pitch: 1.5

Key Placeholders in Messages

• {arena}: Name of the current arena
• {kit}: Name of the current kit
• {killer}: Player who scored the elimination
• {victim}: Player who died
• {seconds}: Remaining countdown time in spectator mode or arena restoration alerts
• {kills}, {deaths}, {kdr}, {playtime}: Used in /stats

---

scoreboard.yml

AdvancedFFA includes scoreboard with live session top-killer rankings and player head avatar icons

# ============================================================================== #
#                             AdvancedFFA Scoreboard                             #
# ============================================================================== #

# Internal scoreboard version. Do not modify this manually.
scoreboard-version: 1

scoreboard:
  # Master toggle. Set to false if you want to use an external scoreboard plugin.
  enabled: true
  
  title: <yellow><bold>Top 5<red> 🗡Kills
  
  # Lines displayed on the sidebar.
  # Available placeholders:
  #   {arena}     - Current arena ID or display name
  #   {kit}       - Current kit name
  #   {top_1} to {top_5} - Top killers in the current arena session
  # Top killer format: player avatar head + player name + kills count
  lines:
  - ''
  - '{top_1}'
  - '{top_2}'
  - '{top_3}'
  - '{top_4}'
  - '{top_5}'
  - ''
  - <gradient:#00ff88:#00aaff>AdvancedFFA</gradient>
  
  # Template for each line of the top 5 ranking
  # {rank}, {avatar}, {player}, {kills}
  top-killer-entry: '{avatar} <white>{player} <dark_gray>» <red><bold>🗡{kills}'
  top-killer-empty: <gray>#{rank} -</gray>

Using External Scoreboards

If you already use other scoreboard plugins, simply set enabled: false in scoreboard.yml and hook directly into our Placeholders!