> For the complete documentation index, see [llms.txt](https://mythicalbot.gitbook.io/arklynn-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mythicalbot.gitbook.io/arklynn-docs/server-configuration/level-rewards.md).

# Level Rewards

***

### **User Commands**

| Command (Slash)      | Command (Prefix)                  | Description                                              | Example                      |
| -------------------- | --------------------------------- | -------------------------------------------------------- | ---------------------------- |
| `/level [user]`      | `.level [@user]`                  | Shows your own (or another member's) level card.         | `/level` or `.level @nex.tm` |
| `/leaderboard level` | `.leaderboard` (or `.lb`, `.top`) | Displays the server’s level leaderboard with pagination. | `/leaderboard level`         |
| `/change_theme`      | – (only slash)                    | Opens a dropdown to change the theme of your level card. | `/change_theme`              |

{% hint style="info" %}
The level card shows: avatar, username, level, rank, total XP, current XP progress, voice minutes, and message count.
{% endhint %}

***

### **Admin Configuration**

All admin commands are grouped under `.levelsetup` (prefix) or `/levelsetup` (slash).\
You need the **Manage Server** permission to use them.

<table><thead><tr><th width="391">Command (Slash)</th><th>Command (Prefix)</th><th>Description</th></tr></thead><tbody><tr><td><code>/levelsetup view</code></td><td><code>.levelsetup view</code></td><td>Shows current settings (blacklist, bypass, XP rate, cooldown).</td></tr><tr><td><code>/levelsetup addxp &#x3C;user> &#x3C;amount></code></td><td><code>.levelsetup addxp &#x3C;user> &#x3C;amount></code></td><td>Manually adds XP to a user.</td></tr><tr><td><code>/levelsetup removexp &#x3C;user> &#x3C;amount></code></td><td><code>.levelsetup removexp &#x3C;user> &#x3C;amount></code></td><td>Removes XP from a user.</td></tr><tr><td><code>/levelsetup setlevel &#x3C;user> &#x3C;level></code></td><td><code>.levelsetup setlevel &#x3C;user> &#x3C;level></code></td><td>Directly sets a user’s level (resets XP to 0 at that level).</td></tr><tr><td><code>/levelsetup blacklist_add &#x3C;role/channel></code></td><td><code>.levelsetup blacklist add &#x3C;role/channel></code></td><td>Adds a role or channel to the blacklist (no XP earned).</td></tr><tr><td><code>/levelsetup blacklist_remove &#x3C;role/channel></code></td><td><code>.levelsetup blacklist remove &#x3C;role/channel></code></td><td>Removes a role/channel from the blacklist.</td></tr><tr><td><code>/levelsetup bypass_add &#x3C;role/channel></code></td><td><code>.levelsetup bypass add &#x3C;role/channel></code></td><td>Allows a role or channel to ignore blacklist restrictions.</td></tr><tr><td><code>/levelsetup bypass_remove &#x3C;role/channel></code></td><td><code>.levelsetup bypass remove &#x3C;role/channel></code></td><td>Removes a role/channel from bypass.</td></tr><tr><td><code>/levelsetup config_xprate &#x3C;rate></code></td><td><code>.levelsetup config xp_rate &#x3C;rate></code></td><td>Sets XP multiplier (e.g. <code>2.0</code> for double XP).</td></tr><tr><td><code>/levelsetup config_cooldown &#x3C;seconds></code></td><td><code>.levelsetup config cooldown &#x3C;seconds></code></td><td>Sets cooldown between XP‑earning messages (minimum 30s).</td></tr><tr><td><code>/levelsetup reset_user &#x3C;user></code></td><td><code>.levelsetup reset &#x3C;user></code></td><td>Resets level data for a specific user.</td></tr><tr><td><code>/levelsetup reset_all</code></td><td><code>.levelsetup reset all</code></td><td><strong>⚠️ Resets ALL level data</strong> on the server (requires confirmation).</td></tr><tr><td><code>/level_roles</code></td><td>– (only slash)</td><td>Shows all configured level roles.</td></tr><tr><td><code>/setup_level_role &#x3C;level> &#x3C;role></code></td><td>– (only slash)</td><td>Assigns a role to the given level.</td></tr><tr><td><code>/setup_level_role_remove &#x3C;level></code></td><td>– (only slash)</td><td>Removes the role for that level.</td></tr></tbody></table>

***

### **XP & Level Calculation**

* Every message earns **30‑60 XP** (subject to cooldown and multiplier).
* The required XP for level **L** is:

  ```
  XP(L) = 5 * L² + 50 * L + 100
  ```

  (Example: to reach level 10 you need 5*100 + 50*10 + 100 = 500 + 500 + 100 = 1100 XP.)
* **Cooldown** – By default, you can earn XP once every 60 seconds (adjustable).
* **XP Rate** – A multiplier applied to all XP gains (1.0 = normal, 2.0 = double).

***

### **Level Roles**

You can automatically assign a role when a member reaches a specific level.

#### Setup Commands

| Command (Slash)                    | Description                        |
| ---------------------------------- | ---------------------------------- |
| `/setup_level_role <level> <role>` | Assigns a role to the given level. |
| `/setup_level_role_remove <level>` | Removes the role for that level.   |
| `/level_roles`                     | Shows all configured level roles.  |

* Roles are **cumulative** – reaching level 10 gives you the roles for levels 1, 2, …, 10 (if configured).
* If a role is manually removed, it will be re‑added the next time the user sends a message (or you can run `/fixroles`).

***

### **What It Shows (**`/level_roles`**)**

* A list of levels and the associated roles.
* Roles are displayed as mentions (clickable).
* If a role has been deleted, the role ID is shown as `Unknown Role (ID)`.
* If no roles are configured, you’ll see a message inviting you to use `/setup_level_role add`.

> **Example Output**

text

```
Level 5: @Early Supporter
Level 10: @Trusted Member
Level 15: @Veteran
```

***

### **Blacklist & Bypass**

Control which channels or roles **cannot** earn XP (blacklist), and which **can ignore** those restrictions (bypass).

* **Blacklist** – Members in blacklisted roles or channels receive **no XP**.
* **Bypass** – Members in bypass roles/channels **always** earn XP, even if they are also blacklisted.

Examples:

* `/levelsetup blacklist_add #spam` – no XP in #spam.
* `/levelsetup bypass_add @Staff` – staff can earn XP everywhere.

***

### **Troubleshooting & Tips**

* **Why am I not getting XP?**\
  – Check your privacy settings (`/privacy`): `Message Content` must be enabled.\
  – You might be in a blacklisted channel or role.\
  – You are on cooldown – wait a minute and try again.
* **How do I reset someone’s level?**\
  Use `/levelsetup reset_user <user>` or `/levelsetup reset_all` (admin only).
* **My level roles aren’t being added!**\
  Run `/fixroles` – this will give the user all roles they should have for their current level.
* **I want to see the leaderboard in a different theme**\
  Use `/change_theme` first – the leaderboard will then use your chosen theme.

***

### **Themes**

Arklynn’s level card supports many beautiful themes.\
Change yours anytime with `/change_theme` and see a live preview.

Available themes: **Dark, Arctic, Sunset, Ocean, Forest, Midnight, Cherry, Gold, Ice, Lava, Dracula, Nord, Gruvbox, Matcha, Coffee, Matrix, Monochrome Dark/Light, Galaxy, Autumn, Sakura, Mint.**


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mythicalbot.gitbook.io/arklynn-docs/server-configuration/level-rewards.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.