🤝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! 🌟

PreviousAnti-bot members captchaNextPassword lock

Last updated