Medusa/modules/Leveling

Leveling

XP from messages and voice, levels, rank cards, XP multipliers and role rewards.

Members earn XP by chatting and by spending time in voice. Enough XP raises their level, and levels can give roles.

XP

Going from level L to the next level takes 5 * L * L + 50 * L + 100 XP, so early levels come fast.

  • Messages give a random amount between Minimum Message XP and Maximum Message XP, at most once per Message Cooldown.
  • Voice gives Voice XP Per Minute. With Require Unmuted on, muted members earn nothing. With Require 2+ Members on, members alone in a channel earn nothing.
  • Ignored Channels and Ignored Roles never earn XP.

Multipliers

Under Leveling Modifiers, give a role a multiplier such as 1.5 or 2. It applies to message and voice XP. A member with several of these roles gets the highest one.

Role Rewards

Under Level Role Rewards, pick a Target Level and a Reward Role. With Stack, members keep every reward they reach. With Highest, they only keep the role for their highest level.

Rank Card

/rank draws an image with the member's avatar, level, XP progress and position. Change its layout under Rank Card with the canvas editor.

Level Up Messages

Level Up Announcement picks where level-up messages go:

OptionWhere
Current ChannelThe channel the member was chatting in.
Custom ChannelThe Announcement Channel.
Direct MessageA DM to the member.
DisabledNowhere.

Level Up Message Lifetime (Seconds) deletes the message after that many seconds. 0 keeps it.

Settings

Leveling Settings

SettingDefaultWhat it does
Enable Message XPOnMessages give XP.
Minimum Message XP15Lowest XP per message.
Maximum Message XP25Highest XP per message.
Message Cooldown (Seconds)60Time between messages that give XP.
Enable Voice XPOnVoice time gives XP.
Voice XP Per Minute10XP per minute in voice.
Require UnmutedOnMuted members earn no voice XP.
Require 2+ MembersOnMembers alone earn no voice XP.
Level Up AnnouncementCurrent ChannelWhere level-up messages go.
Announcement ChannelNoneUsed with Custom Channel.
Level Up Message Lifetime (Seconds)0Deletes level-up messages after this long.
Accent ColorAccentColor of level-up messages.
Ignored ChannelsNoneChannels that give no XP.
Ignored RolesNoneRoles that earn no XP.

Leveling Modifiers: a role and a multiplier for each entry.

Level Role Rewards: the reward mode, then a target level and role for each entry.

Commands

CommandWhat it does
/rank [user]Show a rank card.
/level set <user> <type> <amount>Set a member's XP or level.
/level add <user> <type> <amount>Add XP or levels.
/level remove <user> <type> <amount>Remove XP or levels.
/level reset <user>Reset a member's progress.
View RankRight-click a member, then Apps > View Rank. Off by default on the Commands page.

/level belongs to the Admin rank by default. /leaderboard has Level, Messages and Voice Time boards, and the Leveling Events log records level-ups and XP changes.