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.