Iris
Add to Discord
Docs

Levels

Reward active members with XP, rank cards and level roles.

Configure Levels in the dashboard →

Overview#

Levels rewards the members who keep your server alive. Every message earns a little XP, XP adds up to levels, and levels can hand out roles on their own. Members check their progress with a rank card and see where they stand on the leaderboard.

The whole module is free on every plan: message XP, level-up messages, rank cards, the leaderboard and up to ten level role rewards. Premium adds voice XP, XP boosts and your own rank card background.

Setup#

  1. Open the dashboard and go to Engagement > Levels, then turn the module on.

  2. Set how much XP a message gives and the cooldown between messages that count.

  3. Choose where level-up messages go, and write your own if you like.

  4. Add Role rewards for the levels that should unlock something, then save.

  5. Make sure the Iris role sits above every reward role, or Iris cannot hand them out.

How XP works#

  • A message earns a random amount between the least and most XP you set, 15 to 25 by default.
  • Only one message per cooldown counts, 60 seconds by default, so spam does not pay.
  • Bots, webhooks and anything in a no-XP channel or from a no-XP role earn nothing.
  • Level 1 takes 100 XP, and each level after takes a little more than the last.

Settings#

SettingTypeDefaultWhat it does
Enable levelsToggleOffWhether XP is counted at all.
Least / most XP per messageNumber15 / 25The range a message earns from.
CooldownSeconds60How long before a member can earn from another message.
No XP channels / rolesChannels / RolesNoneWhere and who never earns XP.
Level-up messageSame channel, one channel, DM or offSame channelWhere the message goes. Placeholders: {user}, {username}, {level}, {server}.
Role rewardsLevel and roleNoneRoles given at a level. Free servers can set up to ten.
Keep earlier rewardsToggleOnOff keeps only the highest reward a member has reached.
Accent colourColourBlurpleThe progress bar and ring on the rank card.

Premium extras#

ExtraPlanWhat it does
Voice XPPremiumXP every minute for members talking with others. Muted, deafened, lone and AFK-channel members earn nothing.
XP boostsPremiumUp to 3x XP for chosen roles or channels. The best boost that applies is used; boosts do not stack.
Custom rank card backgroundPremiumYour own image behind every rank card, from a Discord image link.
More role rewardsPremium and up25 on Premium, 50 on Premium+, no limit on Premium++.
CSV export of the leaderboardPremium+Download every member's level and XP from the Leaderboard tab.

Commands#

  • /rank [member] Show your rank card, or another member's. Anyone
  • /leaderboard [page] The members with the most XP, ten to a page. Anyone

Permissions#

PermissionWhy Iris needs it
Send MessagesPosts level-up messages and answers /rank.
Attach FilesThe rank card is an image.
Manage RolesHands out role rewards. Iris must sit above every reward role.
Can I reset everyone's XP?

Yes, from the Leaderboard tab. Roles already given are not taken away.

Do members keep their XP if they leave?

Yes. If they come back, they pick up where they left off.

Why did a member not get their reward role?

The Iris role has to be above the reward role in your server settings, and Iris needs Manage Roles.