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