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

# level modifiers

ZoomiesCore's leveling system awards XP to active members and can hand out roles as they climb.

## How XP is earned

| Source            | Default       | Notes                                                 |
| ----------------- | ------------- | ----------------------------------------------------- |
| Sending a message | 15–25 XP      | Random within the range, 60 s cooldown between awards |
| Being in voice    | 5 XP / minute | Awarded on channel leave (rounded to whole minutes)   |

Bots, DMs, and ignored channels never earn XP. Ignored roles are excluded entirely.

## Per-role XP multipliers

Roles can now boost or reduce XP for their members. Configure them in the **Dashboard → Levels** page.

* Multiplier **> 1** boosts XP (e.g. `2` = double XP for boosters).
* Multiplier **< 1** reduces XP (e.g. `0.5` = half XP for a "chatty" penalty role).
* Multiplier **= 0** disables XP for that role without ignoring them entirely.

### Rules

* **Highest applicable multiplier wins.** If a member has both Booster (2×) and Muted (0.5×), they earn 2×.
* Applies to **both message and voice** XP.
* Values clamped to `0..10` for safety.
* No multiplier configured → default 1× (unchanged behavior).

### Example

```
Booster role     → 2×
Server MVP role  → 3×
Muted role       → 0.5×
```

A member with Booster + Muted earns 2× (highest wins). A member with all three earns 3×.

## Role rewards

Set `Level → Role` mappings and members automatically get the role on level-up. Rewards apply cumulatively — a user who jumps from level 4 to level 8 in one message gains every reward in between.

## Slash commands

| Command         | Effect               |
| --------------- | -------------------- |
| `/rank [@user]` | Show XP, level, rank |
| `/leveltop`     | Top 10 leaderboard   |