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 more XP than the last, rewarding long-term engagement.

Default Level Progression:

Level 1: 100 XP
Level 2: 300 XP (400 total)
Level 3: 600 XP (1,000 total)
Level 4: 1000 XP (2,000 total)
Level 5: 1500 XP (3,500 total)
Level 6: 2100 XP (5,600 total)
Level 7: 2800 XP (8,400 total)
Level 8: 3600 XP (12,000 total)
Level 9: 4500 XP (16,500 total)
tip

These are default values. You can configure custom level thresholds under ⚡ XP Levels in the XP settings.

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​

Manage XP rewards and progression.

Core​

🔄️ Enabled / Disabled​

🔄️🟢 Enabled / 🔄️🔴 Disabled: Toggle XP rewards 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.

⏱️ Set Cooldown​

⏱️ Set Cooldown: How long members must wait between XP rewards.

Configuration:

  1. Click ⏱️ Set 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

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.

Earning​

💬 Set Messages XP​

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

Configuration:

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

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

👍 Set Reactions XP​

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

Configuration:

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

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.

Levels​

⚡ 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

Add Level:

  1. Click ➕ Add Level
  2. Specify the level number, XP required for the new level and an optional custom Reward
  3. 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

Extras​

🎲 XP Drops​

🎲 XP Drops: Configure XP drops for long messages.

🎁 Daily Claim​

🎁 Daily Claim: Configure daily claim rewards.

🔑 Secret Codes​

🔑 Secret Codes: Create and manage secret codes that award XP.

🔄 Reset XP​

🔄 Reset XP: Reset XP for all members.

Admin Commands​

CommandDescription
/xp [username/id/reply]Show the current XP and level of a user
/setxp [username/id/reply]Manually set XP for a user
/claimClaim your daily XP reward (once per day)
/meShow your personal stats, XP, roles, and profile information
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

On this page