Leveling System

Configure XP rewards, rank cards, and role progression for your server.

Leveling System

Veronica’s leveling system rewards active members with XP, custom rank cards, and automatic role assignments. This guide covers setup, configuration, and customization options.

Overview

The leveling system includes:

• Automatic XP Gain: Earn XP by sending messages
• Custom Rank Cards: Personalized level-up displays
• Role Rewards: Auto-assign roles at specific levels
• Leaderboards: Track top contributors

The leveling system is enabled by default and tracks activity across all text channels.

Basic Commands

View Rank

# Check your current level and XP
/rank
,rank

# Check another user's rank
/rank user:@Member
,rank @Member

XP Configuration

Earning Rates

Configure how users gain experience:

Activity	XP Gain	Cooldown
Text Message	15-25 XP	60 seconds
Voice Chat (per minute)	5-10 XP	None
Reactions	1-3 XP	30 seconds

XP values are randomized within the range to prevent gaming the system.

XP Multipliers

Boost XP gain for specific roles or channels:

Role Multiplier

# Give boosters 2x XP
/xpmultiplier role:@Booster multiplier:2.0

Role Rewards

Automatically assign roles when members reach specific levels:

1. Establish Thresholds

   Set up roles for different level milestones (e.g., Level 5, Level 10, Level 25).

2. Map Level Roles

   Link roles to level thresholds using the command suite.

   /levelrole add level:5 role:@Active Member
   /levelrole add level:10 role:@Regular
   /levelrole add level:25 role:@Veteran
   

   Role mapping successfully stored.
3. Validate Hierarchy

   Ensure Veronica can manage these roles.

4. Verification Test

   Use /setlevel to test role assignments at different levels.

Next Steps

Card Customization

Design unique rank cards for your community.

Economy Integration

Combine leveling with virtual rewards.

Ensure Veronica’s role is above the reward roles in your server’s role hierarchy, or it won’t be able to assign them.

Rank Card Customization

Personalize your rank card appearance:

Set Background

# Upload custom background image
/rankcard background [image_url]

Leaderboard Features

Server Leaderboard

View top 10 members by XP in your server.

/leaderboard

Global Leaderboard

See top contributors across all servers.

/globalleaderboard

Advanced Configuration

Disable Leveling in Channels

Prevent XP gain in specific channels (e.g., spam channels):

/leveling ignore channel:#spam

Level-Up Announcements

Configure where level-up messages are sent:

/leveling announce channel:#level-ups
/leveling announce disable

XP Decay

Enable XP loss for inactive members:

/leveling decay enable days:30 percent:10

Import/Export Data

Migrate leveling data from other bots:

/leveling import [file]
/leveling export

Level Calculation

XP required for each level increases exponentially:

Level 1: 100 XP
Level 2: 255 XP
Level 3: 475 XP
Level 5: 1,225 XP
Level 10: 5,525 XP
Level 25: 33,525 XP
Level 50: 133,525 XP

Formula: XP = 5 * (level^2) + (50 * level) + 100

Best Practices

Balanced Progression

Set role rewards at achievable intervals (every 5-10 levels) to maintain engagement.

Exclusive Perks

Give high-level roles access to exclusive channels or features.

Regular Recognition

Announce level milestones in a dedicated channel to celebrate achievements.

Fair Multipliers

Keep XP multipliers reasonable (1.5x-2x max) to avoid imbalance.

Combine the leveling system with economy rewards: give Vero Bucks to users who reach certain levels!