Leveling
Reward activity with XP, level rewards, achievements, quests and seasonal competitions. This guide covers every tab in the Leveling dashboard.
Before you start
Make sure these are in place before opening the Leveling dashboard.
- You have the leveling.view capability on this server
- The Leveling module is enabled in Modules
- A role you can assign exists if you plan to set role rewards
- A channel exists for level-up announcements (optional)
What you'll see
The Leveling dashboard is split into nine tabs across the top of the page.
Overview
Landing screen for the module — confirm at a glance that XP is flowing the way you expect.
Stat tiles
- Total XP minted — total XP awarded since the module was first enabled.
- Active members — distinct members who earned XP recently.
- Messages tracked — chat messages that contributed XP.
- Level-ups today — number of times a member crossed a level threshold today.
Top 5 members
Level curve preview
Active season banner
Leaderboard
Live ranking of every member who has earned XP.
Search and scope
- Type any part of a member name into the search box to filter the list.
- Use the scope dropdown to switch between Lifetime, Seasonal and Weekly totals.
- Pages of 25 members each — use Previous and Next to navigate. The page indicator shows the current page and total page count.
Rewards
Tie roles to levels so members earn cosmetic or functional roles as they climb.
Add a reward
- Pick a level (any positive integer up to the max level).
- Pick a role from the searchable role picker. The bot must be able to assign that role.
- Click Add reward. The mapping appears below, sorted by level ascending.
Reward policy
- Stackable
- Members keep every reward role they have ever earned.
- Mutex
- Members only keep the role for their highest unlocked level. Older role rewards are removed when they level up.
- Season remove
- Reward roles are stripped at the end of every season.
Achievements
Unlockable badges grouped by rarity and category.
Master toggle and defaults
- Use the Achievements enabled toggle at the top to turn the system on or off without losing your config.
- Click Install defaults to seed a curated set of common achievements (Common through Legendary).
- The five rarity tiles count how many achievements you have at each rarity.
- Filter chips below the tiles let you scope the table to a single category (e.g. Activity, Social).
Channel that posts a celebration when someone unlocks an achievement. Leave blank to keep unlocks silent.
When on, the achievement post also mentions any bonus XP that came with the unlock.
Quests
Time-bound goals that reset on a cadence. Use them to drive specific behaviour.
Quest types
- Daily / Weekly / Monthly — repeat on a schedule. Reset hour and weekly reset day are configured in Settings.
- Event / Seasonal — only available while a season or event is running.
- One-time — a single completion per member, then archived.
- Repeatable — can be completed again after the cooldown.
Members below this level cannot see or accept the quest. Useful for advanced quests.
For Repeatable quests, the wait between consecutive completions.
When a quest has multiple objectives, AND requires every objective; OR finishes once any single objective is met. Set in Settings → Quests.
Seasons
Run competitive XP windows with their own leaderboard.
Season controls
- If no season is active, the card shows a Start season button. Click it to begin a fresh season.
- If a season is active, the card shows the season name plus an End season button.
- Past seasons appear in the table below with their name, status and end date.
Settings
The longest tab — split into the curve, XP rates, sources, anti-farm rules, multipliers and announcements.
Master switch
When off, no XP is awarded and the leaderboard is frozen. Existing balances are kept.
Level curve
Balanced (recommended), Linear, Exponential, or Custom for full control.
The level a member can reach. Most servers pick 50, 100 or 250.
Multiplies the XP required at every level. 1× is neutral; values >1 stretch the curve.
What an active member is expected to earn daily. Used to calibrate the curve.
Example: 2500
Roughly how long an active member should take to reach max level. The preview chart updates live.
Example: 180 days
When on, members at max level can prestige to reset XP and gain a prestige badge.
XP rates
Awarded per qualifying chat message.
Example: 5
Seconds between XP awards for a single member.
Example: 60
Awarded per minute spent in voice.
Example: 2
Messages shorter than this many characters do not earn XP.
Example: 5
XP multiplier on Saturday and Sunday.
Example: 1.5
Max consecutive days a member can build a streak bonus.
Example: 30
XP sources
- Messages — chat in any non-ignored channel.
- Voice — time spent in voice channels.
- Reactions — reacting to messages.
- Threads — posting inside threads.
- Module events — XP from other modules (e.g. ticket close, quest complete).
- Double XP event — temporary global multiplier you can toggle for a community event.
Anti-farm
| Setting | Type | Default | Description |
|---|---|---|---|
| Max XP / 10 min | Number | 500 | Caps short-burst XP per member. |
| Max XP / day | Number | 5000 | Daily ceiling per member. |
| Min account age (days) | Number | 7 | Brand-new accounts cannot earn XP. |
| Spam penalty | Percent | 50% | Reduce XP for repetitive messages. |
| Diminishing returns | Toggle | Off | Each XP award shrinks as activity grows. |
Multipliers, voice XP advanced and announcements
Members do not earn XP for messages or voice in these channels.
Members holding any of these roles do not earn XP.
Analytics
Trend data once XP has been flowing for at least a day.
- Stacked area chart of XP earned per source over the selected window.
- Bar chart of level-ups per day.
- Line chart of distinct active members per day — useful for spotting drops in engagement.
Audit
Read-only history.
Common tasks
Step-by-step recipes for the work most operators do most often.
Set up basic XP and a level-up announcement
The 30-second setup most servers want.
Open DashboardEngagementLevelingSettings.
- Toggle Enable leveling on.
- Leave the curve at Balanced, set Max level to 100 and Target time to max to 180 days.
- Under Announcements, pick a channel and click Save on each field — changes persist as you edit.
- Send a few test messages in any non-ignored channel and watch the announcement fire.
Add role rewards for milestones
Map four roles to levels 5, 10, 25 and 50.
- Open the Rewards tab.
- Type 5 in the level field, pick the role from the dropdown, click Add reward.
- Repeat for levels 10, 25 and 50.
- Pick a stack policy — most servers use Mutex so members only show their current rank.
- Verify the SYNTHET bot role sits above all four reward roles in your Discord role list.
Run a 30-day double-XP season
Spin up a competitive season for an event or anniversary.
- Open the Seasons tab and click Start season.
- Open Settings → XP sources and toggle Double XP event on.
- Optional: switch Reward policy to Season remove if you want season roles to expire automatically.
- At the end of the month return to Seasons and click End season.