# InHouseQueue Seasons

The Seasons feature in the In-House Queue Bot allows server admins to manage competitive seasons within their Discord server. This feature is designed to help organize and track in-house games over a set period, providing a structured way to compete and track player progress.

## Key Features

* **Season Management**: Start, extend, shorten, and end seasons.
* **Leaderboard**: Track the top players throughout the season.
* **Automated Notifications**: Notify players when a season is about to end.
* **Detailed Stats**: View season stats including start date, end date, games played, and unique players.

{% hint style="warning" %}
Seasons games are **always** part of the [**global leaderboard**](https://docs.inhousequeue.xyz/docs/quick-start#how-does-the-leaderboard-work). If you'd like to separate the season games from casual/relaxed games we suggest you create a new queue and make sure it has a [unique leaderboard](https://docs.inhousequeue.xyz/docs/quick-start#creating-a-unique-leaderboard).
{% endhint %}

## How to setup Seasons

1. **Starting a Season**: An admin uses `/season start` to begin a new season, specify the duration, game type, announcement channel, season name, and notification role.

<div align="left"><figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2FlNFYaJvPFzcDIxlliHpX%2Fseason_start.png?alt=media&#x26;token=19dffc56-faae-4ab7-b085-80ef8d2989cf" alt=""><figcaption></figcaption></figure></div>

2. Confirm that you want to start the season. Here, we suggest you first reset the leaderboards so all players get an even starting point.

<div align="left"><figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2FBQebClgbNysc94bPeUT7%2Fseason_confirmation.png?alt=media&#x26;token=d16da795-bcf1-4393-9101-8bb17cd6b4d5" alt=""><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2FvZ6VQLhq4gTAlSaIDcAV%2Fseason_started.png?alt=media&#x26;token=9752fed3-86ac-4ffa-9038-ca4b5ab81ac5" alt=""><figcaption></figcaption></figure></div>

3. <mark style="color:red;">InHouseQueue</mark> will send a message to your designated Seasons Announcements channel marking the start of the season for all players.

<div align="left"><figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2Fuw97lEGlo9queBxeKKRp%2Fseason_started_2.png?alt=media&#x26;token=e14f31d8-3c39-45c1-82c2-7aa1064363b3" alt=""><figcaption></figcaption></figure></div>

4. One day before the season ends, InHouseQueue will send a reminder!

<div align="left"><figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2F0rA0eO5AEs9R1n3BvIaB%2Fseason_1day.png?alt=media&#x26;token=5a005e6d-9356-4601-9245-85b402bf2390" alt=""><figcaption></figcaption></figure></div>

5. Once the season reaches its end date, or you end it early, the Final standings will be sent into the Seasons Announcements channel, and all stats that are part of the Global Leaderboard are automatically reset (Wins, Losses, MVP votes).

***MMR is not reset***

<div align="left"><figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2FphMBpvs59ipqMWo2YEEu%2Fseason_ended.png?alt=media&#x26;token=29d303ca-5c01-4f47-bde4-36a2bee628ee" alt=""><figcaption></figcaption></figure></div>

## Managing the Season

Throughout the season, the admin can extend or shorten the season using `/season extend` or `/season shorten`.

## Ending the Season

When the season needs to be ended early, the admin uses `/season end` to conclude the season.

## Viewing Stats

Admins can view detailed stats about the season, including the top players, by using `/season stats`.

<div align="left"><figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2FM3yqs2b8CWP1TUoZA1ER%2Fseason_stats.png?alt=media&#x26;token=af038fc1-f531-4e61-a6cf-339a47db45eb" alt=""><figcaption></figcaption></figure></div>

***

## All Seasons Commands

***

<mark style="color:red;">**Required**</mark>\*\* parameters will be in \[Square brackets]\*\*

<mark style="color:green;">**Optional**</mark>\*\* parameters will be in (Curly brackets)\*\*

<mark style="color:orange;">**/season start**</mark>

**Description**: Start a new season in the server with a specified duration, game type, and announcement channel.

**Usage**:

```scss
/season start [days] [game] [updates_channel] (season_name) (role)
```

* **days**: Duration of the season in days (1-90).
* **game**: Select the game for the season. Choices: League Of Legends, Valorant, Overwatch, Custom.
* **channel**: Select the channel for announcements and updates.
* **season\_name**: Name of the season (optional, max 20 characters).
* **role**: Role to notify for season announcements (optional).

***

<mark style="color:orange;">**/season extend**</mark>

**Description**: Extend the current active season by a specified number of days.

**Usage**:

```scss
/season extend [game] [days]
```

* **game**: Select the game for the season to extend. Choices: League Of Legends, Valorant, Overwatch, Custom.
* **days**: Number of days to extend the season (1-90).

***

<mark style="color:orange;">**/season shorten**</mark>

**Description**: Shorten the current active season by a specified number of days.

**Usage**:

```scss
/season shorten [game] [days]
```

* **game**: Select the game for the season to shorten. Choices: League Of Legends, Valorant, Overwatch, Custom.
* **days**: Number of days to shorten the season (1-90)

***

<mark style="color:orange;">**/season end**</mark>

**Description**: End the current active season early for a specified game.

**Usage**:

<pre class="language-bash"><code class="lang-bash"><strong>/season end [game]
</strong></code></pre>

* **game**: Select the game for the season to end. Choices: League Of Legends, Valorant, Overwatch, Custom.

***

<mark style="color:orange;">**/season stats**</mark>

**Description**: View the current season stats, including start date, end date, games played, unique players, and top 3 players.

**Usage**:

```bash
/season stats [game]
```

* **game**: Select the game to view the current season stats. Choices: League Of Legends, Valorant, Overwatch, Custom.