# Introduction

In this guide, you’ll learn…

- What are Leagues?

- Configuring Leagues

- Selecting Leagues as an Activity

 

* * *

# Configuring Leagues

Leagues are LiveOps game mechanisms , where players compete usually weekly against or bots. Each week, players can either stay in the same league, be promoted, or be demoted based on their performance. As players progress through leagues, the difficulty level also adjusts accordingly. Players can also receive optional rewards depending on their position in the league

## **Adding Leagues**

- Admin users can add leagues by clicking **"Add League"**.

- Each added league includes tiers, with tier numbers starting from 0. These tiers are used to select the appropriate leaderboards within the league configuration.

- Leagues can be removed during configuration, shifting tier numbers accordingly.

- League names cannot be empty.

- Clicking **"Cancel"** will discard all changes.

- Once leagues are configured, admin users cannot add or remove leagues but can rename them.

- To modify the number of leagues, all existing leagues must be removed first.

* * *

## **Accessing Leagues**

- A new side menu option **Events \> Leagues** is available.

- If leagues are not configured, a notification appears: _"Application doesn’t have Leagues configured. Please contact the Hawk team."_

To start using Leagues, users must request it from the Hawk team and provide a list of tiers. The team will then create the League accordingly.

- If leagues are configured, a table displays:

- Admin users can create a new league by clicking **"+ Add League"**.

* * *

## **Creating a League**

- Clicking **"+ New League"** opens the League Creation form.

- Required fields:

### **Validation Rules**

- If Promotion = 0, Demotion can be any number.

- If Demotion = 0, Promotion can be any number.

- Otherwise, Promotion must be less than Demotion.

- A league cannot be saved unless all leagues have a Client Leaderboard selected.

Availability is inherited from the event or activity set where it's used. If used by multiple entities, the Live availability has priority.

- If a league is used in at least one **Live** entity (event or activity set), it is marked as **Live**.

- If a league is not in use, it is marked **Test**.

- If a league is used only by Test entities, it remains **Test**.

* * *

## **Selecting Leagues as an Activity**

- Admin users can select a new activity type: **"Leagues"**.

- Once selected, an **Activity Configuration** dropdown allows choosing from the configured leagues.

* * *