Arena Configuration

Each arena has its own configuration file located in plugins/CocoFFA/arenas/<arena-name>.yml.

Basic Settings

plugins/CocoFFA/arenas/default.yml

# Arena display name (shown to players)
displayName: default

# Reward commands executed when a player wins
rewards:
  commands:
    - "eco give %player% 1000"
    - "give %player% diamond 5"

# Location settings (set with /ffa setup command)
startLocation: ''
exitLocation: ''
borderCenter: ''

Starter Item

The starter item allows players to start an arena by right-clicking:

plugins/CocoFFA/arenas/default.yml

starter:
  enabled: true
  material: BLAZE_POWDER
  glow: true
  name: "&#00F7DD{arena_name} &fFFA Starter"
  lore:
    - " "
    - "&fStarts an arena that anyone can join!"
    - " "
    - "&eRight-Click &6» &fStart Arena"

Give starter items with:

/ffa givestarter <arena> <player> [amount]

Countdown Settings

Configure the pre-game countdown:

plugins/CocoFFA/arenas/default.yml

countdown:
  actionbar:
    enabled: true
    message: "%prefix% &#00F7DD{start_seconds} &fseconds until &#00F7DD{arena_name} &fstarts!"
  bossbar:
    enabled: true
    color: BLUE  # BLUE, GREEN, PINK, PURPLE, RED, WHITE, YELLOW
    style: SOLID # SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20
    title: "%prefix% &#00F7DD{start_seconds} &fseconds until &#00F7DD{arena_name} &fstarts!"

Scoreboard

Per-arena scoreboard configuration:

plugins/CocoFFA/arenas/default.yml

scoreboard:
  enabled: true
  title: "&#00F7DD{arena_name} &fFFA"
  lines:
    - ""
    - "&#00F7DDInformation:"
    - "&fKills: &#00F7DD{kills}"
    - "&fPlayers left: &#00F7DD{alive_players}"
    - ""
    - "#00F7DDEvent:"
    - "&fArena: #00F7DD{arena_name}"
    - ""
    - "&#00F7DDdc.cocostudios.net"

Scoreboard Placeholders

Placeholder	Description
{arena_name}	Arena display name
{kills}	Player's kill count
{alive_players}	Number of players alive

In-Game ActionBar

Show player stats during gameplay:

plugins/CocoFFA/arenas/default.yml

ingame-actionbar:
  enabled: true
  message: "&fAlive: &#00F7DD{alive_players} &8&l| &fKills: &#00F7DD{kills}"

Effect Phases

Automatically apply potion effects at specific times:

plugins/CocoFFA/arenas/default.yml

effects:
  # Default effects given when joining
  defaults:
    - SPEED;1;1        # Effect;Level;Amplifier
    - REGENERATION;1;1

  # Timed phases (seconds after game starts)
  '1':
    start: 180  # 3 minutes after start
    effects:
      - SPEED;2;1
      - REGENERATION;2;1

  '2':
    start: 300  # 5 minutes after start
    effects:
      - SPEED;3;1
      - STRENGTH;1;1

Border Phases

Configure the shrinking world border:

plugins/CocoFFA/arenas/default.yml

border:
  default: 100  # Default border size when arena is not active

  # Timed phases (seconds after game starts)
  '1':
    start: 180    # 3 minutes after start
    size: 80      # New border size
    seconds: 5    # Time to shrink

  '2':
    start: 300    # 5 minutes after start
    size: 50
    seconds: 10

Players are notified when the border shrinks:

%prefix% &fWorld border is shrinking to &#00F7DD%size% &fblocks in &#00F7DD%time% &fseconds.

Using the Arena Editor

The easiest way to configure arenas is through the GUI editor:

/ffa editor <arena-name>

The editor allows you to:

• ✏️ Edit display name
• 📍 Set locations (start, exit, border center)
• 🎒 Configure kit with full inventory editor
• 📊 Edit scoreboard
• 🎁 Configure reward commands