Skip to main content

✨ XP

Configure experience points (XP) settings for your group. The XP system rewards member participation and engagement, creating a gamified experience that encourages active community involvement.

Overview​

The XP (Experience Points) system provides:

  • Engagement Rewards: Members earn XP for messages and reactions
  • Level Progression: Accumulating XP allows users to level up
  • Role Unlocks: Level ups can trigger role assignments and perks
  • Customizable Earn Rates: Control how much XP is earned for different activities
  • Spam Prevention: Cooldown system prevents XP farming
  • Manual Grants: Admins can manually award XP for special contributions
Gamification Foundation

XP is the foundation of Fren One's gamification system. It integrates with Roles, Quizzes, and Leaderboards to create a comprehensive engagement platform.

How XP Works​

Earning XP​

Users earn XP through various activities:

1. Sending Messages

  • Members earn XP for each message sent in the chat
  • XP amount is customizable by admins
  • Subject to cooldown to prevent spam

2. Receiving Reactions

  • When members receive reactions on their messages
  • Rewards quality content that resonates with the community
  • Customizable points per reaction

3. Completing Quizzes

  • Earn XP by correctly answering quiz questions
  • Set by quiz creator per question
  • Encourages learning and participation

4. Admin Manual Grants

  • Admins can manually award XP
  • Useful for special contributions
  • Rewards beyond automated activities

5. Token Holder Bonuses

  • Token verification through Token Gating
  • One-time XP reward for verified holders
  • Incentivizes token ownership

Level System​

Accumulating XP allows users to level up:

  • Each level requires a specific XP threshold
  • Levels can unlock roles or perks
  • Members progress at their own pace
  • Visual recognition of achievement

Default Level Progression Example:

Level 1: 300 XP
Level 2: 300 XP (600 total)
Level 3: 600 XP (1,200 total)
Level 4: 1000 XP (2,200 total)
Level 5: 1500 XP (3,700 total)
Level 6: 2100 XP (5,800 total)
Level 7: 2800 XP (8,600 total)
Level 8: 3600 XP (12,200 total)
Level 9: 4500 XP (16,700 total)
Level Thresholds

XP requirements increase with each level, creating a balanced progression system that rewards long-term engagement.

Configuration​

To access XP settings:

  1. Use the /settings command in your chat
  2. Navigate to 🏆 Gamification → ✨ XP
  3. Configure the settings below

XP Settings​

Enabled/Disabled Toggle​

🔄 Enabled/🔴 Disabled: Enables or disables XP in this group.

  • 🟢 Enabled: XP system is active, members earn XP
  • 🔴 Disabled: XP system is paused, no XP is earned
Impact of Disabling

Disabling XP stops all XP earning but doesn't reset existing XP. Existing levels and XP totals are preserved and will resume when re-enabled.

XP Levels​

⚡ XP Levels: Manage the XP levels awardable to members.

Configure the level progression system:

Accessing XP Levels:

  1. Click ⚡ XP Levels
  2. View all configured levels
  3. Add new levels or modify existing ones

Current levels display:

🏆 Level 1: 300 XP
🏆 Level 2: 300 XP
🏆 Level 3: 600 XP
🏆 Level 4: 1000 XP
🏆 Level 5: 1500 XP
🏆 Level 6: 2100 XP
🏆 Level 7: 2800 XP
🏆 Level 8: 3600 XP
🏆 Level 9: 4500 XP

Add Level:

  1. Click ➕ Add Level
  2. Specify the XP required for the new level
  3. Set it as cumulative or incremental
  4. Save the new level

Remove Level:

  • Select a level from the list
  • Delete if no longer needed
  • Cannot delete if roles are tied to that level
Level Requirements

XP amounts shown are incremental (XP needed from previous level). Total XP is cumulative. For example, Level 3 requires 600 more XP beyond Level 2's 300, totaling 1,200 XP.

Level-Up Message​

