Level Bot

Level Bot

Advanced leveling and reputation system with XP multipliers, role rewards, stat tracking, and a message-based reputation system. Keep your community engaged.

Core Features

Leveling System

  • Permanent Leaderboard: All-time XP tracking
  • Position Roles: Reward top performers automatically
  • Level Roles: Assign roles at specific levels
  • Stat Roles: Roles based on messages, media, reactions
  • Hourly Updates: Ranks recalculated every hour

Advanced XP System

  • Balanced: Carefully tuned quadratic leveling curve
  • Configurable Range: Set min/max XP per message (default 5-30)
  • Message Length XP: Optional word count scaling
  • Reaction XP: Optional XP for giving reactions (default 3-15)
  • Cooldown: Configurable per-user cooldown (default 60s)

XP Multipliers

  • Global: Server-wide XP multiplier
  • Channel: Boost specific channels
  • Role: VIP/Booster roles earn more
  • Hierarchy: Highest applicable multiplier wins
  • Flexible: Mix and match multiplier types

Analytics & Stats

  • Message Count: Track total messages sent
  • Media Tracking: Images, videos, files shared
  • Reactions Given: Track reactions added
  • Reactions Received: Track reactions received
  • Visual Progress: Neon-styled progress bars

Reputation System

  • Message-Based: Give rep by saying "thanks", "ty", "+rep"
  • Customizable: Custom regex, name, and cooldown
  • Rep Roles: Auto-assign roles at rep thresholds
  • Role Restrictions: Control who can give/receive rep
  • Admin Commands: Set, add, remove, transfer rep

Announcements

  • Templates: Customize with 10+ variables
  • Level-Up: Announce when users level up
  • Rank-Up: Announce when users climb ranks
  • Frequency: Announce every N levels/ranks
  • Role Filter: Only announce when roles are given

Access Control

  • Channel Lists: Whitelist or blacklist channels (up to 25)
  • Role Lists: Control who earns XP by role
  • Ignore Images: Skip image-only messages
  • Max Level: Set maximum achievable level
  • Opt-Out: Users can opt out of tracking

Modern UX

  • Components v2: Beautiful container-based UI
  • Progress Bars: Neon-styled visual XP display
  • Leaderboard: Top 10 with medals for top 3
  • Ephemeral Setup: Private admin configuration
  • Slash Commands: Intuitive modern commands

Commands

User Commands

/level [user]

View rank card with level, XP, rank, and a visual progress bar.

/leaderboard

View the server leaderboard showing top 10 users by XP with medals for the top 3.

/stats [user]

View detailed statistics: messages sent, media shared, reactions given, and reactions received.

/opt-out

Toggle opt-out from the leveling and reputation system. When opted out, no XP, stats, or rep are tracked.

/help

View all available commands grouped by category.

Reputation Commands

/rep user [user]

Check a user's reputation points.

/rep leaderboard

View the top 20 users by reputation.

/rep set <user> <amount>

Set a user's rep to a specific amount. Requires Rep Admin.

/rep add <user> <amount>

Add rep to a user. Requires Rep Admin.

/rep remove <user> <amount>

Remove rep from a user. Requires Rep Admin.

/rep reset <user>

Reset a user's rep to 0. Requires Rep Admin.

/rep transfer <source> <target> <amount>

Transfer rep between users. Requires Rep Admin.

/rep config

Open the reputation configuration panel. Requires Server Administrator.

Rep Admin: Users with Server Administrator permission or any role in the configured admin roles list.

Admin Commands

/setup

Comprehensive setup interface (Administrator only) with 4 configuration panels:

General Settings

  • XP range and cooldown
  • Global multiplier and max level
  • Toggle leveling on/off
  • XP modes (image, length, reaction)

Announcements & Users

  • Level-up and rank-up messages
  • Template variables
  • Set user XP/level directly
  • Reset user data or leaderboard

Channels & Roles

  • Channel whitelist/blacklist
  • Role whitelist/blacklist
  • Up to 25 channels/roles each

Role Rules & Multipliers

  • Level, position, and stat-based roles
  • Stack or replace on rank-up
  • Channel and role multipliers

/sync

Manually resync all role assignments. Useful after config changes.

Getting Started

1. Invite the Bot

Add Level Bot to your server. Needs Manage Roles, Read Messages, Send Messages, and Attach Files permissions.

2. Run /setup

Use /setup to open the interactive configuration panel. All settings are managed through this interface.

3. Configure XP

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

4. Set Up Channels & Roles

Whitelist to only allow XP in specific channels, or blacklist to exclude channels. Same for roles.

5. Configure Role Rewards

Set up level-based, position-based, or stat-based roles. Choose whether roles stack or replace.

