Levels

Leveling is disabled by default, because tracking every message isn’t something a server should opt into by accident.

/config toggle levels enabled:True

How XP works

Setting	Default	Meaning
XP per message	15–25	A random amount in that range
Cooldown	60 seconds	Per member, across the whole server
Curve	`50 × level^1.6`	XP needed to reach a level

Level 1 costs 50 XP, level 10 costs about 1,995, level 25 about 8,700, level 50 about 26,000. The curve is progressive, so early levels arrive quickly and later ones take real activity. Bots never gain XP, and messages only count while Leveling is enabled.

Commands

Command	What it shows
`/level [member]`	Rank card: level, total XP, progress into the level, server rank, rendered as an image with a progress bar
`/ranks`	Leaderboard of the top 100, paginated ten per page

Rewards

/levelreward set 5 @Active
/levelreward set 25 @Regular
/levelreward list
/levelreward remove 25
/levelreward setxp @member 5000

When a member levels up, Criminal checks the reward table and grants the matching role. Roles it can’t assign · anything at or above its own top role · are refused when you set them up rather than silently failing later. /levelreward setxp overwrites a member’s XP outright; the reply confirms the level that XP maps to.

A reward role is added when the level is reached. If you later change the reward table, members keep roles they already earned · clearing those is a normal /role remove job.

Announcements and DMs

Both messages are templates and both accept embed scripts:

/config channel levelup-channel #level-ups
/config text    levelup-message "{user} hit level {level}!"
/config toggle  level-announcements enabled:True

Setting	Default	Notes
Chat announcement	Off	Posts only in `levelup-channel`; nothing posts until one is set
Level-up DM	On	Turn off with `/config toggle levelup-dms enabled:False`
DM message	Built-in	Edit with `/config text levelup-dm-message "Congrats {user}, level {level}!"`

If the member has DMs closed, the DM silently fails and the chat announcement still posts.

Get started

Setup

Modules

Commands

Configuration

Resources

How XP works

Commands

Rewards

Announcements and DMs

​How XP works

​Commands

​Rewards

​Announcements and DMs

How XP works

Commands

Rewards

Announcements and DMs