💬 Level-up Message: Create a custom message that users will see when they level up.

Settings:

  • 🟢 Enabled/🔴 Disabled: Toggle level-up notifications on/off
  • ✏️ Edit: Customize the level-up message

Accessing:

  1. Click 💬 Level-up Message
  2. Toggle enabled/disabled
  3. Click ✏️ Edit to customize message

Message Variables:

  • {name}: User's display name
  • {level}: New level number
  • {xp}: Current XP total
  • {nextLevel}: Next level number
  • {xpNeeded}: XP needed for next level

Example messages:

🎉 Congratulations {name}! You've reached level {level}!

🎊 Level up! {name} is now level {level} with {xp} XP!

⭐ Amazing work {name}! You're level {level}. Keep going!
Motivation Through Messages

Creative level-up messages enhance the gamification experience. Use encouraging language and celebrate the achievement!

Messages XP​

💬 Messages XP: Set the XP members will receive per message sent.

Current display:

💬 Messages XP: 3

Configuration:

  1. Click 💬 Messages XP
  2. Enter the XP amount (e.g., 1, 3, 5, 10)
  3. Save the setting

Recommended values:

  • 1-2 XP: Slow progression, long-term engagement
  • 3-5 XP: Balanced progression (recommended)
  • 5-10 XP: Fast progression, quick rewards
  • 10+ XP: Very fast progression, event/competition mode
Balance Consideration

Lower values encourage quality over quantity. Higher values create faster progression but may encourage spam if cooldown isn't properly set.

Reactions XP​

👍 Reactions XP: Set the XP members will receive per reaction used.

Current display:

👍 Reactions XP: 2

Configuration:

  1. Click 👍 Reactions XP
  2. Enter the XP amount (e.g., 1, 2, 5)
  3. Save the setting

Recommended values:

  • 1 XP: Minimal reward, encourages authentic reactions
  • 2-3 XP: Balanced reward (recommended)
  • 5+ XP: High reward, encourages engagement

How it works:

  • User receives a reaction on their message → earns XP
  • Rewards quality content that resonates
  • Each reaction counts separately
  • Subject to cooldown rules
Quality Content Reward

Reaction XP rewards members who create valuable content that others appreciate. This naturally encourages quality contributions.

Cooldown​

⏰ Cooldown: sec: How long members must wait between XP rewards.

Current display:

⏰ Cooldown: 20 sec

Configuration:

  1. Click ⏰ Cooldown
  2. Enter cooldown in seconds (e.g., 10, 20, 30, 60)
  3. Save the setting

Purpose:

  • Prevents XP farming and spam
  • Encourages thoughtful contributions
  • Maintains message quality
  • Prevents bot abuse

Recommended cooldowns:

  • 5-10 seconds: Very active communities, fast-paced chat
  • 15-20 seconds: Balanced (recommended for most communities)
  • 30-60 seconds: Slower communities, prevents spam effectively
  • 60+ seconds: Very strict, quality-focused communities

How it works:

  1. Member sends message and earns XP
  2. Cooldown timer starts
  3. Messages sent during cooldown don't earn XP
  4. After cooldown expires, next message earns XP
Spam Prevention

Cooldown is essential for preventing XP farming. Too short allows spam, too long frustrates legitimate members. 15-20 seconds is ideal for most communities.

Common Use Cases​

Balanced Engagement Community​

Scenario: Standard community with regular activity.

Configuration:

  • Messages XP: 3
  • Reactions XP: 2
  • Cooldown: 20 seconds
  • Level-up messages: Enabled

Result: Steady progression, quality over quantity, prevents spam.

High-Activity Trading Group​

Scenario: Very active trading discussions, fast-paced chat.

Configuration:

  • Messages XP: 5
  • Reactions XP: 3
  • Cooldown: 10 seconds
  • Level-up messages: Enabled

Result: Fast progression, rewards active participation, quick feedback.

