Leveling Commands & Configuration
Master SYNTHET's comprehensive leveling system with 7 powerful commands, customizable XP rates, level-up announcements, role rewards, and advanced dashboard controls for your server's progression.
Overview
The SYNTHET Leveling module rewards member activity with experience points, levels, achievements, and quests. Track progression with rank cards, leaderboards, and unlockable role rewards. Perfect for motivation and community engagement.
All features are fully customizable through both slash commands and the dashboard. XP rates, level thresholds, role rewards, and announcements adapt to your server's culture.
Leveling Commands
Seven essential commands for tracking, earning, and managing user progression:
View Your Rank Card
/rank [user]Display an interactive rank card showing XP, current level, progress bar to next level, rank position, and tier badge. Optional: check another user's rank by mentioning them.
View Leaderboard
/leaderboard [page]Display the server's XP leaderboard showing top 10 members. Supports pagination—specify a page number to view ranks 11-20, 21-30, etc. Shows your current rank on every page.
View Achievements
/achievements [user]View unlocked achievement badges (Chatty, Consistent, Rising Star, Legend, etc.). Shows progress toward locked achievements and rewards earned. Check another user's achievements by mentioning them.
View Daily/Weekly Quests
/questsView active daily and weekly quests with progress. Quests like "Send 20 messages" or "Reach level 5" reward bonus XP and unlock special badges upon completion.
Reset User XP (Admin)
/xp reset <user>Reset a member's XP and level to zero. Requires admin permissions. Use for account resets or punishment. Logs action in audit trail.
Add XP Manually (Admin)
/xp add <user> <amount>Manually award XP to a member. Useful for rewarding exceptional behavior, compensating for downtime, or incentives. Updates user's rank immediately with notification.
Set XP Multiplier (Admin)
/xp multiplier <multiplier> [channel] [role] [duration]Apply a temporary XP multiplier server-wide, for a specific channel, or for users with a role. Example: 2x multiplier for 24 hours during events. Optional: set duration in hours (default: permanent until disabled).
Dashboard Configuration Guide
Configure all leveling settings from the SYNTHET dashboard. Navigate to your server's Leveling module to access these options:
XP Rates & Base Configuration
Base XP Per Message
Set how much XP members earn per message (default: 10-15). Affects the entire progression speed of your server. Lower values = slower progression, higher values = faster leveling.
XP Variation (Min/Max Range)
Set minimum and maximum XP per message to add randomness. Members earn between min-max instead of exact amounts. Makes progression feel natural and unpredictable.
Message Cooldown
Prevent XP farming by setting cooldown between XP-earning messages (default: 5 seconds). Users must wait this long between messages to earn XP again.
Level-Up Announcements
Enable/Disable Announcements
Toggle level-up notifications on/off. When enabled, the bot announces when members reach new levels with congratulatory messages and celebration emojis.
Announcement Channel
Choose a dedicated channel for level-up announcements. Use #leveling-announcements or #achievements to keep notifications organized. Optional: post to user's DM instead.
Milestone Notifications
Customize when announcements trigger. All levels, specific milestones (every 5/10 levels), or only major achievements. Reduces announcement spam while celebrating progress.
Role Rewards & Unlocks
Level-Based Role Assignment
Assign roles automatically when members reach specific levels. Create progression tiers like Bronze (Level 5), Silver (Level 10), Gold (Level 25), Platinum (Level 50).
Role Rewards Table
Cumulative vs Replacement Roles
Choose: users keep all roles they earn (cumulative), or only get their highest tier role (replacement). Cumulative shows progression, replacement keeps role list clean.
Excluded & No-XP Channels
Exclude Channels from XP
Select channels where XP earning is disabled. Perfect for #announcements, #bot-commands, #memes, #spam. Messages in these channels don't grant XP.
Channel XP Multipliers
Set custom multipliers per channel. Give 2x XP in #study-help, 0.5x in #games, or 0.0x in #spam. Encourages participation in quality discussion channels.
Typical Exclusions
- • #announcements, #rules, #info (read-only channels)
- • #bot-commands (prevents command spamming)
- • #spam, #off-topic (discourages low-quality participation)
- • #modmail, #support (admin channels)
Leaderboard Configuration
Leaderboard Channel
Set an auto-updating leaderboard channel. Bot posts the top 10 members and updates every 30 minutes. Shows rank, name, level, and XP total.
Display Options
Show/hide usernames, levels, XP totals, last update time. Customize colors and sorting (recent activity, total XP, level progression).
Weekly/Monthly Resets
Optional: reset leaderboard weekly or monthly to highlight recent activity. Keep users engaged with fresh competition. Create seasonal rankings.
Rank Card Customization
Rank Card Design
Customize rank card colors, background image, fonts, and layout. Choose from presets or create custom designs. Cards show level, XP progress, rank position, and badges.
Progress Bar Styling
Customize progress bar color, height, animation style. Match your server's branding and theme. Add gradient effects or neon styles.
Display Additional Stats
Show total messages sent, daily XP streak, achievements unlocked, or custom stats. Toggle visibility of each stat independently.
Advanced Features
Bonus XP for Message Length
Reward longer, more thoughtful messages with bonus XP. Messages over 50 characters get 10% bonus, over 100 characters get 20% bonus (max 50%). Encourages quality discussion.
Daily/Weekly Activity Streaks
Track consecutive days/weeks of activity. Award bonus XP or special badges for maintaining streaks. Motivates consistent engagement. Shows on rank cards.
Blacklist Roles & Users
Exclude specific roles or users from earning XP. Useful for bots, testing accounts, or restricted members. Prevents undesired XP gains.
Level Caps & Prestige System
Optional: set a maximum level or enable prestige mode. When members reach max level, they can reset to level 1 with a prestige badge. Creates long-term goals.
Quick Setup Guide
- 1.Enable Leveling module in dashboard and choose a base XP rate (10-20 recommended)
- 2.Set cooldown to prevent farming (5-10 seconds recommended)
- 3.Create role rewards for levels 5, 10, 25, and 50
- 4.Exclude read-only and bot-command channels from XP
- 5.Enable level-up announcements and choose announcement channel
- 6.Customize rank card design to match server branding
- 7.Test with /rank and /leaderboard commands to verify setup
Common Configuration Examples
Casual Server (Relaxed Progression)
- • Base XP: 20 | Cooldown: 3 seconds
- • Max XP: 35 | Message length bonus: Enabled
- • Level-up announcements: All levels
- • Role rewards every 5 levels
- • Excluded channels: announcements, rules, bot-commands
Competitive Server (Strict Progression)
- • Base XP: 8 | Cooldown: 10 seconds
- • Max XP: 12 | Message length bonus: Disabled
- • Level-up announcements: Milestones only (every 10 levels)
- • Role rewards every 20 levels
- • Excluded channels: announcements, rules, bot-commands, spam
Active Community (Balanced)
- • Base XP: 15 | Cooldown: 5 seconds
- • Max XP: 25 | Message length bonus: Enabled (20% max)
- • Level-up announcements: Every other level
- • Role rewards every 10 levels
- • Multipliers: study-help 2x, games 0.5x, spam 0x
Tips & Best Practices
- • Start with default settings and adjust gradually based on community feedback
- • Use cooldowns (5-10 seconds) to prevent farming and farming bots
- • Create meaningful role rewards at every 5-10 levels to keep users engaged
- • Exclude read-only channels (#announcements, #rules) from XP rewards
- • Use channel multipliers to encourage quality discussion (2x in #discussions, 0.5x in #spam)
- • Enable level-up announcements but use milestone filtering to reduce spam
- • Test with /rank and /leaderboard after making changes to verify
- • Regularly review leaderboards and adjust rates if progression feels too fast/slow
- • Customize rank cards to match your server's branding and aesthetic
- • Enable streaks and message length bonuses to reward consistent quality engagement
Troubleshooting
Members not earning XP
Check: Is leveling enabled? Are channels excluded? Is the user blacklisted? Verify cooldown hasn't exceeded time between messages. Check bot permissions in channel.
XP earning too fast/slow
Adjust base XP amount and cooldown. Lower cooldown + higher XP = faster. Higher cooldown + lower XP = slower. Use multipliers for specific channels.
Role rewards not assigning
Verify bot has manage roles permission. Check role hierarchy—bot role must be higher than reward roles. Ensure levels are set correctly in dashboard.
Leaderboard not updating
Leaderboards update every 30 minutes. Manually refresh with /leaderboard command. Check bot has message permissions in leaderboard channel.
Frequently Asked Questions
Can I reset XP for specific members?
Yes, use /xp reset <user> (admin only). This resets their XP and level to zero. Useful for fresh starts or punishment. Action is logged in audit trail.
How do multipliers work?
Base XP × multiplier = earned XP. 2x = double, 0.5x = half, 0x = zero. Server-wide, channel-specific, or role-specific multipliers can stack.
Can members see their progress?
Yes, use /rank to view progress bars, current XP, level, and achievement progress. Leaderboard shows top members server-wide.
Do quests give extra XP?
Yes, completing daily/weekly quests rewards bonus XP and special achievement badges. Quests rotate regularly and encourage varied engagement.
How do I prevent farming?
Set cooldowns (5-10 seconds), exclude spam channels, cap maximum XP, and blacklist obvious farms. Monitor leaderboards for suspicious patterns.