# Leagues

The Arena League Module is an advanced implementation of a competition module within the Arena ecosystem. It builds upon the concepts of the Wager Module to enable the creation and management of round-robin style tournaments.

## Key Components

### 1. League Management

#### a. Host

* **Options**:
  * Assign a specific referee (individual account).
  * Designate a pre-created DAO (e.g., a referee DAO).
* **Role**: Manages the league, inputs match results, and oversees the tournament progression.

#### b. Configuration

* **Name**: Unique identifier for the league.
* **Description**: Comprehensive overview of the league.
* **Banner**: Optional image representation.
* **Expiration**: Defines the end point (time, block height, or never).
  * Note: If not processed by expiration, the league can be "jailed" and resolved only by the Arena DAO.
* **Rules**: Guidelines governing the league.
* **Rulesets**: Pre-defined sets of rules that can be applied if available for the league's category.

### 2. Financial Management

Dues

* Define stakes or entry fees for the league.
* Specify funding sources and amounts.
* For detailed information about dues handling, refer to the Escrow page.

### 3. League-Specific Parameters

#### a. Teams

* List of participating teams or individuals in the league.

#### b. Points System

* **Match Win Points**: Points awarded for winning a match.
* **Match Draw Points**: Points awarded for a draw.
* **Match Lose Points**: Points awarded for losing a match.

#### c. Distribution

* Defines how the prize pool will be distributed among final placements.

#### 4. Stat Tracking

* **Performance Metrics**: Track key indicators for participants (e.g., wins, losses, draws, total points).
* **Leaderboards**: Real-time rankings based on points and other criteria.
* **Tiebreaker Mechanism**: Utilize tracked stats to resolve ties in final standings.
* **Achievements**: Award recognitions for outstanding performances or milestones.
* **Data Visualization**: Present stats in easily digestible formats (graphs, charts).

## How It Works

1. **Tournament Setup**
   * Organizers define standard competition details, list of participants, final distribution, and points system.
   * The module automatically generates rounds with matches to ensure all participants play each other once.
2. **Match Management**
   * As each match concludes, the host inputs results into the system.
   * The leaderboard is dynamically updated according to the league's configuration.
3. **Point Adjustments**
   * The host has the ability to adjust points to penalize or reward teams outside of match results.
4. **End of Tournament Processing**
   * When all matches are completed, the module calculates final standings.
   * Prize funds are automatically distributed based on the predefined distribution.
   * The algorithm efficiently handles placement ties to ensure fair distribution.