Levels

Levels turns activity into a number, and the number into roles. The parts most servers configure are on the Overview tab: where level-ups are announced, which roles are rewards, and what the rank card looks like. The refinements sit on XP & Levels, Multipliers & Limits, Announcements, Leaderboard, Settings and Commands.

1Getting started

1. 1

   Switch it on

   Onboarding & Access → Levels. XP starts accruing immediately.

2. 2

   Decide where level-ups are announced

   The channel it happened in, one fixed channel, a DM, a fixed channel and a DM, or nowhere at all.

3. 3

   Add role rewards

   Pick a level and the roles it unlocks (up to 20 rewards, 3 roles each). Arclo's role must sit above every reward role.

4. 4

   Design the rank card

   Optional: the default is a good card. The studio is the same one the banners use.

How XP is earned

XP rate

One dial, from 0.25× to 5×, that multiplies every award from every source. Below 1× leveling gets slower; above it, faster.

Message XP

How messages are paid: a Random amount between two numbers (15 to 25 by default), XP per word (each word of 3 letters or more, up to a cap per message; mentions and emoji don't count), or None. A per-member Cooldown (60 seconds by default) stops a member farming XP by spamming.

Voice XP

On by default: a random 5 to 15 XP every 3 minutes of qualifying time. Only time that meets the rules below counts, so a member who mutes for an hour comes back to exactly the session they left.

Reaction XP

Off by default. Who earns from a reaction: the message's author, whoever reacted, or both, with its own cooldown (5 minutes by default).

Where else XP counts

Threads, Forum posts and Voice channel chat pay like ordinary channels, each with its own switch. Slash commands (any bot's) is off by default; on, a command earns the message minimum and shares the message cooldown.

Multipliers and limits

The Multipliers & Limits tab decides what multiplies XP and what withholds it.

Channel multipliers

Up to 10 channels, forums or whole categories, each with its own rate: 100% is normal, 200% is double, 0% pays nothing. A voice channel's rate covers time in it and its chat.

Role multipliers

Up to 10 roles that earn faster or slower, for staff, subscribers or an event. This is how server boosters earn at a higher rate: give Discord's booster role a multiplier.

Stack multipliers

Off by default, so only the largest multiplier that applies counts. On, they add together: a +10% channel and a +25% role make +35%.

Effort bonus

Off by default. Pays extra for a long message (12 words or more: +25%) and for an image or attachment (+15%), capped together at +100%.

Rate limit

Off by default. A ceiling on paid messages per window (10 every 60 seconds when switched on), on top of the cooldown. Messages beyond it still send; they just stop paying.

Who can earn XP

Everyone except these roles (the default, a classic no-XP list) or Only these roles, up to 25 roles.

Where XP can be earned

Every channel except these (the default) or Only these channels, up to 25. A category covers its channels, and threads count toward the channel they are in. The list gates messages, reactions and voice time alike, so an only these list with no voice channel in it switches voice XP off.

Curves

The curve decides what each level costs, in one of 5 shapes, with Linear as the default. The dashboard previews the actual level thresholds as you change it, so you can see what level 50 will cost before you commit.

Multiplier (0.25× to 5×) scales the whole curve without changing its shape. Max level stops leveling where you choose (0 is no cap, up to 1,000); members past it keep earning XP and keep their place on the leaderboard.

Role rewards

• A reward is a level and up to 3 roles, and a server can set up to 20. Members reaching that level get them.
• Rewards reconcile rather than accumulate. Every level change re-checks the whole ladder, so a member who gains ten levels at once gets everything they passed, and with Take reward roles back when a member loses XP on (the default) a member who drops below a reward's level loses that role.
• When a member reaches a new reward decides whether the ladder stacks (Keep the earlier roles, the default) or each new role replaces the last (Replace them).
• A First place role follows whoever currently tops the leaderboard, and moves within a few minutes when that changes.

Announcements

Send the message to

The channel they were active in (the default), a fixed channel, a DM, a fixed channel and a DM, or off. A level reached by reactions or voice has no channel of its own: in the default mode it goes to an optional Fallback channel, or is skipped without one, and Post voice level-ups in the voice channel's chat sends voice ones to that channel's chat instead.

Announce every and Minimum level

Announce only every few levels (a reward level always speaks, whatever the interval), and nothing below a level you choose: the early grind is noisy.

Delete after

Removes the announcement 10 seconds to 10 minutes after it is posted. Keep the message by default.

Only announce reward levels

Stay silent unless the level actually unlocked a role.

Message

The full message editor on the Announcements tab, with {level}, {total_xp}, {rank} and {reward} among the placeholders below.

Banner

A picture attached to the level-up. The member's avatar, the level they left and the one they reached, and their rank. On by default, designed with the rank card's own tools (layouts, the banner library, uploads, recolor, the studio), and placed in the message's image slot unless you put {banner} somewhere yourself.

Reward message

Off by default. A second, differently-worded message sent alongside the level-up when a level unlocks a role. Without it, put {reward} in the level-up message to name the role.

Highlights

A weekly or monthly recap of the ten most active members, each switched on with its own channel on the Leaderboard tab. Weekly posts early on Monday and monthly on the 1st (UTC). It reports the period that just finished, as the same top-10 board image /leaderboard posts, wearing your Leaderboard banner, with {leaderboard} still available for a text list. Rank by picks XP, messages, voice time or reactions, one or several per recap: with several, the post opens on the one Shown first and a menu on it switches between them for 90 days. Messages count the ones that earned XP, and voice time only what passed the voice XP rules. Mention the members pings the members on the board the post opens on.

#general

ArcloBOTToday at 12:00 PM

@Kito

Congratulations Kito!

@Kito just reached level 7 in Nebula Collective.

Today at 12:00 PM

Level-up placeholders

The highlights message has its own besides: {leaderboard_image}, {leaderboard}, {period}, {period_phrase}, {ranked_by} and {top_member}.

Cards and the leaderboard

• Rank cards are drawn by the same renderer in your browser and in the bot. Pick a layout (Classic, Compact or Spotlight), a background from the library beside the card or a Custom image, and Recolor it to any hue; Edit opens the studio, where every part of the card is a layer you can move.
• Show total XP is a switch, off by default. A card showing only within-level progress (25 / 175) is otherwise read as the member's entire XP.
• `/leaderboard` posts the top ten as a rendered image wearing the Leaderboard banner you design on the Leaderboard tab, with a dropdown that switches between all time, this week, this month, messages, voice time and (while reaction XP is on) reactions, and a link to the web board.
• Public leaderboard (Leaderboard tab, on by default) is a web page anybody can open without Discord or a login. Custom address gives it a vanity URL, and Hide who's on it shows ranks, levels and XP without names or avatars. Switched off, /leaderboard drops its link. The page closes while Levels is switched off.
• It can also live as a pinned message Arclo rebuilds every 15 minutes.
• Members can design their own rank card: every /rank card carries a Change Background button that opens the card studio on the website, unless you switch Let members design their own card off under the rank card. See Your cards.

Settings

• XP management: browse every ranked member, give or take XP, set their XP or level, reset one member or everybody. These edits save straight away.
• When a member leaves: Reset their level and XP is off by default, so a returning member picks up where they left off.
• Logging: level-ups, reward roles (and ones Arclo could not give), first-place changes, XP edits, resets and posted highlights, through the Levels logger.

Commands

Troubleshooting