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

# Discord Community Engagement with XP and Leaderboards

> Boost Discord engagement with Volvox.Bot community features: XP, leaderboards, activity badges, level rewards, and Starboard highlights.

# Community

Community features help members see their activity, earn XP, and surface the best messages in your server. Engagement tracking and reputation are on by default; Starboard starts off until you select a channel.

## What it does

* **XP and ranks** — Members earn XP from message and optional voice activity, then check progress with `/rank`
* **Leaderboards** — `/leaderboard` shows the top members by XP
* **Reputation dashboard** — The Members page shows XP totals, level distribution, top members, and recent XP earners
* **Engagement profiles** — `/profile` shows message, reaction, and activity badge stats
* **Voice tracking** — Track voice joins and duration for Live Insight analytics
* **Activity badges** — Recognize members by tenure, such as newcomer, regular, veteran, or custom tiers
* **Level-up actions** — Reward levels with roles, messages, DMs, reactions, XP bonuses, or nickname changes
* **Starboard** — Repost popular messages to a dedicated channel once reactions reach your threshold

## Settings location

| Feature area                                          | Dashboard location                                   |
| ----------------------------------------------------- | ---------------------------------------------------- |
| Activity tracking, voice tracking, and profile badges | **Settings -> Onboarding & Growth -> Engagement**    |
| XP rates, cooldowns, voice XP, and level thresholds   | **Settings -> Onboarding & Growth -> Reputation**    |
| Level-up rewards and automations                      | **Settings -> Onboarding & Growth -> Level Actions** |
| Starboard highlights                                  | **Settings -> Community Tools -> Starboard**         |

## How to use

1. Members earn XP from message activity, and from voice minutes when Voice XP is enabled.
2. Members can use `/rank`, `/leaderboard`, and `/profile` in Discord.
3. Open **Settings -> Onboarding & Growth -> Engagement** to manage message, reaction, voice tracking, and badges.
4. Open **Settings -> Onboarding & Growth -> Reputation** to tune XP rates, cooldowns, and level progression.
5. Open **Settings -> Onboarding & Growth -> Level Actions** to configure rewards.
6. Open **Members -> Reputation** to review the server XP economy and recent XP gainers.
7. Open **Settings -> Community Tools -> Starboard** to enable community highlights.

## Engagement settings

The **Engagement** settings tab at `/dashboard/settings/onboarding-growth?tab=engagement` controls profile activity tracking, activity badges, and the engagement signals surfaced in the dashboard and `/profile`.

Use it when you want the bot to recognize activity tiers without changing XP math or level rewards.

## Reputation settings

The **Reputation** settings tab at `/dashboard/settings/onboarding-growth?tab=reputation` controls XP awards, cooldowns, and progression thresholds.

Use it when members are leveling too quickly, not quickly enough, or when you want to reshape the level curve before adding rewards.

## Reputation dashboard

The **Reputation** sub-tab on the Members page lives at `/dashboard/members?tab=reputation`. It shows the server's XP economy without opening individual member profiles.

Use it when you need to answer operational questions quickly:

* How much XP has been awarded across the server?
* What is the distribution of members across levels?
* Who leads the leaderboard right now?
* Who most recently earned XP?

The regular **Directory** sub-tab at `/dashboard/members?tab=directory` still lists searchable members with XP, levels, activity, warnings, and member-detail links.

## Level-up actions

Level-up actions can grant or remove roles, send DMs, post messages, add reactions, award bonus XP, and update nickname prefixes or suffixes. Channel messages can post back into the channel where the member leveled up, or into a fixed channel you select in the dashboard.

## Level progression

New servers ship with a 20-level reputation curve that climbs from 100 XP at Level 1 to 12,000 XP at Level 20. Edit thresholds under **Settings -> Onboarding & Growth -> Reputation** using the **Progression Steps** editor.

Use the **Curve Builder** when you want to reshape the whole progression without editing every level by hand:

