Leveling

Leaderboards

View, manage, and export member rankings. Track progression and celebrate top achievers.

Overview

Leaderboards display member rankings based on level and XP. They provide competition, motivation, and a sense of achievement within your community.

SYNTHET supports multiple leaderboard views, filtering options, data exports, and the ability to reset data when needed.

Viewing Leaderboards

Use these commands to view leaderboards:

/leaderboardView top 10 members by level
/leaderboard top <number>View top N members (e.g., top 25)
/leaderboard around <user>View leaderboard around a specific user
/leaderboard meView your ranking and nearby members
/leaderboard xpSort by total XP instead of level
/leaderboard weeklyView weekly XP leaderboard
/leaderboard monthlyView monthly XP leaderboard
/leaderboard role <role>View leaderboard filtered by role

Leaderboard Types

Different leaderboards track different metrics:

Overall Leaderboard

/leaderboard

Ranks members by overall level. This is the main leaderboard and determines server hierarchy.

XP Leaderboard

/leaderboard xp

Ranks by total accumulated XP. Shows total experience progress independent of level thresholds.

Weekly Leaderboard

/leaderboard weekly

Tracks XP earned in the past 7 days. Resets weekly to give everyone a fresh start.

Monthly Leaderboard

/leaderboard monthly

Tracks XP earned in the current month. Resets on the first day of each month.

Filtering Leaderboards

Filter leaderboards by role, channel, or custom criteria:

/leaderboard role <role>Show only members with a specific role
/leaderboard channel <channel>Include only XP from a specific channel
/leaderboard guildCompare across multiple servers (if enabled)
/leaderboard exclude-role <role>Exclude a role from leaderboard

Display Options

Customize how leaderboards are displayed:

Change Display Size

/leaderboard top 50

Display up to 50 top members. Maximum is 100 per page.

Context Window

/leaderboard around @username

See a user and their surrounding rankings. Useful for checking where you rank.

Pagination

Large leaderboards are split into pages. Use next/previous buttons to navigate.

Information Displayed

Each leaderboard entry includes:

Rank: Position on the leaderboard (1, 2, 3, etc.)
Username: Member's Discord name
Level: Current level achieved
XP: Total XP accumulated (or weekly/monthly if applicable)
Progress: Optional bar showing progress to next level
Badge: Special indicators (e.g., top 3, new member, active)

Persistent Leaderboards

Set up persistent leaderboard channels that update automatically:

/leaderboard pin <channel>Post leaderboard that auto-updates in a channel
/leaderboard pin-interval <hours>Set update interval (1-24 hours)
/leaderboard pin-size <number>Set leaderboard size (5-50)
/leaderboard unpin <channel>Remove pinned leaderboard
/leaderboard pinsView all active pinned leaderboards

Data Management

Manage and maintain leveling data:

/leveling data exportExport all leveling data to CSV
/leveling data export-user <user>Export a user's leveling data
/leveling data import <file>Import leveling data from backup
/leveling data backupCreate a backup of all data
/leveling statsView server-wide leveling statistics

Exporting Leaderboard Data

Export leaderboards for analysis and records:

Full Export

/leveling data export

Exports all member XP and levels as a CSV file. Useful for analysis and backup.

User Export

/leveling data export-user @user

Export a specific user's complete leveling history and statistics.

Export Format

CSV format includes: Rank, Username, Level, XP, Total XP, Join Date, Last Active

Resetting Data

Reset leveling data when starting fresh or handling specific situations:

Reset User Data

/leveling reset <user>

Reset a specific user's level and XP to 0. Requires admin permission.

Reset Server Data

/leveling reset-all

Reset all members' levels and XP. Requires owner confirmation. Be very careful with this!

Reset Weekly Leaderboard

/leaderboard reset-weekly

Reset weekly XP tracking. Happens automatically every Sunday.

Resetting data is permanent! Always create a backup with `/leveling data backup` before resetting.

Server Statistics

View overall server leveling statistics:

View Server Stats

/leveling stats

Shows total members leveling, average level, total XP earned, and other server-wide metrics.

Statistics Include

  • • Total members with XP
  • • Average server level
  • • Total XP earned (server-wide)
  • • Most active members
  • • XP earned this week/month
  • • Highest individual level
  • • Least active members (below 5)

Leaderboard Rewards

Reward top performers on leaderboards:

/leaderboard reward top-1 <role>Reward rank 1 player with a role
/leaderboard reward top-3 <role>Reward top 3 players with a role
/leaderboard reward top-10 <role>Reward top 10 players with a role
/leaderboard reward weekly <role>Reward weekly leaderboard winner
/leaderboard reward-resetRemove reward roles and reset

Privacy Settings

Control who can see leaderboard data:

Public Leaderboards

Default setting. Everyone can view leaderboards. Required for healthy competition.

Role-Based Visibility

/leaderboard set-visibility <role>

Only members with a specific role can view leaderboards.

Opt-Out from Leaderboard

/leveling private

Individual users can opt-out from appearing on public leaderboards.

Tips & Best Practices

  • • Pin leaderboards in key channels for visibility and motivation
  • • Weekly leaderboards encourage continuous participation
  • • Celebrate top performers with announcements or special roles
  • • Regularly review leaderboard trends to detect unfair advantages
  • • Export data monthly for analysis and record-keeping
  • • Consider role-based leaderboards for specialized communities
  • • Use context windows (`around @user`) to help members check their ranking
  • • Create backup before any reset operations
  • • Monitor for unusual leveling patterns (potential farming)

Common Use Cases

Monthly Leaderboard Contests

Pin the monthly leaderboard in #announcements. Award prizes to top 3. Reset at month start automatically.

Role-Based Rankings

Create separate leaderboards for moderators, streamers, or other groups. Shows niche competition.

Activity Tracking

Use weekly leaderboards to identify most active members and recognize them with special roles.

Member Onboarding

Show new members the leaderboard to explain how the leveling system works and encourage participation.

Rank CardsLeveling Home