Members earn XP and climb levels by being active. Miyu tracks two separate levels for every member:
Both are off by default. Turn on the one you want, or both:
m!modules enable levelSystem
m!modules enable voiceLevels
Levels are counted per server. Being level 20 on one server doesn't change anything on another.
Every message gives 1 XP, but only once every 8 seconds. Spamming doesn't help, so the fastest way up is simply to keep talking.
Messages that don't count:
Everyone starts at level 1. This is roughly how much XP you need in total:
| Level | Total XP |
|---|---|
| 2 | 35 |
| 3 | 115 |
| 4 | 215 |
| 5 | 355 |
| 10 | 1,655 |
| 20 | 7,255 |
When someone levels up, Miyu congratulates them. By default the message is a reply to the message that got them the level. If you'd rather keep chat clean, pick a channel for all level-up messages:
| Command | What it does |
|---|---|
m!levels channel <#channel> |
Posts all level-up messages in this channel |
m!levels channel clear |
Goes back to replying in the channel where it happened |
If the channel you picked gets deleted, Miyu goes back to replying in place.
| Command | Who | What it does |
|---|---|---|
m!level |
Everyone | Shows your level and how much XP you need for the next one |
m!level <@member> |
Everyone | Shows someone else's level |
m!leaderboard |
Everyone | Shows the top 10 members of the server |
m!xp give <@member> <amount> |
Administrator | Gives XP to a member |
m!xp take <@member> <amount> |
Administrator | Takes XP away from a member. XP can't go below 0. |
m!level set <@member> <level> |
Administrator | Puts a member on a specific level |
m!levels enabled <on/off> |
Administrator | Turns text levels on or off. Same as m!modules enable levelSystem |
Bots can't get levels, so the admin commands don't work on them.
Miyu notes when a member joins a voice channel and gives XP when they leave. Moving between voice channels doesn't end the session. Only leaving voice completely does.
You need to stay at least 5 minutes to get anything. After that, XP depends on how long you stayed:
| Time in the session | XP per hour |
|---|---|
| 1st hour | 60 |
| 2nd hour | 54 |
| 3rd hour | 48 |
| Every hour after that | 24 |
Part of an hour counts too. Thirty minutes gives you 30 XP, for example. The rate goes down for long sessions so that leaving yourself in a voice channel all day isn't the best way to level up.
All voice level commands start with m!voice levels.
| Command | Who | What it does |
|---|---|---|
m!voice levels level [@member] |
Everyone | Shows your voice level, or someone else's |
m!voice levels leaderboard |
Everyone | Shows the top 10 members by voice XP |
m!voice levels xp give <@member> <amount> |
Administrator | Gives voice XP to a member |
m!voice levels xp take <@member> <amount> |
Administrator | Takes voice XP away from a member |
m!voice levels level set <@member> <level> |
Administrator | Puts a member on a specific voice level |
m!voice levels levels enabled <on/off> |
Administrator | Turns voice levels on or off. Same as m!modules enable voiceLevels |
Voice level-ups aren't announced. Members can check their progress any time with m!voice levels level.
levels enabled commands accept on, yes or true to turn levels on. Anything else turns them off.