126
Dec 13
# ---------------------------------------------------------------
# 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