Quality-Focused Learning Community​

Scenario: Educational content, in-depth discussions preferred.

Configuration:

  • Messages XP: 2
  • Reactions XP: 5
  • Cooldown: 60 seconds
  • Level-up messages: Enabled with educational theme

Result: Rewards thoughtful content, high reaction XP incentivizes quality, long cooldown prevents spam.

Event/Competition Mode​

Scenario: Limited-time event with XP competition.

Configuration:

  • Messages XP: 10
  • Reactions XP: 5
  • Cooldown: 5 seconds
  • Level-up messages: Enabled with celebration theme

Result: Rapid progression, high engagement, competitive atmosphere.

New Community Launch​

Scenario: Building initial engagement, encouraging early members.

Configuration:

  • Messages XP: 5
  • Reactions XP: 3
  • Cooldown: 15 seconds
  • Level-up messages: Enabled with welcome theme
  • Manual XP grants for valuable contributions

Result: Quick initial levels, encouraging early activity, admin recognition.

Best Practices​

Effective XP Configuration
  • Test Values: Start with recommended settings and adjust based on community feedback
  • Monitor Progression: Watch how fast members level up
  • Balance Rewards: Messages and reactions should be proportional
  • Use Cooldowns: Essential for preventing spam and farming
  • Celebrate Milestones: Enable level-up messages for motivation
  • Manual Awards: Recognize special contributions with bonus XP
  • Adjust for Events: Temporarily increase XP for special occasions
  • Clear Communication: Explain how XP works to your community
  • Tie to Roles: Connect levels to role unlocks for additional motivation
  • Regular Review: Adjust settings as community grows and changes
Common Mistakes
  • No Cooldown: Leads to spam and XP farming
  • Too High XP: Members level up too fast, lose motivation
  • Too Low XP: Progression too slow, members lose interest
  • Ignoring Reactions: Missing opportunity to reward quality content
  • No Level-Up Messages: Reduces impact of achievement
  • Static Settings: Not adjusting as community evolves
  • Unclear System: Members don't understand how to earn XP
  • No Manual Grants: Missing opportunity to reward special contributions

XP Management​

Viewing Member XP​

Members and admins can view XP and levels:

For Members:

  • Type /xp or /level in chat
  • View personal XP total and current level
  • See XP needed for next level
  • Check leaderboard position

For Admins:

  • Access full member XP data
  • View detailed statistics
  • Track progression trends
  • Identify top contributors

Manual XP Grants​

Admins can manually award XP:

Use cases:

  • Exceptional contributions
  • Contest winners
  • Community helpers
  • Special achievements
  • Event participation
  • Bug reports
  • Valuable feedback

How to grant:

  1. Use admin commands (specific syntax may vary)
  2. Specify member and XP amount
  3. Optional: Add reason/note
  4. Confirm grant
Recognition Value

Manually granted XP for special contributions provides powerful recognition and motivates continued valuable participation.

XP Adjustments​

Admins can adjust XP if needed:

Scenarios for adjustment:

  • Correcting errors
  • Removing farmed XP
  • Resetting for events
  • Compensating for technical issues
  • Rebalancing after rule changes

Caution:

  • Use sparingly to maintain trust
  • Communicate reasons clearly
  • Consider community impact
  • Document adjustments

Integration with Other Features​

XP + Roles​

Connect XP levels to role assignments:

  • Automatic role grants at specific levels
  • Visual progression through role hierarchy
  • Permissions unlock with advancement
  • Custom role promotion messages

Example: Level 5 → "Active Member" role

XP + Quizzes​

Award XP for quiz participation:

  • Set XP per correct answer
  • Bonus for quiz completion
  • Special quiz events with bonus XP
  • Educational content with rewards

XP + Leaderboard​

Display top XP earners:

  • Competitive element drives engagement
  • Recognition for top contributors
  • Periodic leaderboard updates
  • Prizes for leaderboard winners