6. Customize Announcements

Configure level-up and rank-up messages with template variables. Set frequency and channel.

7. Enable Reputation

Use /rep config to enable the reputation system. Customize trigger words, cooldowns, and reward roles.

8. Test & Monitor

Use /level, /leaderboard, and /stats to verify everything works.

Reputation System

A message-based system where users give rep by thanking others

How It Works

When a user sends a message matching the trigger pattern while mentioning or replying to someone, the target receives a reputation point.

Default Trigger Words

  • thanks / thank
  • ty / thx
  • +rep
  • danks

Rules

  • Must mention or reply to someone
  • Cannot give rep to yourself
  • Per (giver, receiver) cooldown (default 24h)
  • Bot reacts with ✓ on success

Configuration Options

  • Name: Custom display name for rep points
  • Cooldown: Minutes between giving rep to the same user (default 1440)
  • Regex: Custom detection pattern for trigger words
  • Channel Whitelist/Blacklist: Control where rep can be given (supports categories)
  • Give/Receive Role Restrictions: Control who can give or receive rep
  • Admin Roles: Roles that can use admin rep commands
  • Reward Roles: Auto-assign roles when rep reaches thresholds

XP & Leveling Formulas

XP Gain Per Message

Standard: Random between xp_min and xp_max (default: 5-30 XP)

Message Length XP: Based on unique word count (0 words = min, 50+ words = max range)

Cooldown: Configurable (default: 60 seconds)

Final XP: Base XP × highest applicable multiplier (global, channel, or role)

Level Calculation

XP required for Level N: 50 × N² + 125 × N

Level 1: 175 XP • Level 5: 1,875 XP • Level 10: 6,250 XP • Level 50: 131,250 XP

Reaction XP

When enabled, users earn 3-15 XP for reacting to other users' messages. Messages must be less than 1 hour old. Self-reactions don't count. Separate cooldown from message XP.

Message Length XP Tiers

When message length XP is enabled, XP scales with unique word count:

  • 0 words: Minimum XP
  • 1-5 words: 30% of XP range
  • 6-15 words: 50% of range
  • 16-30 words: 70% of range
  • 31-50 words: 85% of range
  • 50+ words: Full XP range

A ±20% variance is applied for randomness.

Announcement Variables

Template Variables

User

{user} - Username

{user.mention} - @mention

{user.name} - Display name

{user.id} - User ID

{user.avatar} - Avatar URL

Server & Progress

{server.name} / {guild.name} - Server name

{guild.id} - Server ID

{guild.icon} - Server icon URL

{level} - New level

{xp} - Total XP

{rank} - Current rank (rank-up only)

Default level-up: {user.mention} reached level {level}!

Default rank-up: {user.mention} reached rank {rank}!

Announcement Filters

  • Frequency: Announce every N levels (e.g., every 5 levels)
  • Role Rewards Only: Only announce when a role is granted
  • Custom Channel: Send announcements to a specific channel
  • Duplicate Prevention: Tracks last announced level per user

Role Reward Types

Level Roles

Assigned when a user reaches a specific level. Example: Level 10 = "Intermediate" role.

Checked in real-time on level-up.

Position Roles

Assigned to top N users on the leaderboard. Example: Top 5 = "Elite" role.

Updated every hour by the scheduler.

Stat Roles

Based on message count, media shared, reactions given, or reactions received.

Checked in real-time on each message.

Stack vs Replace

Stack (default): User keeps all earned roles from the same type.

Replace: When a user qualifies for a higher-tier role, the lower-tier role is removed.

Example (replace): User reaches Level 20 and gets "Advanced" role. The "Intermediate" role from Level 10 is automatically removed.

FAQ

Can I reset a user's level or XP?

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

How do I reset the entire leaderboard?

Use the "Reset Leaderboard" button in /setup. You can do a partial reset (e.g., remove 50% XP) or a full reset.

Whitelist vs Blacklist difference?

Whitelist: ONLY listed channels/roles earn XP. Blacklist: Listed channels/roles do NOT earn XP.

How do multipliers work?

The highest applicable multiplier wins. If you have a 2x global, 1.5x channel, and 1.2x role multiplier, the final multiplier is 2x (the highest).

How are position roles handled?

Ranks are recalculated every hour. When a user enters the top N, they get the role. When someone falls out, the role is removed.

Can users opt out?

Yes. Users can run /opt-out to stop all XP, stat, and rep tracking. They can toggle it back on at any time.

How does reputation work?

Users give rep by saying trigger words (like "thanks" or "ty") while mentioning or replying to someone. There's a 24-hour cooldown per (giver, receiver) pair.

Need Help?

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