UnumBeta

XP, levels and leaderboards

Turn chatting and hanging out in voice into levels, hand out roles at the levels you choose, and publish the rankings.

Plus and up

How XP is earned

Members earn XP two ways: by talking and by sitting in voice. You set both rates on the XP page, and both can be zero if you only want one of them. The switch at the top of the XP page turns all XP earning off, from Discord, voice, stream chat, cheers and heists alike (a heist still pays its Credits).

XP per Message
Awarded once per message that clears the cooldown. Anywhere from 0 to 1000. The default is 10.
Message Cooldown
Seconds a member must wait before another message earns anything. Anywhere from 0 to 3600. The default is 60, which is what stops one-word spam from being a strategy.
XP per Voice Minute
Awarded per whole minute spent in a voice channel. Anywhere from 0 to 1000. The default is 5.
Bits and Super Chats: XP per $1
Awarded for every $1 a viewer spends cheering on Twitch or YouTube. Twitch bits count 100 per $1. YouTube Super Chats and Super Stickers count their price, converted to US dollars with approximate rates when paid in another currency. Part of a dollar counts, so 250 bits at 10 XP per $1 is 25 XP, rounded down to whole XP. Anywhere from 0 to 10000. The default is 0, which turns it off.

Voice XP is counted in whole minutes and paid out when someone leaves a channel or moves to another one, so a session shorter than a minute earns nothing. If Unum restarts while people are in voice, the time they had already banked is reconciled rather than lost.

Chat in your Twitch, Kick or YouTube stream earns XP as well. A viewer who has linked that platform account to their Discord account earns straight onto their Discord account, so one person has one level however they turned up. A viewer who has not linked yet still earns: the XP is kept for that stream account and joins their Discord account when they link.

Bits and Super Chats XP works the same way. Each cheer, Super Chat or Super Sticker earns once, even if the platform sends it twice, and anonymous cheers earn nothing.

How levels are calculated

Levels come from a square-root curve, so each one costs more than the last. The XP needed to reach level n is n multiplied by itself, times 100.

Level 1
100 XP
Level 5
2,500 XP
Level 10
10,000 XP
Level 20
40,000 XP
Level 50
250,000 XP

The curve is fixed; what you control is how fast XP arrives. The XP page shows a reference table so you can sanity-check a rate before saving it. At 10 XP per message with a 60-second cooldown, level 10 is roughly a thousand messages.

Role rewards

A role reward hands out a Discord role the moment someone reaches a level.

  1. On the XP page, under Role Rewards, enter a level between 1 and 1000.
  2. Pick the role, and press Add Reward.
  3. In Server Settings, Roles, drag Unum’s role above every role you just listed.
  • Rewards stack. Someone who passes level 5 and then level 10 keeps both roles.
  • One role per level. Adding a second reward for a level you already covered replaces the old one.
  • Rewards are granted at the moment of levelling up, not retroactively. Members already past a level will not receive a newly added role until they level again.

What members see

There is no XP command to learn. Members see two things: a level-up message when it happens, and the leaderboard.

  • Level up from a Discord message: Unum replies in that same channel with a short line naming the member and the new level.
  • Level up from voice: the line is posted in the voice channel’s chat and mentions the member.
  • Level up from stream chat, bits or a Super Chat: no line is posted, but the role rewards still arrive.
  • Any role rewards for the new level are added at the same moment.

The public leaderboard

The leaderboard is a web page anyone with the link can open. It is how members actually check where they stand.

  1. Open Leaderboard in the dashboard and turn on Enable public leaderboard.
  2. Choose which columns to show: Messages, Voice Time, Credits, XP and Level, and Invites.
  3. Press Save. The public URL appears on the page, ready to share or pin.
Vanity URL slug
A readable address instead of the default one. Ultimate only.
Accent colour
One colour applied across the page. Ultimate only.
Banner image
A header image, up to 2 MB. Ultimate only.

Sharing XP across servers

Server Groups let several servers run as one community, and are part of Ultimate. When a group has Share XP turned on, XP is pooled: a member’s level counts the same in every server in the group, and the leaderboards read from the whole group.

While that is on, the rates move to the group. The XP page in each member server shows its fields greyed out with a note pointing at the Server Group page. Role rewards stay per server, because the roles themselves do. The group page has its own Shared XP switch, which then decides whether anyone in the group earns XP.