# ---------------------------------------------------------------
# Leveling System Addon Configuration
# ---------------------------------------------------------------
XP:
MinPerMessage: 15 # Minimum XP users get per message
MaxPerMessage: 25 # Maximum XP users get per message (random between min/max)
Cooldown: 60000 # Time in MILLISECONDS (60000 = 1 minute, 30000 = 30 seconds)
VoiceXPPerMinute: 10 # How much XP users earn per minute in voice channels
VoiceXPCooldown: 60000 # How often to give voice XP (60000 = every 1 minute)
DeleteDataOnLeave: false # true = delete all user data when they leave the server, false = keep their data if they rejoin
LevelCalculation:
Formula: "xp-based" # "xp-based" = gets harder each level (like MEE6), "linear" = same XP needed each level
BaseXP: 100 # Starting XP needed for level 1
Multiplier: 1.5 # How much harder each level gets (1.5 = 50% harder, 2.0 = twice as hard)
Multipliers:
Enabled: true # Turn on/off XP multipliers
Roles:
- RoleID: "ROLE_ID_HERE" # Replace with your role ID
Multiplier: 1.5 # Users with this role get 50% more XP (1.5 = +50%, 2.0 = +100%)
- RoleID: "ROLE_ID_HERE_2"
Multiplier: 2.0 # This role gets double XP
Boosters:
Enabled: true # Give Nitro Server Boosters bonus XP
Multiplier: 1.25 # Nitro Boosters get 25% more XP
IgnoredChannels: [] # Channels where users won't earn XP (add channel IDs like: ["123456789", "987654321"])
IgnoredCategories: [] # Channel categories where users won't earn XP - ignores ALL channels in the category (add category IDs like: ["123456789", "987654321"])
IgnoredRoles: [] # Users with these roles won't earn XP (add role IDs like: ["123456789", "987654321"])
LevelUpMessages:
Enabled: true # Show a message when users level up
Type: "embed" # "embed" = fancy embed, "text" = simple text message, "dm" = send to user's DMs
Channel: "same" # Where to send: "same" = same channel as message, "dm" = user's DMs, or paste a channel ID
DeleteAfter: 0 # Auto-delete the level-up message after X seconds (0 = never delete)
Embed:
Title: "⚡ LEVEL UP!"
Description: "### {mention} reached **Level {level}**! 🎊\n\n> 💫 **Current XP:** `{xp}` XP\n> 🎯 **Next Level:** `{xpNeeded}` XP needed\n> 🚀 **Keep going!**"
Color: "#00d4ff" # Hex color code for the embed
Thumbnail: "user" # "user" = show user's avatar, "server" = server icon, or paste an image URL
CustomThumbnailURL: "" # Paste an image URL here if you chose a custom thumbnail above
Footer:
Enabled: true # Show footer text at the bottom
Text: "🌟 You're doing great! Keep chatting to level up faster"
CustomIconURL: "" # Optional: Add a small icon next to footer text
Timestamp: true # Show the current time in the embed
TextMessage: "🎉 Congratulations {mention}! You've reached **Level {level}**!" # Message shown if Type is set to "text"
RoleRewards:
Enabled: true # Automatically give roles when users reach certain levels
StackRoles: false # false = remove old level roles when leveling up, true = keep all level roles
Rewards: # You can add unlimited
- Level: 5 # When user reaches level 5...
RoleID: "ROLE_ID_HERE" # ...give them this role (replace with your role ID)
- Level: 10
RoleID: "ROLE_ID_HERE"
- Level: 15
RoleID: "ROLE_ID_HERE"
- Level: 20
RoleID: "ROLE_ID_HERE"
- Level: 30
RoleID: "ROLE_ID_HERE"
- Level: 50
RoleID: "ROLE_ID_HERE"
Leaderboard:
UsersPerPage: 10 # How many users to show per page
Embed:
Title: "🏆 Server Leaderboard"
Color: "#ffd700" # Hex color code
Footer:
Enabled: true
Text: "📄 Page {page} of {totalPages} • Updated just now"
CustomIconURL: "" # Optional: Add a small icon next to footer text
Timestamp: true
RankCard:
Enabled: true # Allow users to view rank cards
ShowRank: true # Show user's rank position on the leaderboard
ShowLevel: true # Show user's current level
ShowXP: true # Show user's XP numbers
ShowProgressBar: false # Show visual progress bar to next level
Image:
Enabled: true # Generate dynamic rank card images
Width: 934 # Image width in pixels
Height: 282 # Image height in pixels
BackgroundColor: "#2b2d31" # Main background color
ProgressBarColor: "#5865f2" # Discord blurple - left side of gradient
ProgressBarBackground: "#1e1f22" # Dark background for empty progress
TextColor: "#ffffff" # White text color
AccentColor: "#00d4ff" # Cyan accent color - right side of gradient
Embed:
Title: "" # Leave empty for cleaner look
Color: "#00d4ff" # Purple color
Thumbnail: "user" # "user" = show user's avatar, "server" = server icon, or paste an image URL
CustomThumbnailURL: "" # Paste an image URL here if you chose a custom thumbnail above
Footer:
Enabled: true
Text: ""
CustomIconURL: "" # Optional: Add a small icon next to footer text
Timestamp: false
Messages:
NoData: "### ❌ No Data Found\n> **{user}** hasn't earned any XP yet!\n> Start chatting to gain XP and level up! 💬"
InvalidUser: "### ❌ Invalid User\n> Please mention a valid server member!"
LeaderboardEmpty: "### 📊 Empty Leaderboard\n> No one has earned XP yet! Be the first to start leveling up! 🚀"
XPAdded: "### ✅ XP Added Successfully\n> Added **{xp} XP** to **{user}**!" # Admin command response
XPRemoved: "### ✅ XP Removed Successfully\n> Removed **{xp} XP** from **{user}**!" # Admin command response
XPSet: "### ✅ XP Updated Successfully\n> Set **{user}'s** XP to **{xp}**!" # Admin command response
LevelSet: "### ✅ Level Updated Successfully\n> Set **{user}'s** level to **{level}**!" # Admin command response
DataReset: "### ✅ Data Reset Successfully\n> Reset all leveling data for **{user}**!" # Admin command response
LeaderboardReset: "### ✅ Leaderboard Reset Successfully\n> All leveling data has been wiped! 🗑️" # Admin command response
Errors:
NoPermission: "### 🔒 Permission Denied\n> You need **Administrator** permission to use this command!"
InvalidAmount: "### ❌ Invalid Amount\n> Please provide a valid number!"
DatabaseError: "### ⚠️ Database Error\n> Something went wrong! Please try again in a moment."
Debug:
Enabled: false # Enable debug logs for testing (disable in production)
LogXPGains: true # Log when users gain XP from messages
LogLevelUps: true # Log when users level up
LogMultipliers: true # Log XP multiplier calculations
LogVoiceXP: true # Log voice channel XP gains
LogRoleRewards: true # Log when role rewards are given/removed