Level Bot Icon

Level Bot

Advanced leveling system for Discord with triple leaderboards, XP multipliers, role rewards, and comprehensive analytics. Keep your community engaged and motivated.

Not affiliated with Discord Inc.

Core Features

Triple Leaderboard System

  • Weekly Leaderboard: Resets every Monday at midnight UTC
  • Seasonal Leaderboard: Resets every 3 months
  • Permanent Leaderboard: All-time tracking that never resets
  • Position-Based Roles: Reward top performers automatically
  • Automatic Resets: Scheduled maintenance handled by the bot

Advanced XP System

  • Balanced Progression: Carefully tuned leveling curve
  • Configurable XP Range: Set min/max XP per message (default: 5-30)
  • Message Length Scaling: Optional unique word count system
  • Reaction XP: Optional rewards for giving reactions (3-15 XP)
  • Cooldown System: Configurable cooldown (default: 60s)
  • System Toggle: Enable/disable leveling per server

XP Multiplier Engine

  • Global Multiplier: Server-wide XP boost (e.g., 2x XP weekend)
  • Channel Multipliers: Reward specific channels with higher XP
  • Role Multipliers: VIP/Booster roles earn more XP
  • Smart Hierarchy: Choose highest multiplier OR role hierarchy
  • Flexible Configuration: Mix and match multipliers

Event Tracking & Analytics

  • Message Count: Track total messages sent
  • Media Tracking: Count images, videos, and files
  • Reaction Analytics: Track reactions given AND received
  • /stats Command: View detailed user statistics
  • Beautiful Containers: Clean UI for all statistics

Level Up Announcements

  • Template Messages: Customize with 10+ variables
  • Flexible Destinations: Same channel, custom channel, DM, or disable
  • Smart Filters: Announce specific levels, minimum threshold, or every X levels
  • Role Reward Filter: Announce only when roles are given
  • No Spam: Tracks last announced level

Role Management System

  • Level-Based Roles: Assign roles at specific levels
  • Position-Based Roles: Assign to top leaderboard performers
  • Per-Leaderboard Rules: Different rules for each leaderboard
  • Automatic Cleanup: Roles removed when no longer qualified
  • Flexible Configuration: Mix level and position rules

Access Control

  • Channel Whitelist/Blacklist: Control XP-earning channels (up to 25)
  • Role Whitelist/Blacklist: Control which roles earn XP (up to 25)
  • Ignore Images: Optionally ignore image-only messages
  • Max Level Cap: Set maximum achievable level
  • Spam Prevention: Built-in cooldown system

Modern User Experience

  • Discord Components v2: Beautiful container-based UI
  • Progress Bars: Visual XP progress in rank cards
  • Leaderboard Pages: Clean 10-user pages with medals
  • Ephemeral Setup: Admin commands are private
  • MongoDB Backend: Fast, reliable, scalable

Commands

User Commands

/level [user]

View rank card with level, XP, and progress bar. Defaults to yourself if no user specified.

/leaderboard [type]

View server leaderboard. Choose from:

  • Weekly: Current week's top performers
  • Seasonal: Current season's rankings
  • Permanent: All-time leaderboard

Shows 10 users per page with medals for top 3 positions

/stats [user]

View detailed statistics including messages sent, media shared, reactions given/received, and more.

Admin Commands

/setup

Comprehensive setup interface (Administrator only) with the following sections:

General Settings

  • Set maximum level cap
  • Toggle leveling system on/off

XP Settings

  • Ignore image-only messages
  • Enable message length XP scaling
  • Enable reaction XP rewards
  • Configure XP range (min/max)
  • Set XP cooldown duration

User Management

  • Set user XP directly
  • Set user level directly
  • Reset specific user data

Leaderboard Management

  • Reset weekly leaderboard
  • Reset seasonal leaderboard
  • Reset permanent leaderboard

Channel Management

  • Add/remove whitelisted channels
  • Add/remove blacklisted channels
  • View channel lists (up to 25 each)

Role Management

  • Add/remove whitelisted roles
  • Add/remove blacklisted roles
  • View role lists (up to 25 each)

Role Rules

  • Add level-based role rewards
  • Add position-based role rewards
  • Remove role rules
  • View all role rules

Announcements

  • Set announcement channel
  • Configure announcement message
  • Set announcement filters
  • Toggle announcements on/off

XP Multipliers

  • Set global multiplier
  • Add/remove channel multipliers
  • Add/remove role multipliers
  • Configure multiplier hierarchy

Setup & Configuration

1. Invite the Bot

Add Level Bot to your server. The bot needs Read Messages, Send Messages, and Attach Files permissions.

2. Run /setup

Use /setup to access the comprehensive configuration interface. All settings are managed through this one command.

3. Configure XP Settings

