Leveling

The leveling system rewards users with XP for chatting and voice activity. As they level up, they can unlock roles, earn coins, and show off with customizable rank cards.

Core Settings

✅ Enabled

Turns the leveling system on or off.

Enabled: true

---

ResetDataOnLeave

• true → User’s XP & levels reset when they leave.

• false → Progress is saved if they rejoin (recommended).

ResetDataOnLeave: false

---

MessageXP & 🎙 VoiceXP

• Format: min-max

• Defines how much XP users earn for activity.

Examples

• MessageXP: 5-10

• VoiceXP: 2-5

Recommendations

• Small servers → Higher XP (e.g., 10-20, 2-4)

• Large servers → Lower XP (e.g., 5-10, 1-2)

---

XPNeeded

• Base XP needed to level up.

• Scales with each level (Level 2 = 300 XP, Level 3 = 600 XP, etc).

Examples

• Fast leveling → 200-250

• Normal → 300-400

• Slow (competitive) → 500-750

XPNeeded: 300

---

Channel & Category Settings

Control where XP is earned:

ChannelSettings:
  LevelUpChannelID: ""           # Leave empty to use current channel
  DisabledChannels: ["12345"]    # No XP in these channels
  DisabledCategories: ["67890"]  # No XP in these categories

---

XP Cooldown

Cooldowns prevent spam and balance XP gain.

CooldownSettings:
  EnableXPCooldown: true
  XPCooldown: "30s"   # Message XP cooldown
  VoiceInterval: "60s" # How often voice XP is given

Recommendations

• Message cooldown → 30s–60s

• Voice interval → 60s–120s

---

Level-Up Messages

Customize the message or embed shown when a user levels up.

Available placeholders

• {user} → Mention user

• {userName} → Username only

• {userId} → Discord ID

• {userIcon} → Profile picture

• {userBanner} → Banner image

• {guildName} → Server name

• {oldLevel} / {newLevel} → Levels

• {oldXP} / {newXP} → XP progress

• {randomLevelMessage} → Pulls from lang.yml

Example (simple message):

LevelUpMessage: "{user}, you are now level {newLevel}"
UseEmbed: false

Example (embed):

UseEmbed: true
Embed:
  Title: "🎉 Level Up!"
  Description:
    - "{userName} just reached level {newLevel}!"
    - "{randomLevelMessage}"
  Thumbnail: "{userIcon}"
  Color: "#eda3f0"

---

Role Rewards

Give roles when users hit certain levels.

StackRoles

• true → Users keep all unlocked level roles (Level 1, 5, 10).

• false → User only has the highest level role.

Example:

RoleSettings:
  StackRoles: true
  LevelRoles:
    - level: 1
      roleID: "ROLE_ID"
    - level: 5
      roleID: "ROLE_ID"

---

Coin Rewards (Economy Integration)

Reward coins at specific levels.

• +1 → Every level

• +5 → Every 5 levels

• 25 → Exactly level 25

Example:

ScaleRewards:
  StackRewards: false
  Rewards:
    - level: +1
      coins: 10

---

Rank Card Customization

Your rank card can be styled with colors, progress bars, and emojis.

RankCard:
  AccentColor: "#1769FF"
  SecondaryColor: "#4785FF"
  ProgressBar:
    StartColor: "#1769FF"
    EndColor: "#4785FF"
  Emojis:
    Level: "✧"
    TopRank: "♚"
    NormalRank: "★"

---

Quick Setup Examples

• Casual Server (fast leveling)

  • MessageXP: 10-20

  • VoiceXP: 2-4

  • XPNeeded: 200

• Competitive Server (slow leveling)

  • MessageXP: 5-8

  • VoiceXP: 1-2

  • XPNeeded: 500

• Community Server (balanced)

  • MessageXP: 8-15

  • VoiceXP: 1-3

  • XPNeeded: 300

---

Commands

👥 User Commands

• /rank → View your rank card

• /rank @user → View someone else’s rank

• /leaderboard → Show server leaderboard

🔧 Admin Commands (requires Permission roles)

• /level give @user 5 → Add XP

• /level take @user 3 → Remove XP

• /level set @user 10 → Set user’s level

• /level reset @user → Reset progress