Message XP and voice XP are separate tracks, each with its own levels and rewards. Both start off.
Before you begin
- You need Administrator for
/xp settingsand/xp set. - Discortics needs Send Messages and Embed Links, plus Attach Files for
/rank. - Role rewards need Manage Roles and a Discortics role above them. Integration roles can't be used.
Set up an XP track
Set up from the Dashboard
- Open Dashboard → Levels.
- Open Message or Voice and enable the track.
- Set its XP rate multiplier.
- Choose where level-up messages appear.
- Under Role Rewards, select Add reward, then edit the role and level directly in its row.
- Save, then test with a normal member.
[Insert screenshot here]
The enabled Message XP track on Dashboard → Levels
Use Message → Multipliers for role and channel multipliers. Use Restrictions for ignored roles, users, and channels; these restrictions affect both tracks. Each track has its own Reset stats action at the bottom, with confirmation before deleting XP. The other track and settings stay intact.
Limits
| Resource | Public | Prime | Custom |
|---|---|---|---|
| Role rewards per track | 20 | 35 | 100 |
| Ignored users | 5 | 10 | 20 |
| Ignored roles | 5 | 10 | 20 |
| Ignored channels | 5 | 10 | 20 |
| Role multipliers | 5 | 10 | 20 |
| Channel multipliers | 5 | 10 | 20 |
If your plan changes, existing entries stay, but you can't add more over the limit.
How members earn XP
Message XP
- Messages need at least five characters.
- Each message earns a random amount, with a small bonus for length.
- A cooldown stops rapid messages earning XP each time.
- Global, role, and channel multipliers apply.
Voice XP
- Each eligible minute earns 1 to 10 XP.
- Only the voice global multiplier applies.
Multipliers
Each is a number from 0.1 to 5.0. Use 1.0 for normal XP. Set a track's global multiplier to 2.0 for a Double XP event, and change it back afterwards.
| Multiplier | Where to set it | Example |
|---|---|---|
| Global | Global on Message, Multiplier on Voice | 2.0 |
| Role | Message → Multi → Role → Add | @Booster 1.5 |
| Channel | Message → Multi → Channel → Add | #introductions 1.5 |
Role and channel multipliers only affect message XP. If a member has several multiplier roles, the saved policy chooses the highest value or their average. Channel multipliers and vote boosts apply on top.
Level-up announcements
In the dashboard, open Message or Voice and choose Level-up announcements. In Discord, open the track’s Announcement settings.
| Mode | Where it posts |
|---|---|
| Channel | One channel you choose |
| Active Channel | Where the member next sends a normal message |
| DM | The member's DMs |
| Silent | Nowhere |
In the dashboard, select Edit message to open the separate embed builder. Choose Embed V1 or Embed V2, edit text and media in the preview, then save. V2 counters sit beside the format picker, with mention permissions in the sidebar. You can open the editor before choosing a destination; unsaved Levels settings remain when you return. Each track has its own message. Media and link URLs must be direct HTTP(S) URLs; level variables are supported in text.
In Discord, Edit sets a plain-text message and replaces a saved dashboard layout for that track.
| Variable | What it shows |
|---|---|
{{user.mention}} | Mentions the member |
{{user.username}} | Username |
{{user.id}} | Member ID |
{{user.tag}} | Username and discriminator |
{{guild.name}} | Server name |
{{channel.mention}} | Mentions the channel |
{{type}} | message or voice |
{{level.current}} | New level |
{{level.next}} | Next level |
{{xp.current}} | Current total XP |
{{xp.nextLevel}} | Total XP for the next level |
{{xp.needed}} | XP still needed |
Role rewards
Each reward belongs to one track. In the dashboard, open Message or Voice → Role Rewards. Select Add reward to start with an available role and the next unused level, then edit either value directly in the row. Each level can have one reward; use the trash button to remove it. Save your changes with the dashboard save bar.
- Open
/xp settings. - Select Message or Voice, then Rewards.
- Select Add.
- Choose the role and a level from 1 to 999.
Stack decides what members keep. On keeps every reward, and Off keeps only the highest. Roles change when a member levels up, so editing rewards doesn't update existing members straight away.
Ignore users, roles, or channels
Ignored entries never earn message or voice XP. Use this for bot-command channels.
- Run
/xp settings. - Select Ignores.
- Choose Users, Roles, or Channels, then select the entries.
Rank cards
Run /rank or /rank user:@member to see both tracks on one card. At least one track must be on, and the member must have earned XP.
Reward messages
Open Message or Voice → Role Rewards → Edit reward message to create one common announcement for that track's role rewards. Use the same Embed V1/V2 builder as the normal level-up message.
When a member earns a milestone role, this template replaces their normal announcement and uses the track's existing delivery setting. Without a saved reward template, the normal level-up message continues to be used.
| Variable | Value |
|---|---|
{{level.current}} | Current level |
{{reward.level}} | Highest earned reward milestone |
{{reward.mention}} | Earned role mentions |
{{reward.name}} | Earned role names |
A jump across several milestones includes all earned roles that the track's stacking setting awards. Mention permissions still decide whether role mentions ping.
Set or reset XP
| Goal | Command |
|---|---|
| Set XP | /xp set user:@member xp:1200 track:Message |
| Set a level | /xp set user:@member level:10 track:Both |
| Reset one member | /xp set user:@member xp:0 track:Both |
Use xp: or level:, not both. track: defaults to Both. Resetting doesn't change your rewards or settings.
Reset settings or XP
Open /xp settings and select Reset.
- Message, Voice, Rewards, Ignores, and Multipliers reset that configuration.
- Wipe Message and Wipe Voice remove every member's XP on that track.
Use Reset message stats or Reset voice stats at the bottom of the matching dashboard tab. Each requires a typed confirmation and resets only that track.
Commands
| Command | What it does | Permission |
|---|---|---|
/xp settings | Open the Levels menu | Administrator |
/xp set user: xp: level: track: | Set a member's XP or level | Administrator |
/rank user: | View a rank card | None |
Troubleshooting
A member isn't gaining message XP. Check that the track is on, the message has five or more characters, they aren't on cooldown, and nothing is ignored.
A member didn't get a reward role. Check it belongs to the track they levelled up on, and that Discortics has Manage Roles and a higher role.
An announcement didn't appear straight away. It's sent when the member next sends a normal message. For DM mode, they must allow DMs. For Channel mode, Discortics needs access to the channel.
Prefer one-line commands? See Direct Commands.