Set your XP range, cooldown, and enable optional features like message length scaling or reaction XP.

4. Set Up Channels

Use whitelist to only allow XP in specific channels, or blacklist to exclude certain channels from XP gain.

5. Configure Role Rewards

Set up level-based roles (e.g., "Level 10" role at level 10) or position-based roles (e.g., "Top 10" for top 10 on leaderboard).

6. Customize Announcements

Set where and how level-up announcements appear. Use template variables to personalize messages.

7. Add XP Multipliers (Optional)

Boost engagement with channel-specific or role-specific XP multipliers. Perfect for events or VIP perks.

8. Test & Monitor

Use /level and /leaderboard to test the system. Monitor engagement and adjust settings as needed.

XP & Leveling Formulas

XP Gain Per Message

Base XP: Configurable min-max range (default: 5-30 XP)

Optional Message Length XP: 5-120 XP based on unique word count

Cooldown: Configurable (default: 60 seconds between XP gains)

Final XP: Base XP Global Multiplier Channel Multiplier Role Multiplier

Example:

Base: 20 XP (random between 5-30)

Global Multiplier: 2x (weekend event)

Channel Multiplier: 1.5x (active-chat channel)

Role Multiplier: 1.2x (booster role)

Final XP: 20 2 1.5 1.2 = 72 XP

Level Calculation

XP Required Per Level: 75 + (level 100)

Total XP for Level N: 50 level + 125 level

Examples:

Level 1: 175 XP total

Level 5: 1,875 XP total

Level 10: 6,250 XP total

Level 19: ~20,000 XP total

Level 50: 131,250 XP total

Reaction XP (Optional)

When enabled, users earn 3-15 XP for giving reactions to messages.

Cooldown system applies to prevent spam.

Level Up Announcements

Template Variables

Customize your level-up messages with these placeholders:

User Variables

{user} - Username

{user.mention} - @mention

{user.tag} - Username#0000

{user.id} - User ID

{user.avatar} - Avatar URL

Server & Progress

{guild.name} - Server name

{guild.id} - Server ID

{guild.icon} - Server icon URL

{level} - New level

{xp} - Total XP

Example Message:

Congratulations {user.mention}! You've reached level {level}! <

Announcement Filters

  • Specific Levels: Only announce at levels 10, 25, 50, etc.
  • Minimum Level: Only announce level 5 and above
  • Every X Levels: Announce every 5 levels (5, 10, 15, 20...)
  • Role Rewards Only: Only announce when a role is granted
  • No Duplicates: Bot tracks last announced level to prevent spam

Common Use Cases

Gaming Communities

Reward active players with XP, give top leaderboard positions special roles, and run weekly competitions with the weekly leaderboard.

Study Groups

Encourage participation in study channels with XP multipliers. Reward consistent learners with level-based roles.

Content Creator Servers

Boost engagement with XP multipliers for boosters. Use position-based roles for top supporters.

Event Servers

Run time-limited competitions using the weekly or seasonal leaderboards. Reset after events end.

Professional Communities

Track contribution with the permanent leaderboard. Reward active members with special access roles.

Friend Groups

Add fun gamification to keep friends engaged. Use funny role names for different levels.

Frequently Asked Questions

How do the three leaderboards work?

Weekly resets every Monday, Seasonal resets every 3 months, and Permanent never resets. Each tracks XP independently, so users can compete in all three simultaneously.

Can I reset a user's level or XP?

Yes! Use the "User Management" section in /setup to set XP, set level, or completely reset a user's data.

What's the difference between whitelist and blacklist?

Whitelist: ONLY listed channels/roles earn XP. Blacklist: Listed channels/roles do NOT earn XP. Don't use both simultaneously.

How do XP multipliers stack?

All multipliers multiply together. A 2x global, 1.5x channel, and 1.2x role = 3.6x total multiplier.

Can I import data from other leveling bots?

Not currently, but you can manually set user levels/XP through the /setup command if needed.

How are position-based roles handled?

The bot checks leaderboard positions periodically. If someone falls out of the top N, their role is removed. If someone enters top N, they get the role.

Technical Details

Architecture

  • Modular Design: Separate cogs for XP, database, events, commands, and scheduling
  • MongoDB Backend: Fast, scalable NoSQL database
  • Async Operations: Non-blocking operations for performance
  • Scheduled Tasks: Weekly and seasonal resets automated
  • Image Generation: On-the-fly rank card creation

Performance

  • Optimized Queries: Indexed database fields for fast lookups
  • Caching: Frequently accessed data cached in memory
  • Efficient XP Calculation: Mathematical formula instead of iteration
  • Rate Limiting: Cooldown system prevents spam and reduces load

Need Help?

Join our support server for assistance, feature requests, and to see Level Bot in action!

Join Support Server View All Bots

Not affiliated with Discord Inc.