Leveling

Leveling Dashboard UI Guide

The Leveling system gamifies your server by tracking member activity and awarding XP points. This comprehensive guide covers XP settings, role rewards, customizing rank cards, managing leaderboards, achievements, quests, and creating a rewarding community experience.

Dashboard Tabs Overview

The Leveling dashboard is organized into six main tabs:

Settings Tab

Configure base XP values, cooldowns, multipliers, and excluded channels/roles.

Role Rewards Tab

Map levels to roles. Automatically assign roles when members reach specific levels.

Rank Cards Tab

Customize the visual rank card design, colors, fonts, and layout for your community.

Leaderboard Tab

Configure leaderboard settings, reset intervals, and public access controls.

Achievements Tab Premium

Create multi-tier achievements across 9 categories with 5 rarity levels. Awards unlock automatically as members progress.

Quests Tab Premium

Design daily, weekly, and seasonal quests with 21 objective types, multi-objective logic, rewards, chains, and announcements.

Settings Tab - XP Configuration

Configure how members earn XP and how the system behaves:

Basic XP Settings

Configure the core XP mechanics:

Base XP Per Message

Use the slider to set how much XP each message earns (default: 5-25 XP). Higher values mean faster progression.

XP Cooldown (dropdown)

Prevent spam farming by setting a cooldown between XP-earning messages:

  • • 5 seconds (fastest progression)
  • • 10 seconds (balanced, recommended)
  • • 30 seconds (slower, prevents spam)
  • • 1 minute (very restrictive)

Level Up Multiplier

Set the XP required per level progression (linear vs exponential). Example: multiplier 1.5 means each level requires 50% more XP than previous.

Enable Streaks (toggle)

When enabled, members gain bonus XP for consecutive days of activity. Encourages daily engagement.

XP Multipliers

Create XP bonus zones for activity encouragement:

Click "Add Multiplier Channel" to create channels where members earn more XP:

Setup Steps:

  1. 1. Select a channel (SearchableSelect) - commonly #general, #discussion, #voice-chat
  2. 2. Enter multiplier value (e.g., 2.0 = double XP, 1.5 = 50% bonus)
  3. 3. Optional: Set reason/label (e.g., "Voice Channel Bonus")
  4. 4. Click "Save Multiplier"

Use Cases: Encourage voice chat (2x), reward long conversations (1.5x), boost new channel adoption

Excluded Channels & Roles

Prevent XP farming and spam by excluding certain channels and roles:

Excluded Channels (SearchableSelect multi-select)

Channels where messages don't earn XP. Common exclusions:

  • • #bot-commands (prevent command spam farming)
  • • #announcements (prevent reaction farming)
  • • #rules (prevent low-effort reads)
  • • #spam (designated spam channel)

Excluded Roles (SearchableSelect multi-select)

Roles whose messages don't earn XP. Common exclusions:

  • • Bots (prevent bot-to-bot XP cycling)
  • • Muted role (punishment prevention)
  • • Service roles (webhooks, integrations)

Click the field, type to search channels/roles, and select multiple to exclude. Click X on chips to deselect.

XP Gain Methods

Configure what actions earn XP:

  • Text Messages (toggle): Default enabled. Base XP per message.
  • Voice Chat (toggle): Earn XP for active voice chat participation.
  • Reactions (toggle): Earn XP when reactions are received on messages.
  • Thread Messages (toggle): Earn XP in thread conversations.

Saving Settings

Click the green "Save XP Settings" button (BLACK text) to apply changes. Settings take effect immediately for future XP gains.

Role Rewards Tab - Level-Based Roles

Automatically assign roles when members reach specific levels:

Overview of Role Rewards

The Role Rewards section displays a table of level-to-role mappings. Each row shows:

  • Level: The level that triggers the reward
  • Role: The role assigned at that level
  • Status: Active/Inactive (toggle on/off)
  • Actions: Edit or delete the reward

Adding Role Rewards

Click "Add Role Reward" to create a new level-based reward:

  1. 1.Level Number (number input): Enter the level threshold (e.g., 10, 25, 50)
  2. 2.Role (SearchableSelect): Search and select the role to assign (e.g., "Level 10 Member")
  3. 3.Reward Type (dropdown): Choose between Stack (add role) or Replace (remove previous level role)
  4. 4.Notify Member (toggle): Send congratulations DM when role is awarded
  5. 5.Click "Save Reward"