1. Set **Levels** to the total number of levels in the curve.
2. Set **Level 1 XP** to the first threshold members should reach.
3. Set **Final XP** to the XP required for the last level.
4. Pick a curve shape.
5. Select **Apply curve**.
6. Fine-tune any generated level inline below the builder.

| Curve shape | Best for                                                      |
| ----------- | ------------------------------------------------------------- |
| Balanced    | Even spacing from the first threshold to the final threshold  |
| Early wins  | Faster early levels with more XP pushed into the later levels |
| Slow burn   | Heavier early requirements with a softer climb near the end   |

Select **Add Step** to append a single level, or select the remove button to drop one. Thresholds must strictly increase, at least one level is required, and the dashboard editor supports up to 100 progression steps.

## Starboard

Starboard reposts popular messages into a dedicated channel once they collect enough reactions. Use it to spotlight memes, highlights, or community wins without anyone needing to pin them by hand.

### When to use it

* You want a "hall of fame" channel that fills itself based on community reactions.
* You want members to curate content with reactions instead of relying on moderators.
* You want a single emoji (for example, ⭐) to act as a vote, or you want any emoji over the threshold to qualify.

### Set it up

1. Open **Settings -> Community Tools -> Starboard**.
2. Toggle **Enabled** on.
3. Select a **Destination channel** where reposts will land. Use a channel different from where members usually chat.
4. Set the **Reaction threshold** — the number of reactions a message needs before it's reposted.
5. Select an **Emoji**: a specific emoji (like ⭐) or **Any** to count every emoji.
6. Save your changes.

### How it works

* Starboard reacts to live reaction events. Messages that already met the threshold before you enabled Starboard or changed the threshold are not backfilled. To trigger a repost on an older message, remove and re-add a qualifying reaction, or add another one.
* React to messages in normal channels, not in the Starboard destination channel itself. Messages posted in the destination channel are skipped so the bot doesn't repost its own entries back into the same channel.
* Each qualifying message is reposted only once. Additional reactions after the first repost don't create duplicates.

### Configuration reference

| Setting             | Description                                              | Default |
| ------------------- | -------------------------------------------------------- | ------- |
| Enabled             | Turn Starboard on or off                                 | Off     |
| Destination channel | Channel where popular messages are reposted              | None    |
| Reaction threshold  | Number of reactions needed to qualify                    | 3       |
| Emoji               | Specific emoji to count, or **Any** to count every emoji | Any     |
| Allow Self-Star     | Allow members to qualify their own messages              | Off     |
| Ignored Channels    | Channels Starboard should ignore                         | None    |

### What a Starboard post looks like

Each Starboard post is an embed with a clickable title that jumps to the original message. The title shows the reaction emoji, the live star count, and the source channel — for example, **⭐ 7 stars in #general**. The embed also includes the original author, message content, any attached image, and the message timestamp. The star count updates in place as members react.

## Configuration

| Setting             | Description                                                                          | Default                            |
| ------------------- | ------------------------------------------------------------------------------------ | ---------------------------------- |
| Engagement tracking | Track messages and reactions for XP and badges                                       | On                                 |
| Voice tracking      | Track voice sessions for analytics; disabled whenever Engagement tracking is off     | On                                 |
| Reputation (XP)     | Award XP per message, reaction, and event                                            | On                                 |
| Voice XP            | Award reputation XP for completed voice minutes                                      | Off, 2 XP/min when enabled         |
| Activity badges     | Labels shown by `/profile` based on member activity history                          | Newcomer, Regular, Veteran, Legend |
| XP range            | Random XP awarded per message                                                        | 5-15 XP                            |
| XP cooldown         | Minimum time between XP gains                                                        | 60 seconds                         |
| XP system           | Configure level thresholds and rewards - see [Level progression](#level-progression) | 20 levels, ending at 12,000 XP     |
| Starboard           | Repost messages that reach your reaction threshold                                   | Off                                |