Leveling System

Raptor includes a robust leveling system that rewards user activity with XP and rank roles.

XP Gain

Users gain 5 XP per eligible message in a whitelisted channel or category.
There is a global XP cooldown (default 60 seconds) between grants for the same user. Messages sent during the cooldown do not award XP or count toward the leveling message counter.
Cooldown is configured via leveling_xp_cooldown_sec in settings.json or the LEVELING_XP_COOLDOWN_SEC environment variable. Set to 0 to disable (not recommended on large fleets).

You can manage the following leveling settings via the Web Dashboard:

Enable/Disable: Globally toggle the leveling system for your server.
Notifications: Enable or disable the "Congratulations" message when a user levels up.
Commands: Enable or disable ranking commands like /rank and /leaderboard.
Custom Level Up Message: Set a custom message with placeholders like {user} and {level}.
XP Gain Whitelists:
- Channels: Specify individual channels where users gain XP.
- Categories: Whitelist entire categories to gain XP in all contained channels.
Rank Rewards: Map levels to specific roles that users will automatically receive.

Command	Description
`/rank`	Displays your current level, XP, and rank. (Can be disabled in dashboard)
`/leaderboard`	Shows the top 10 most active members. (Can be disabled in dashboard)
`!lvlnotifymethod <method>`	Changes notification method (`mention` or `none`).

Command	Description
`!addlevelchannel <#channel>`	Adds a channel to the XP whitelist.
`!removelevelchannel <#channel>`	Removes a channel from the XP whitelist.
`!addlevelcategory <category>`	Adds an entire category to the XP whitelist.
`!removelevelcategory <category>`	Removes a category from the XP whitelist.
`!alllevelchannels`	Lists all whitelisted channels.
`!alllevelcategories`	Lists all whitelisted categories.
`!addrankrole <level> <@role>`	Assigns a role to be given at a specific level.
`!alllevelroles`	Lists all rank-based roles.