Example: Level 10 → "Initiate", Level 25 → "Contributor", Level 50 → "Senior", Level 100 → "Legendary"

Stack vs Replace

Choose how roles accumulate as members level up:

Stack Mode

Members keep all level roles. Level 50 member has both "Level 25" and "Level 50" roles. Visual progression, cluttered roles.

Replace Mode

Members keep only the highest level role. Level 50 member loses "Level 25" role. Clean role list, single visual tier.

Editing & Deleting Rewards

In the rewards table, click the edit icon to modify a reward's level or role. Click delete to remove it. Existing role assignments to members are not reversed if you delete a reward.

Rank Cards Tab - Card Designer

Customize the visual appearance of member rank cards:

Card Design Overview

The Rank Cards designer lets you customize how rank cards look when members check their progress:

  • • Visual background and color scheme
  • • Font selection and sizing
  • • Layout arrangement (vertical/horizontal)
  • • Information displayed (level, XP, rank, progress bar)
  • • Live preview to see changes in real-time

Appearance Settings

Customize colors and backgrounds:

Background Color (color picker)

Click to choose solid background color for the card.

Background Image (file upload)

Upload a custom background image (.png, .jpg). Recommended size: 600x200 pixels.

Image Opacity (slider)

Control transparency (0-100%) if using background image.

Accent Color (color picker)

Color for highlights, progress bar, and decorative elements.

Text Color (color picker)

Primary text color. Choose contrasting color for readability.

Secondary Text Color (color picker)

Color for secondary information like XP values and level labels.

Font & Layout

Configure typography and layout:

  • Font Family (dropdown): Choose from Arial, Roboto, Courier, Georgia, Comic Sans, Impact, etc.
  • Font Size (slider): Adjust text size for readability
  • Card Layout (dropdown): Choose Vertical (standard) or Horizontal (landscape)
  • Text Alignment (dropdown): Left, Center, or Right alignment

Card Elements

Choose what information appears on the card:

