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

# Live Periodic Leaderboard

> Live leaderboards that update every 30 minutes to showcase active chatters.

<sup>**Configuration Panel:** `/config server → Live Periodic Leaderboard`</sup>

<Note>
  This module is exclusive to **Superatom** subscribers.
</Note>

***

## Periods

| Period      | Description                               |
| ----------- | ----------------------------------------- |
| **Daily**   | Shows messages sent in the last 24 hours. |
| **Weekly**  | Shows messages sent in the last 7 days.   |
| **Monthly** | Shows messages sent in the last 30 days.  |

***

## Message Settings

<sup>Configuration Panel: `/config server → Live Periodic Leaderboard → Message`</sup>

### Types

| Type        | Description                                     |
| ----------- | ----------------------------------------------- |
| **Default** | Shown if a member does **not** obtain a reward. |
| **Reward**  | Shown if a member obtains a reward.             |

### Variables

<Info>[Variables](/src/miscellaneous/variable#live-periodic-leaderboard-message) are available for this module.</Info>

<Tabs>
  <Tab title="Edit Message">
    <Steps>
      1. Select a message type (**Default** or **Reward**) from the menu.
      2. Adjust the content.
    </Steps>
  </Tab>
</Tabs>

***

## Embed Settings

<sup>Configuration Panel: `/config server → Live Periodic Leaderboard → Embed`</sup>

### Properties

| Property            | Description                    |
| ------------------- | ------------------------------ |
| **Title**           | The embed title.               |
| **Description**     | The embed description.         |
| **Footer Icon URL** | Icon shown in the footer.      |
| **Footer Text**     | Text shown in the footer.      |
| **Image URL**       | Main image shown in the embed. |
| **Color**           | Accent color of the embed.     |

<Info>[Variables](/src/miscellaneous/variable#live-periodic-leaderboard-embed) are available for this module.</Info>

<Tabs>
  <Tab title="Edit Embed">
    <Steps>
      1. Select a property from the menu.
      2. Adjust the content.
    </Steps>
  </Tab>
</Tabs>

***

## Rewards

<sup>Configuration Panel: `/config server → Live Periodic Leaderboard → Rewards`</sup>

<Tabs>
  <Tab title="Add">
    <Steps>
      1. Click **Add**.
      2. Enter the rank required and the reward.
    </Steps>
  </Tab>

  <Tab title="Remove">
    <Steps>
      1. Select the role from the menu.
      2. Click **Remove**.
    </Steps>
  </Tab>

  <Tab title="Edit">
    <Steps>
      1. Select the role from the menu.
      2. Click **Edit**.
      3. Adjust the reward.
    </Steps>
  </Tab>
</Tabs>

***

## Requirements

<sup>Configuration Panel: `/config server → Live Periodic Leaderboard → Requirements`</sup>

| Requirement          | Description                                                       |
| -------------------- | ----------------------------------------------------------------- |
| **Minimum Messages** | Minimum number of messages required to appear on the leaderboard. |

<Tabs>
  <Tab title="Edit Requirement">
    <Steps>
      1. Select the requirement from the menu.
      2. Adjust the value.\
         *Enter `disable` to disable this requirement.*
    </Steps>
  </Tab>
</Tabs>

***

## Customizations

<sup>Configuration Panel: `/config server → Live Periodic Leaderboard → Customizations`</sup>

| Customization | Description                                             |
| ------------- | ------------------------------------------------------- |
| **Limit**     | Maximum number of members shown on the leaderboard.     |
| **Mode**      | Leaderboard type: **Text**, **Voice**, or **Reaction**. |
