Configuration

The main configuration file is located at plugins/CocoFFA/config.yml.

General Settings

plugins/CocoFFA/config.yml

prefix: "&8[&#00F7DDCocoFFA&8] &7»"

command:
  main: "ffa"
  aliases:
    - "freeforall"

locale-file: "messages_en.yml"

# Symbol used for unlimited values
infiniteSymbol: "∞"

Database

plugins/CocoFFA/config.yml

settings:
  database:
    type: "sqlite"  # sqlite or mysql
    table-prefix: "cocoffa_"

    mysql:
      host: "localhost"
      port: 3306
      database: "cocoffa"
      username: "root"
      password: ""
      ssl: false
      pool-size: 10

    sqlite:
      file: "cocoffa.db"

Timing Settings

plugins/CocoFFA/config.yml

# How often leaderboards update (in seconds)
leaderboard-update-seconds: 180

# Countdown before arena starts (in seconds)
waiting-time: 180

Player Limits

plugins/CocoFFA/config.yml

player-limits:
  min-players: 2
  max-players: -1  # -1 for unlimited

Broadcast Settings

Configure countdown broadcasts:

plugins/CocoFFA/config.yml

broadcast:
  enabled: true
  times:  # Seconds before start to broadcast
    - 180
    - 120
    - 60
    - 30
    - 10
    - 5
    - 3
    - 2
    - 1

Command Restrictions

Restrict commands while in arena:

plugins/CocoFFA/config.yml

allowed-commands:
  enabled: true
  commands:  # Commands allowed in arena (without /)
    - "ffa"
    - "freeforall"
    - "msg"
    - "tell"
    - "r"
    - "reply"
    - "spawn"
    - "tpa"
    - "home"

Item Dropping

plugins/CocoFFA/config.yml

item-dropping:
  countdown:
    enabled: true   # Allow dropping during countdown
  in-game:
    enabled: false  # Allow dropping during game

IP Limits

Prevent players from joining with multiple accounts:

plugins/CocoFFA/config.yml

max-players-per-ip:
  enabled: true
  max: 1

Enderpearl Restrictions

plugins/CocoFFA/config.yml

enderpearl:
  restrict-outside-border: true  # Prevent throwing outside border

Border Teleport

Teleport players back if they leave the border:

plugins/CocoFFA/config.yml

border:
  teleport-if-outside-border: true
  seconds: 3   # Countdown before teleport
  blocks: 3    # Border buffer zone

Player State Management

plugins/CocoFFA/config.yml

player-state-management:
  enabled: true
  allowed-gamemodes:
    - "SURVIVAL"
    - "ADVENTURE"
  force-gamemode: "SURVIVAL"
  fly:
    disable-on-join: true

Spectator Settings

plugins/CocoFFA/config.yml

spectator:
  staff-can-see: true
  exit-gamemode: "SURVIVAL"
  items:
    player-selector:
      material: "COMPASS"
      name: "&ePlayer Selector"
      lore:
        - "&fRight-click to teleport to players"
        - "&fin the arena you're spectating"
    leave-spectate:
      material: "BARRIER"
      name: "&cLeave Spectate"
      lore:
        - "&fRight-click to stop spectating"
        - "&fand return to spawn"

Placeholders

Configure placeholder output:

plugins/CocoFFA/config.yml

placeholders:
  prefix: "cocoffa"
  toplist_wins:
    placeholder: "toplist_<place>"
    value: "&#f5c400#%place% &f%player% &7» &#FF3737%wins% wins"
    none: "&#f5c400#%place% &f- &7» &#FF3737- wins"
  wins:
    placeholder: "wins"
    value: "&f%value%"
    none: "&c0"