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

# Leveling and XP

> Reward activity with XP, levels and role rewards — separate text and voice tracks, multipliers, exclusions and level-up messages.

Members earn XP for being active. XP becomes levels, levels unlock roles.

## Four tabs

<CardGroup cols={2}>
  <Card title="Main Settings" icon="sliders">
    XP rates, exclusions, multipliers, resets.
  </Card>

  <Card title="XP Event" icon="bolt">
    Temporary server-wide boosts. See [XP Events](/en/engagement/xp-events).
  </Card>

  <Card title="Leveling Up Messages" icon="message-square">
    What is announced when someone levels.
  </Card>

  <Card title="Reward Roles" icon="award">
    Roles granted at a level.
  </Card>
</CardGroup>

## Three sources of XP

| Source        | Earned for                        | Default |
| ------------- | --------------------------------- | ------- |
| **Text**      | Sending messages, with a cooldown | On      |
| **Voice**     | Time in a voice channel           | On      |
| **Reactions** | Adding reactions                  | **Off** |

Each has a minimum and maximum XP per award — the actual amount is random inside that range — plus its own cooldown.

<Info>
  Adjusting XP rates requires **Basic**. On Starter the fields are visible but dimmed.
</Info>

<Warning>
  **On Starter, the on/off switches for Text, Voice and Reaction XP appear to work but do not.** They save and show a success message, while the bot continues using the standard rates: text and voice on, reactions off.

  The reaction XP figures shown on Starter also differ from what actually runs. Upgrade to Basic to control any of this.
</Warning>

### The level curve

101 levels. Level 1 costs 70 XP; level 100 costs 950,000. Progression is deliberately steep at the top so a long-standing member's rank means something.

## Exclusions

Roles, text channels and voice channels that earn no XP.

<Tip>
  Exclude your bot-command channel, spam channel, and any AFK voice channel. Otherwise members farm levels by sitting in AFK.
</Tip>

## Multipliers

<Info>
  Requires **Basic**.
</Info>

Give a role or a channel a multiplier between **0.25× and 5×**.

<Warning>
  **A role or channel cannot be both excluded and multiplied.** Putting the same one in both lists causes the save to fail with an error the page shows verbatim from the server. Remove it from one list.
</Warning>

<Note>
  Multipliers do not stack. When several apply — role, channel, and an active XP event — **the highest single one wins**.
</Note>

## Voice XP details

A voice session pauses while a member is muted or deafened, if you enable those restrictions, and can also ignore anyone alone in a channel. A single session is capped at 8 hours.

<Tip>
  Turn on **Ignore Alone Members**. Without it, a member can idle alone in a channel overnight and out-level the whole server.
</Tip>

## Reward roles

Grant a role at a text level, a voice level, or both.

When both are set, the **AND / OR** toggle decides whether the member needs to reach both or either.

Per reward you can also:

* **Remove Higher** — take away lower reward roles when a higher one is earned
* **DM Message** — tell the member privately
* **Show in Top** — display the role on the leaderboard

<Warning>
  **A reward row with no role selected is silently dropped when you save.** If a row vanishes after saving, that is why — pick a role before saving.
</Warning>

<Warning>
  Every reward role must sit **below** the Vetox role. See [Permissions](/en/permissions).
</Warning>

## Level-up messages

Four independent messages, each with its own switch, channel and format: channel level-ups, voice level-ups, reaction level-ups, and a DM.

Each can be plain text or an embed.

## XP resets

Two kinds:

**On leave / on ban** — clear a member's XP when they leave or are banned.

**Scheduled** — wipe the whole server's XP daily, weekly or monthly.

<Info>
  Scheduled resets require **Max**.
</Info>

<Note>
  Reset times use the timezone set on your [Server Setup](/en/server-management/setup) page, not UTC and not your browser. Monthly resets on a day that does not exist in a short month fall back to the last day.
</Note>

## Public leaderboard

Switch on to publish a read-only leaderboard at a public URL, shown on the page with a copy button.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Nobody is gaining XP">
    Check the Leveling module is on in Server Setup, the channel is not excluded, and the member has no excluded role.
  </Accordion>

  <Accordion title="I turned text XP off but members still level up">
    On Starter, those switches do not take effect. Upgrade to Basic, or exclude the channels instead.
  </Accordion>

  <Accordion title="Reward roles are not being given">
    The role must be below Vetox in the role list, and Vetox needs **Manage Roles**. Also confirm the row actually has a role selected — blank rows are dropped on save.
  </Accordion>

  <Accordion title="Saving fails with an error about a role or channel">
    The same role or channel is in both the exclusion list and the multiplier list. Remove it from one.
  </Accordion>

  <Accordion title="Someone leveled far faster than everyone else">
    Check for an AFK voice channel that is not excluded, and turn on Ignore Alone Members.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="XP Events" icon="bolt" href="/en/engagement/xp-events">
    Time-limited XP boosts.
  </Card>

  <Card title="Battle Pass" icon="trophy" href="/en/engagement/battle-pass">
    Seasonal quests and tiered rewards.
  </Card>
</CardGroup>