XP + Token Gating​

Reward verified token holders:

  • One-time XP bonus for verification
  • Higher initial level for holders
  • Exclusive XP multipliers
  • Holder-only XP events

XP + Content Scaling​

Reward content interaction:

  • XP for attending scheduled events
  • Bonus XP during special posts
  • Tweet interaction rewards
  • Time-based XP events

Troubleshooting​

Members not earning XP?

  • Verify XP is enabled (🟢)
  • Check cooldown hasn't just triggered
  • Ensure member isn't muted or restricted
  • Verify message meets minimum requirements
  • Check bot permissions

XP earning too slow?

  • Increase Messages XP value
  • Decrease cooldown time
  • Add more XP sources (quizzes, reactions)
  • Implement manual XP grant system
  • Review level requirements

XP earning too fast?

  • Decrease Messages XP value
  • Increase cooldown time
  • Adjust level requirements upward
  • Review if spam is occurring
  • Check for XP farming

Spam/farming issues?

  • Increase cooldown significantly
  • Lower XP per message
  • Implement stricter moderation
  • Use flood control features
  • Review and adjust if needed

Level-up messages not appearing?

  • Check level-up messages are enabled
  • Verify message template is set
  • Ensure bot has posting permissions
  • Check message isn't being filtered
  • Test with manual level grant

Roles not granting at level-up?

  • Verify role is connected to level
  • Check bot has role management permissions
  • Ensure role exists and is configured
  • Review role settings
  • Test with manual role grant

Advanced Strategies​

Dynamic XP Events​

Create temporary XP boosts:

Weekend Boost:

  • 2x XP on weekends
  • Announce in advance
  • Track engagement increase
  • Make it recurring

Topic-Based Multipliers:

  • Bonus XP for specific discussions
  • Themed days with extra rewards
  • Educational content bonuses
  • Quality contribution recognition

Tiered Reward System​

Different XP rates by member status:

New Members (0-100 XP):

  • Higher XP earn rate
  • Faster initial progression
  • Encouraging start

Regular Members (100-1000 XP):

  • Standard XP rates
  • Balanced progression
  • Sustained engagement

Veterans (1000+ XP):

  • Lower XP rates but higher quality rewards
  • Prestige levels
  • Special recognition

Seasonal Resets​

Periodic XP seasons:

Season Structure:

  • 3-month seasons
  • Leaderboard resets
  • Seasonal rewards
  • Cumulative lifetime XP preserved
  • Fresh competition regularly

XP Economy​

Create XP value system:

XP Spending:

  • Special privileges
  • Custom roles
  • Exclusive access
  • Contest entries
  • Community perks
Balance Economy

If implementing XP spending, carefully balance earning and spending rates to maintain engagement without inflation.

Analytics and Insights​

Tracking XP Metrics​

Monitor these key metrics:

Engagement Metrics:

  • Average XP per member
  • Daily XP earned (total)
  • Active XP earners (daily/weekly)
  • Messages per XP ratio
  • Level distribution

Progression Metrics:

  • Average time to each level
  • Level-up frequency
  • XP earning trends
  • Top earners
  • Inactive member XP

Optimization Metrics:

  • Spam rate vs cooldown
  • Engagement vs XP rates
  • Level completion rates
  • Member retention by XP tier
  • Event XP impact

Using Data for Improvement​

Identify patterns:

  • When is engagement highest?
  • Which XP rates drive best behavior?
  • Are levels too easy/hard?
  • Is cooldown effective?
  • Are members motivated by progression?

Make adjustments:

  • Optimize XP rates based on data
  • Adjust cooldowns for spam prevention
  • Rebalance levels if needed
  • Time events for maximum impact
  • Reward what you want to encourage
Foundation of Engagement

XP is the foundation of Fren One's gamification system. Start with balanced settings, monitor engagement, and adjust based on community feedback. A well-tuned XP system drives long-term engagement and builds a thriving community!