Leveling

​

Overview

​

Turning it on and setting the rate

!level enable <enabled>
!level xp <min> <max>
!level voice-xp <amount>
!level cooldown <seconds>

!level enable true
!level xp 15 25
!level voice-xp 5
!level cooldown 60

✅ Leveling enabled.

!level enable

!level xp

!level voice-xp

!level cooldown

​

The XP curve

!level curve [a] [b] [c] [difficulty] [rounding]
!level max-level <count>

!level curve 1 50 100 3 100
!level max-level 200

​

Notifications

!level notify <mode> [channel] [embed] [embed_template] [every] [message] [card] [reply] [delete_after] [ping] [milestone]
!level voice-notify <mode> [channel] [embed] [embed_template] [every] [message] [card] [delete_after] [ping] [milestone]

!level notify channel #level-ups --every 5
!level notify reply --message "{user} hit level {level}!"
!level notify reply --delete_after 30
!level notify reply --milestone 50 --message "{user} is level 50 and got {level_role}!"

!level notify channel --every 5

!level notify reply --message

!level notify reply --delete_after

!level notify --milestone

!level voice-notify

​

Examples

• Classic
• Progress
• Reward role
• Quiet DM
• Voice

Command

!level notify reply --message "{EMOJI} GG {user}, you just reached level **{level}**!"

Result

✦ GG @Liam, you just reached level 12!

Command

!level notify channel #level-ups --message "{user} is now level **{level}** (rank #{level_rank} of {level_rank_total}){newline}{level_bar} {level_xp_to_next} XP to level {level_next}"

Result

@Liam is now level 12 (rank #3 of 120)
▰▰▰▰▰▰▱▱▱▱ 930 XP to level 13

Command

!level notify reply --milestone 10 --message "🏅 {user} hit level 10 and unlocked {level_role}!"

Result

🏅 @Liam hit level 10 and unlocked @Regular!

{level_role} is empty on levels without a reward, so it fits best in a milestone.

Command

!level notify dm --message "You reached level {level} in {server_name}! Keep chatting 💬" --ping false

Result

(in DMs) You reached level 12 in Petto Land! Keep chatting 💬

Command

!level voice-notify reply --message "🎧 {user} reached voice level **{level}** after {level_voice_minutes} minutes in voice!"

Result

🎧 @Liam reached voice level 5 after 540 minutes in voice!

​

Variables

​

Rank and rankings

!rank [user] [type]
!top [page] [type] [period]
!level rank-style <style> [card]

!rank @Someone voice
!top 1 messages week
!level rank-style both myrank

!rank (card)

!rank @user voice

!rank (embed)

!rank (both)

!level rank-style

!top

!top 1 messages week

!top 1 voice

​

Public leaderboard page

• The page is at petto.sbs/lb/<name>. The name is the one you choose (2 to 32 letters, numbers or dashes), or the server ID if you leave it empty. It also exists as /es/lb/<name> and /pt-br/lb/<name>.
• It shows the top 500 by messages or by voice, 25 per page: name, picture, level and XP of each member. Nothing else of a member is shown, and a member who left appears as a former member.
• An optional Join button takes people to an invite of your choice (it has to start with https://).
• Turning the switch off makes the page answer “not public” at once.

​

Anti-abuse rules

!level rules [setting] [value]

!level rules
!level rules min_chars 5
!level rules anti_repeat on

!level rules

!level rules min_chars

!level rules anti_repeat

A value out of range

​

XP events

!level event add <name> <multiplier> <duration> [applies_to] [starts_in]
!level event list
!level event remove <id>

!level event add weekend 2 2d all
!level event add voicenight 1.5 6h voice 1d

!level event add

!level event add (later)

!level event list

!level event remove

​

Daily bonus and streaks

​

Voice leveling

!level voice-enable <enabled>
!level voice-curve [a] [b] [c] [difficulty] [rounding]
!level voice-max-level <count>
!level voice-role-mode <highest|all>
!level voice-ignore <channel>

!level voice-enable true
!level voice-curve 1 50 100 3 100
!level voice-max-level 300
!level voice-role-mode all
!level voice-ignore #AFK

!level voice-enable

!level voice-curve

!level voice-max-level

!level voice-role-mode

!level voice-ignore

• voice-enable turns leveling by voice time on or off (the amount per minute is !level voice-xp).
• voice-curve is the same formula as the XP curve, applied to voice, and its defaults are the same too (a=1, b=50, c=100, difficulty=2.5).
• voice-max-level is the highest voice level (default 1000).
• voice-role-mode says if members keep every voice reward role (all) or only the highest (highest, the default).
• voice-ignore toggles a voice channel, or a whole category, in or out of voice XP, like !level ignore does for text channels. Run it again to undo it.
• Voice levels have reward roles of their own: !level reward add 10 @Talker --type voice. See Level Rewards.

​

Who earns XP

!level ignore [channel] [role] [only_role]

!level ignore #bot-commands
!level ignore #Staff-area
!level ignore --role @Muted
!level ignore --only_role @Members

!level ignore (channel)

!level ignore (category)

!level ignore --role

!level ignore --only_role

• channel can be a channel or a category. Channels on the list, and every channel of a category on the list, grant no XP.
• role is a role whose members earn no XP.
• only_role picks the roles that are the only ones allowed to earn XP. With none picked, everyone can earn XP.

​

Members who leave and come back

!level rules restore_roles <on|off>
!level rules reset_on_leave <on|off>
!level manage sync

!level rules reset_on_leave on
!level manage sync

!level rules restore_roles

!level rules reset_on_leave

!level manage sync

• restore_roles (on by default): a member who returns gets back the reward roles their levels earned.
• reset_on_leave (off by default): the XP and level of a member who leaves are wiped. Off keeps them.
• manage sync checks every member who has a level and gives the reward roles they earned and do not have yet, for message and voice levels. It is for after adding rewards to a server that already has levels. It checks up to 2000 members each time, with a short pause, so run it again for the rest of a big server.

​

Join bonus

!level join [xp] [level]
!level sync-join

!level join 0 5

​

Manual XP/level management

!level manage xp <action> <user> <amount> [target]
!level manage level <action> <user> <amount>
!level reset <user>

!level manage xp add @Someone 500
!level manage xp transfer @A 200 @B

!level manage xp add

!level manage xp transfer

!level manage level

!level reset

​

Status

!level status

​

Related