Skip to main content

Buddy Invite System

What is the Buddy Invite System?​

The Buddy Invite System is a powerful feature that allows server administrators to create special invite links that automatically assign specific roles to new members after they complete the server's verification process. This is perfect for:

  • Friend Referrals: Create special invites for trusted community members to bring their friends
  • Role-Specific Recruitment: Invite people directly to specific roles (VIP, Helper, Beta Tester, etc.)
  • Controlled Growth: Limit how many people can use each special invite
  • Temporary Access: Set expiration dates for special invites

🎯 How It Works​

The Process Flow:​

  1. Admin creates a buddy invite with /invite-buddy command
  2. Friend receives the special invite link and joins the server
  3. New member goes through verification (emoji/captcha verification)
  4. Upon successful verification, they automatically receive the assigned role
  5. Invite tracks usage and expires when limits are reached

Key Features:​

  • ✅ Automatic Role Assignment after verification
  • ✅ Usage Limits (1-100 uses per invite)
  • ✅ Time Limits (1-30 days expiration)
  • ✅ Verification Required (no bypassing security)
  • ✅ Admin-Only Creation (prevents abuse)
  • ✅ Detailed Tracking (who used what invite)

🛠️ How to Use the Buddy Invite System​

Prerequisites​

Before creating buddy invites, your server must have:

  • ✅ Verification system enabled (/add-user-verification-security)
  • ✅ Administrator permissions (for creating buddy invites)
  • ✅ Bot permissions to create invites and manage roles

Creating a Buddy Invite​

Use the /invite-buddy slash command with these parameters:

Command Format:

/invite-buddy role:[role] uses:[number] days:[number]

Parameters:

  • role (Required): The role to assign after verification
  • uses (Required): Maximum uses before expiring (1-100)
  • days (Required): Days until expiration (1-30)

Examples:

Create VIP invite for friends (5 uses, 7 days):

/invite-buddy role:@VIP Member uses:5 days:7

Create temporary beta tester invite (10 uses, 3 days):

/invite-buddy role:@Beta Tester uses:10 days:3

Create single-use moderator invite (1 use, 30 days):

/invite-buddy role:@Helper uses:1 days:30

What You'll Get Back​

After creating a buddy invite, you'll receive:

  • 🔗 Unique Invite Link (share this with your friend)
  • 🎯 Target Role confirmation
  • 📊 Usage limit information
  • 📅 Expiration date (when it expires)
  • 📋 How it works explanation

🚀 Usage Scenarios​

1. Friend Referrals​

Scenario: You want to invite your gaming buddies to get VIP access
Command: /invite-buddy role:@VIP uses:5 days:14
Result: Friends get VIP role after joining and verifying

2. Community Helper Recruitment​

Scenario: Looking for new community helpers
Command: /invite-buddy role:@Helper uses:3 days:7
Result: Trusted members can bring qualified friends as helpers

3. Event-Specific Invites​

Scenario: Special tournament participant role
Command: /invite-buddy role:@Tournament Player uses:20 days:2
Result: Tournament participants get role after verification

4. Beta Testing Programs​

Scenario: Limited beta tester recruitment
Command: /invite-buddy role:@Beta Tester uses:10 days:30
Result: Selected testers get beta access after verification

📋 Important Information​

Security Features​

  • Verification Required: All buddy invite users MUST complete verification
  • No Bypass: Cannot skip emoji/captcha verification process
  • Admin Only: Only administrators can create buddy invites
  • Role Hierarchy: Cannot assign roles higher than your own

Expiration Rules​

Buddy invites expire when either condition is met:

  • ✅ Maximum uses reached (e.g., 5 people used a 5-use invite)
  • ✅ Time limit reached (e.g., 7 days have passed)

Verification Process​

Users joining via buddy invite will experience:

  1. Join the server using the special invite link
  2. See verification channel with emoji/captcha challenges
  3. Complete verification (select correct emoji or solve captcha)
  4. Receive target role automatically after successful verification
  5. Access server with their new role permissions

Tracking & Management​

  • Usage tracking: See who used each invite
  • Automatic cleanup: Expired invites are automatically removed
  • Error handling: Robust system prevents role assignment failures

❓ Frequently Asked Questions​

Q: What happens if someone joins but doesn't verify?​

A: They won't receive the special role. The role is only assigned after successful verification.

Q: Can I create multiple buddy invites for the same role?​

A: Yes! You can create as many different buddy invites as needed, each with their own limits.

Q: What if the invite expires?​

A: Expired invites no longer work. You'll need to create a new buddy invite if needed.

Q: Can I see who used my buddy invites?​

A: Yes, the system tracks usage. Administrators can see who joined via which invite.

Q: What if verification is disabled after creating a buddy invite?​

A: The buddy invite will still work, but users won't receive the special role since verification is required.

Q: Can I assign roles higher than my own permissions?​

A: No, Discord's role hierarchy prevents assigning roles higher than your highest role.

🔧 Troubleshooting​

Common Issues & Solutions​

"Verification Not Configured" Error

Problem: Trying to create buddy invite without verification setup Solution: Run /add-user-verification-security first to set up verification

"Missing Permissions" Error

Problem: Don't have administrator permissions Solution: Ask a server administrator to create the buddy invite

"Role Not Found" Error

Problem: Selected role doesn't exist or was deleted Solution: Choose a valid role that still exists in the server

Invite Link Not Working

Problem: Invite expired or reached maximum uses Solution: Create a new buddy invite with /invite-buddy

User Didn't Get Role After Verification

Problem: System error or role assignment failure Solution: Check role hierarchy and bot permissions, may need manual role assignment

🎉 Best Practices​

Creating Effective Buddy Invites​

  • Use descriptive role names that clearly indicate purpose
  • Set reasonable limits (5-10 uses for friend groups, 1-3 for special access)
  • Choose appropriate expiration (shorter for events, longer for general recruitment)
  • Communicate clearly with invite recipients about the verification process

Managing Your Community​

  • Monitor usage to see which invites are popular
  • Create themed invites for different purposes (friends, helpers, events)
  • Use time limits to maintain urgency and control
  • Regular cleanup of old/unused invites

Security Tips​

  • Only share with trusted people who you want to have the special role
  • Don't share publicly unless intended for public recruitment
  • Set conservative limits to prevent unexpected growth
  • Monitor new members to ensure they're legitimate

📞 Support​

If you encounter issues with the Buddy Invite System:

  1. Check Prerequisites: Ensure verification is set up and you have admin permissions
  2. Review Parameters: Verify role exists and limits are within bounds (1-100 uses, 1-30 days)
  3. Test the Flow: Try the invite yourself to ensure it works as expected
  4. Contact Support: If problems persist, contact server support with specific error messages

The Buddy Invite System enhances your server's growth while maintaining security through verification requirements. Use it to build a stronger, more engaged community! 🌟