# 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! 🌟*<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tektools.app/product-guides/configuring-in-discord/buddy-invite-system.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.