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

# Leveling

> Reward participation with XP, rank cards, and leaderboards.

Hedwig's leveling system tracks XP from participation and exposes rank cards
and leaderboards for members. Setup and configuration require **Manage Server**.

## Commands

| Command             | Use it to                      |
| ------------------- | ------------------------------ |
| `/leveling setup`   | Configure the leveling system  |
| `/leveling enable`  | Enable XP gain                 |
| `/leveling disable` | Pause XP gain                  |
| `/leveling config`  | Edit leveling settings         |
| `/leveling style`   | Choose the level-up card style |
| `/leveling reset`   | Wipe all XP data               |
| `,leveling rank`    | View a rank card               |
| `,leaderboard lvl`  | View the top members by level  |

`,rank` and `,level` are message-command aliases for `,leveling rank`.

## Rollout

<Steps>
  <Step title="Configure">
    Run `/leveling setup` and optionally choose a channel for level-up cards.
    If no channel is selected, cards post in the channel where the level-up
    event occurs. Use `/leveling config` to manage level roles.
  </Step>

  <Step title="Choose the presentation">
    Use `/leveling style` to choose the level-up card style that fits your
    server.
  </Step>

  <Step title="Enable and test">
    Run `/leveling enable`, then check `,leveling rank` and `,leaderboard lvl`.
  </Step>
</Steps>

## Level roles

`/leveling config` opens an interactive role manager. Select a role, enter a
whole level number greater than zero, and Hedwig will assign that role when a
member reaches the level. Remove entries from the same panel. Hedwig still
needs **Manage Roles**, and its highest role must be above every reward role.

<Warning>
  `/leveling reset` wipes XP data. Treat it as a migration or restart action,
  not a routine way to fix a display issue.
</Warning>