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

# Playtime Levels

> Reward players for time spent in your ER:LC server with levels, roles, perks and level-up messages.

***

## What are Playtime Levels?

Playtime Levels reward players for time spent in your ER:LC server. Players level up automatically as they hit playtime milestones, and each level can give a Discord role and perks.

<Info>
  You need a linked ER:LC server set as active before you can set up Playtime Levels.
</Info>

***

## How to Use Playtime Levels

Find Playtime Levels on the **ER:LC Integration → Playtime Levels** page.

### Module Controls

| Control | Description |
| - | - |
| Enable Playtime Levels | Starts tracking playtime and awarding levels |
| View My Playtime | Shows your own playtime |
| Disable Module | Stops all playtime tracking and level rewards |

***

## Creating and Managing Levels

Levels are sorted from lowest to highest. You can create up to 15 levels, or up to 100 with [Melonly Plus](https://melonly.xyz/plus).

### Level Fields

| Field | Description |
| - | - |
| Level Name | 1 to 100 characters, such as Bronze Player |
| Required Playtime | Set in hours and minutes. At least 1 minute, at most 1 year. |
| Discord Role | Optional role given when a player reaches this level |
| Perks | Up to 20 perks per level, 300 characters each |

### Level Actions

| Action | Description |
| - | - |
| Reorder Levels | Change the order of levels. They must stay in ascending order. |
| Remove Levels | Delete a level |
| Add Perks | Add perks to a level |

<Frame caption="Playtime Levels">
  <img className="block" src="https://mintcdn.com/melonly/lEOimPXEDE-NzFj7/images/Dashboard/ERLCIntegration/playtimelevelsimg.png?fit=max&auto=format&n=lEOimPXEDE-NzFj7&q=85&s=7a922e24295a10bc05eabdd76f45aef3" alt="" style={{ borderRadius: '0.75rem' }} width="1901" height="940" data-path="images/Dashboard/ERLCIntegration/playtimelevelsimg.png" />
</Frame>

***

## Module Settings

| Setting | Description |
| - | - |
| Level Up Events Channel | The channel where level-up messages are posted |
| Custom Level Up Message | Your own channel message. Supports `{robloxuser}`, `{user}`, `{mentionuser}`, `{level}` and `{playtime}`. Requires Plus. |
| DM Players on Level Up | Sends players a DM when they reach a new level |
| Custom Level Up DM | Your own DM template, with the same variables. Requires Plus. |
| Automated Leaderboard Channel | A text channel where Melonly posts the playtime leaderboard and updates it every day |

Click the icon next to **Automated Leaderboard Channel** to customize the leaderboard message. It supports `{top50}`, `{top25}`, `{top10}`, `{top3}` and `{top1}`, and requires Plus.

***

## Top Leaderboard Roles

Give Discord roles to players ranked in the top X of the playtime leaderboard. For example, a top 3 role goes to players ranked #1 to #3.

Click **Add leaderboard role** to add one. You can add up to 10.

| Setting | Description |
| - | - |
| Discord Role | The role given to players in the top X. Each role can only be used once. |
| Top X | Players ranked #1 down to this position get the role. 1 to 100. |

***

## Example Use Cases

* Reward active players with special roles
* Build long-term progression for your community
* Offer perks such as in-game benefits or Discord privileges
* Celebrate milestones with automatic level-up messages
* Show off your top players on a leaderboard

***

<Card title="Need help?" icon="headset" href="https://melonly.xyz/discord">
  Still have questions? Join our Discord server for support from the Melonly Team.
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.