Display Elements (toggles):

  • • Show Member Avatar: Profile picture in corner
  • • Show Member Name: Username on card
  • • Show Level: Current level number
  • • Show XP Progress: Progress bar and XP values
  • • Show Rank Position: Global rank (#1, #2, etc.)
  • • Show Server Logo: Your server's icon

Progress Bar Options:

  • • Progress Bar Style: Standard, Gradient, or Outline
  • • Progress Bar Color: Select color matching theme
  • • Show XP Numbers: Display "500/1000 XP" text

Preview & Save

The preview panel on the right shows your design in real-time. It displays a sample rank card as members will see it:

  • • Updates instantly as you make changes
  • • Shows example data (Level 25, 1,500/2,000 XP, Rank #42)
  • • Test readability and visual appeal
  • • Check color contrast for accessibility

Click green "Save Card Design" (BLACK text) to apply changes. Cards update instantly for all members.

Card Customization Tips

  • • Use your server's color palette for brand consistency
  • • Ensure text color contrasts well with background
  • • Test both light and dark Discord themes
  • • Keep text readable at small sizes
  • • Consider member experience on mobile vs desktop

Leaderboard Tab - Settings & Configuration

Configure the public leaderboard and its behavior:

Leaderboard Visibility

Control who can see the leaderboard:

  • Public Leaderboard (toggle): Enable to show leaderboard in public command (/leaderboard)
  • Embed in Channel: Automatically post leaderboard in a specific channel
  • Visibility (SearchableSelect): Choose who can view (members, roles, all)

Leaderboard Reset

Configure periodic resets to create competitive seasons:

Reset Interval (dropdown):

  • • Never (permanent leaderboard)
  • • Weekly (reset every Sunday)
  • • Monthly (reset on 1st of month)
  • • Quarterly (reset every 3 months)
  • • Yearly (reset January 1st)

Reset Time (time picker):

Choose what time of day reset occurs (e.g., 12:00 AM UTC)

Archive Previous Seasons (toggle):

Keep leaderboard history viewable for past seasons

Reset Action (dropdown):

Choose: Clear XP & Levels (full reset), Archive Score (keep history), or Soft Reset (divide by 2)

Leaderboard Announcements

Celebrate achievements and season milestones:

  • Announcement Channel (SearchableSelect): Select channel for leaderboard updates
  • Announce Top Players (toggle): Post top 3 winners at season end
  • Monthly Recap (toggle): Post monthly top contributors
  • Level Up Announcements (toggle): Announce when members reach milestones (level 50, 100, etc.)

Leaderboard Display

Customize what information appears on the leaderboard:

  • Show XP Values (toggle): Display total XP earned
  • Show Ranks (toggle): Show #1, #2, etc. positions
  • Entries Per Page (number input): How many users per page (10-50)
  • Custom Title (text input): Alternative to "Leaderboard" (e.g., "XP Rankings")

Saving Leaderboard Settings

Click green "Save Leaderboard Settings" (BLACK text) to apply changes. Settings take effect immediately.

Achievements Tab - Multi-Tier Unlocks

Create achievements that unlock automatically as members reach milestones. Each achievement supports multiple tiers with escalating requirements.

Achievement Types

Choose from 11 built-in achievement trigger types. Each type is evaluated either in real-time (HOT) during XP events or periodically (COLD) via the aggregator:

Threshold/Monotonic Types (real-time):

  • TOTAL_XP_REACHED — Trigger on lifetime XP milestones (e.g., 1K, 10K, 50K, 200K)
  • LEVEL_REACHED — Trigger on level thresholds (e.g., Level 5, 25, 50, 100)
  • STREAK_DAYS — Trigger on consecutive daily activity streaks (e.g., 3, 7, 30, 100 days)
  • VOICE_MINUTES_TOTAL — Trigger on accumulated voice time (e.g., 60, 600, 3000, 10000 min)
  • REACTIONS_GIVEN_TOTAL — Trigger on total reactions given
  • QUESTS_COMPLETED — Trigger on quest completion count

Aggregate Types (periodic):

  • DAYS_ACTIVE — Trigger on total unique active days (e.g., 7, 30, 100, 365)

Point-in-Time Types:

  • FIRST_MESSAGE — One-time trigger on first message ever sent
  • FIRST_VOICE — One-time trigger on first voice activity
  • FIRST_TICKET_SOLVED — One-time trigger on solving first ticket

Special Types:

  • SEASON_RANK_REACHED — Trigger on seasonal ranking thresholds

Achievement Tiers

Each achievement supports 4 progressive tiers with escalating thresholds:

BronzeTier 1 — Entry-level threshold (e.g., 1K XP, Level 5)
SilverTier 2 — Intermediate threshold (e.g., 10K XP, Level 25)
GoldTier 3 — Advanced threshold (e.g., 50K XP, Level 50)
PlatinumTier 4 — Highest threshold (e.g., 200K XP, Level 100)

Rarity Levels

Assign a rarity to each achievement for visual distinction and prestige:

COMMONBasic achievements — default rarity
UNCOMMONSlightly harder to obtain
RAREChallenging achievements with subtle glow effect
EPICVery challenging achievements with glow effect
LEGENDARYExtremely difficult — prominent glow and prestige

Achievement Categories

Organize achievements into 9 categories for easy navigation and grouping:

🔥 Activity👥 Social⚡ Engagement🏆 Milestones👑 Mastery⭐ Special🎁 Events🔊 Voice🎨 Creative

Creating Achievements (Dashboard)

Click "Add Achievement" to create a new achievement:

  1. 1.Name & Description — Give your achievement a name and description
  2. 2.Category — Select from the 9 categories above
  3. 3.Rarity — Choose Common through Legendary
  4. 4.Type & Thresholds — Pick the trigger type and set thresholds for each tier (Bronze, Silver, Gold, Platinum)
  5. 5.Icon — Choose an emoji or icon for visual display
  6. 6.Click "Save Achievement"

Default Achievements

SYNTHET includes built-in default achievements that activate automatically:

  • XP Collector — Earn lifetime XP (1K → 10K → 50K → 200K)
  • Level Master — Reach higher levels (5 → 25 → 50 → 100)
  • Dedicated Member — Active on different days (7 → 30 → 100 → 365)
  • On Fire — Daily activity streak (3 → 7 → 30 → 100 days)
  • Voice Veteran — Voice channel time (60 → 600 → 3,000 → 10,000 min)
  • Hello World — Send your first message (one-time)

Quests Tab - Objectives & Rewards

Design quests that give members specific goals to complete for rewards. Supports daily, weekly, seasonal, one-time, and repeatable quests with complex multi-objective logic.

Quest Types

Choose when quests reset and how often they can be completed:

DAILYResets every 24 hours — encourages daily login
WEEKLYResets every 7 days — longer-term goals
SEASONALPersists for the full season — epic challenges
ONE_TIMEComplete once ever — permanent milestones
REPEATABLEComplete multiple times with cooldown

Quest Objectives (21 Types)

Each quest has one or more objectives. Choose from 21 auto-trackable objective types:

Message Objectives:

  • send_messages — Send a number of messages
  • send_messages_channel — Send messages in a specific channel
  • react_messages — React to messages
  • use_emojis — Use different emoji
  • attachments_sent — Send attachments/media
  • first_message_daily — First message of the day
  • weekend_messages — Weekend messages
  • night_owl_messages — Night owl messages (12am-5am UTC)

Social Objectives:

  • reply_users — Reply to different users
  • give_reactions — Give reactions to others
  • start_threads — Start threads
  • invite_members — Invite members
  • unique_channels — Post in unique channels

Activity Objectives:

  • join_voice — Voice time (minutes)
  • earn_xp — Earn XP
  • reach_level — Reach a level
  • maintain_streak — Maintain daily streak
  • attend_events — Attend events
  • complete_quests — Complete other quests
  • win_games — Win games
  • boost_server — Boost server

Multi-Objective Logic (AND / OR)

Quests with multiple objectives support two logic modes:

AND Logic (all required)

The user must complete ALL objectives to finish the quest. Example: "Send 20 messages AND spend 10 minutes in voice AND react to 5 messages."

OR Logic (any one)

The user must complete ANY ONE objective to finish the quest. Example: "Send 50 messages OR spend 30 minutes in voice."

Quest Rewards

Configure what members receive upon completing a quest:

XP RewardAward bonus XP on completion
Grant RoleAdd a Discord role to the member
Remove RoleRemove a Discord role from the member
CurrencyAward economy currency (if economy module is configured)

Quest Chains & Prerequisites

Create progressive quest chains where completing one quest unlocks the next:

Prerequisite Quest — Select a quest that must be completed before this quest becomes available. This enables sequential quest progression like: "Newcomer → Regular → Veteran → Legend."

Min Level Requirement — Set a minimum user level required to start the quest.

Required Role — Restrict the quest to members with a specific role.

Quest Announcements

Celebrate quest completions with automated announcements:

Announcement Channel (SearchableSelect) — Select the channel where quest completion announcements are posted

Custom Message — Write a custom announcement template. The message can include placeholders for the member name and quest title.

Quest Configuration Options

Additional settings for fine-tuning quest behavior:

Max Completions — Maximum times a user can complete the quest (0 = unlimited, for REPEATABLE quests)

Cooldown Minutes — Cooldown between completions for repeatable quests

Available From / Until — Date range when the quest is active (for time-limited events)

Default Quests

SYNTHET includes built-in default quests that activate automatically:

  • Daily Chatter (DAILY) — Send 10 messages
  • XP Hunter (DAILY) — Earn 150 XP
  • Explorer (WEEKLY) — Be active in 5 channels
  • Voice Regular (WEEKLY) — Spend 30 minutes in voice

Complete Leveling Setup Workflow

Here's a typical sequence to set up a complete leveling system:

  1. 1.Go to Settings tab and configure base XP values (10-20 per message is typical)
  2. 2.Add XP multiplier channels (e.g., 2x for voice chat)
  3. 3.Exclude channels where XP shouldn't apply (commands, announcements)
  4. 4.Go to Role Rewards and add level-to-role mappings (10→Level 10, 25→Level 25, etc.)
  5. 5.Customize rank cards in the Rank Cards tab with your server colors
  6. 6.Configure leaderboard settings and announcement channel
  7. 7.Set up achievements in the Achievements tab (or use the defaults)
  8. 8.Create daily/weekly quests in the Quests tab for ongoing engagement
  9. 9.Test with a trial member - have them send messages and check their rank
  10. 10.Adjust multipliers and cooldowns based on progression feel

Key Considerations

  • • SearchableSelect fields are typeable - type to find roles and channels
  • • Green buttons always have BLACK text for accessibility
  • • Base XP values around 15 per message provide moderate progression
  • • Use role rewards sparingly - too many roles become meaningless
  • • Test rank card design with different Discord themes
  • • Monitor progression rates - adjust multiplier if progression feels too fast/slow
  • • Seasonal resets create renewed engagement and fairness