The Levels feature allows you to track member activity through text and voice channels, rewarding engagement with custom roles and messages. Members can earn XP through messages and voice activity.
You can find all the variables in the /resources/variables page. You can use these variables on your levels message

​
Requirements

  • Server must have at least one text channel for level messages
  • Bot must have permissions to:
    • Send messages
    • Embed links
    • Manage roles (for level rewards)
    • View channels
    • Connect to voice channels

​
Setup

​
Enable Leveling

,levels setup

​
Set Level Message Channel

,levels channel <channel>

​
Customize Level Message

,levels message <message>

​
Test Level Message

,levels message test

​
Level Rewards

​
Add Level Role

,levels role <level> <role>

​
Remove Level Role

,levels role remove <level>

​
List Level Rewards

,levels list

​
Voice Leveling

​
Enable Voice Leveling

,levels voice enable

​
View Voice Settings

,levels voice settings

​
Stats & Leaderboard

​
View User Stats

,levels stats [user]

​
View Leaderboard

,levels leaderboard [total|text|voice] [limit]

​
Variables

​
Level Message Variables

  • {user} - User object
  • {user.mention} - User mention
  • {user.name} - Username
  • {level} - New level
  • {guild} - Server object
  • {channel} - Channel object

​
Voice Leveling Settings

  • XP per minute: 5 (default)
  • Max XP per session: 100 (default)
  • Minimum voice time: 1 minute (default)
  • Level roles are automatically assigned when members reach the required level
  • Voice XP is awarded every minute while in voice channels
  • Leaderboard data is cached for 5 minutes
  • User stats are cached for 5 minutes
Make sure the bot’s role is above any level reward roles to ensure proper role assignment.