> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mythiclabs.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> MLFFA - the ultimate Free For All plugin for Minecraft

MLFFA is a Free For All Minecraft plugin that makes hosting fast-paced PvP games simple, with customizable kits, player stats, dynamic borders, and easy game management.

<CardGroup cols={2}>
  <Card title="Download" icon="download" href="https://builtbybit.com/resources/mlffa.119239/">
    Available on BuiltByBit.
  </Card>

  <Card title="Commands" icon="terminal" href="/plugins/mlffa/commands">
    Full command and permission reference.
  </Card>
</CardGroup>

## Requirements

No dependencies are required. PlaceholderAPI is supported optionally.

## Core features

* **Kit Editor** - create, edit, and manage PvP kits through an intuitive inventory-based editor
* **Dynamic Border** - a fully customizable world border that can shrink automatically as the game progresses
* **Player stats** - wins, kills, and deaths are tracked per player, and can be reset individually or for everyone at once
* **Game management** - configurable countdown, player cap, join-command hook, and winner rewards, all handled automatically once the arena is set up

### Kit Editor

Open the kit editor in-game with `/ffa editkit` and build kits directly from your inventory - no config editing required.

* Easy to use
* Fully customisable
* Permission based access

### Dynamic Border

The arena's world border shrinks automatically over the course of the game, pushing players together as it progresses.

* Easy to configure
* Fully customizable
* Automatic shrinking

## Configuration

MLFFA is configured through `config.yml`. A few of the key sections:

**Arena spawn and exit** - set in-game with [`/ffa setspawn` and `/ffa setexit`](/plugins/mlffa/commands), stored as world;x;y;z;yaw;pitch:

```yaml theme={null}
arena:
  spawn: s1-ffa;0.5;-60.0;-4.5;90.361145;-2.4322166
  exit: s1;2289.5;117.0;539.5;-90.10303;-1.0267578
```

**Game settings** - countdown length, player cap, an optional command to run when a player joins, and winner rewards (`{player}` / `{winner}` placeholders):

```yaml theme={null}
game:
  # Countdown time in seconds (default: 120 = 2 minutes)
  countdown-seconds: 120

  # How often to show countdown messages (in seconds)
  countdown-message-interval: 5

  # Maximum players in the arena
  max-players: 60

  # Join command to execute when player joins (optional, leave empty to disable)
  join-command: ''

  # Rewards for the winner
  # Use {player} or {winner} as placeholder for the winner's name
  rewards:
    - crates key give {winner} crates_editor 3
    - spawn {winner}
```

**UI** - action bar and boss bar display during the game (wording is edited separately in `messages.yml`):

```yaml theme={null}
# UI settings
# You can edit the design in messages.yml
ui:
  actionbar:
    enabled: true
  bossbar:
    enabled: true
    color: RED
    style: SOLID
```

**Join effects** - potion effects applied automatically on join, as `EFFECT_TYPE:DURATION:LEVEL` (duration in ticks, `-1` for infinite):

```yaml theme={null}
# Effects for joining players
# Format: "EFFECT_TYPE:DURATION:LEVEL"
# Duration: -1 = infinite, positive number = ticks (20 ticks = 1 second)
potion-effects:
  - STRENGTH:-1:2
  - INVISIBILITY:-1:1
  - SPEED:100000:2
```

**Border** - starting size, shrink behavior, and damage dealt outside it:

```yaml theme={null}
# Border settings
border:
  size: 300
  shrink-time: 200
  shrink-size: 5
  damage: 5
  buffer: 2
  center:
    x: -22
    y: 12
    z: -43
  warning: 0
```

<Tip>
  Changed the config? Run [`/ffa reload`](/plugins/mlffa/commands) to apply it without restarting your server.
</Tip>

## Licensing

This plugin is protected by our license system — see [Licensing & Purchases](/licensing) for how it works. Run [`/ffa about`](/plugins/mlffa/commands) at any time to check who your install is licensed to.

<Tip>
  Questions about MLFFA? Ask in [Discord](https://dc.mythiclabs.eu).
</Tip>