Leveling System

Hubdustry's Leveling module encourages engagement by rewarding active members with XP and levels. Configure role rewards, customize rank cards, and track progress through leaderboards.

How It Works

1. Members earn XP by sending messages in enabled channels
2. XP accumulates toward the next level threshold
3. At each level, members can unlock role rewards
4. Progress is visible via the /rank command or the dashboard leaderboard

Commands

Command	Description
/rank	View your current level, XP, and rank card
/rank @user	View another member's rank card
/leaderboard	View the server leaderboard
/xp give @user <amount>	Manually give XP (admin)
/xp remove @user <amount>	Remove XP from a user (admin)

Configuration

XP Settings

Configure XP rates from the Dashboard → Leveling page:

• XP per message: Base amount earned per message (default: 15–25 random)
• Cooldown: Seconds between XP gains (default: 60s)
• Multiplier channels: Channels that give bonus XP
• Ignored channels: Channels where no XP is earned
• Ignored roles: Roles that don't earn XP

Role Rewards

Automatically assign roles when members reach specific levels:

1. Go to Dashboard → Leveling → Role Rewards
2. Click Add Role Reward
3. Select the level and the role to assign
4. Choose whether to stack roles or replace the previous reward

Rank Card Customization

Members can customize their rank card appearance:

• Background: Upload a custom background image
• Accent color: Choose a color for the progress bar
• Opacity: Adjust the overlay opacity

Leaderboard

The leaderboard shows the top members by XP. It resets are configurable:

• Never reset (cumulative)
• Weekly reset
• Monthly reset

Permissions Required

Permission	Why
Manage Roles	To assign role rewards
Send Messages	To send level-up announcements
Attach Files	To send rank card images