Leveling System

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

Dashboard Configuration

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.

Commands

User Commands

CommandDescription
/rankDisplays your current level, XP, and rank. (Can be disabled in dashboard)
/leaderboardShows the top 10 most active members. (Can be disabled in dashboard)
!lvlnotifymethod <method>Changes notification method (mention or none).

Administrator Commands

CommandDescription
!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.
!alllevelchannelsLists all whitelisted channels.
!alllevelcategoriesLists all whitelisted categories.
!addrankrole <level> <@role>Assigns a role to be given at a specific level.
!alllevelrolesLists all rank-based roles.