# Invite Tracker

## 🎯 Invite Tracker - User Guide

### What is Invite Tracker?

The Invite Tracker is a powerful system that **rewards members for bringing quality people to your Discord server**. It automatically tracks who invited each new member and gives points when those invited members meet certain conditions like staying active and getting verified.

### 🚀 Quick Start

#### For Server Admins

1. **Set up the system**: `/invite-tracker setup reward:100`
2. **View your settings**: `/invite-tracker view`
3. **Check the leaderboard**: `/invite-tracker leaderboard`

#### For Members

* **Check your invite stats**: `/invites`
* **View someone else's stats** (admins only): `/invites user:@username`

***

### 📋 Admin Commands

> **Note**: All admin commands require Administrator permissions

#### `/invite-tracker setup`

**Purpose**: Configure the invite tracking system for your server

**Required Options**:

* `reward` - Points awarded for each successful invite (0 to 1,000,000)

**Optional Options**:

* `required-role` - Role that invited users must get before the inviter receives rewards
* `minimum-stay` - Days an invited user must stay before rewards are given (0 to 30)

**Examples**:

```
/invite-tracker setup reward:50
```

*Simple setup: 50 points per invite, no other requirements*

```
/invite-tracker setup reward:200 required-role:@Verified minimum-stay:7
```

*Quality setup: 200 points per invite, but only if the invited user gets @Verified role and stays for 7 days*

```
/invite-tracker setup reward:100 minimum-stay:3
```

*Retention setup: 100 points per invite if the user stays for 3 days*

***

#### `/invite-tracker view`

**Purpose**: See your current invite tracker settings

**What it shows**:

* Current reward amount per successful invite
* Required role (if any)
* Minimum stay requirement (if any)
* Whether the system is enabled or disabled
* Edit button for quick changes

**Example Output**:

```
🎯 Invite Tracker Configuration
Status: ✅ Enabled

💰 Reward Amount: 100 points per successful invite
👤 Required Role: @Verified
⏰ Minimum Stay: 7 days
```

***

#### `/invite-tracker edit`

**Purpose**: Change specific settings without redoing the full setup

**How it works**:

1. Run the command
2. Select what you want to edit from the dropdown menu:
   * **Reward Amount** - Change points per invite
   * **Required Role** - Set or remove role requirement
   * **Minimum Stay** - Change days requirement
   * **Enable/Disable** - Turn system on/off

**When to use**: When you want to adjust one setting without affecting others

***

#### `/invite-tracker leaderboard`

**Purpose**: View the top 10 inviters on your server

**What it shows**:

* Rankings with medals (🥇🥈🥉) for top 3
* Each person's total invites, successful invites, and rewards earned
* Updated usernames from Discord

**Example Output**:

```
🏆 Invite Tracker Leaderboard - Top Inviters

🥇 JohnDoe
📊 Total: 25 | ✅ Successful: 20 | 💰 Rewards: 2000

🥈 JaneSmith
📊 Total: 18 | ✅ Successful: 15 | 💰 Rewards: 1500

🥉 BobWilson
📊 Total: 12 | ✅ Successful: 10 | 💰 Rewards: 1000
```

***

### 👥 Member Commands

#### `/invites`

**Purpose**: Check your personal invite statistics

**Options**:

* `user` (optional, admin only) - View stats for another member

**What it shows**:

* **Total Invites**: How many people you've invited
* **Successful Invites**: How many earned you rewards
* **Pending Invites**: Waiting for conditions to be met
* **Total Rewards Earned**: Points you've received
* **Left Early**: People who left before meeting requirements
* **Left After Reward**: People who left after you got rewarded (points were deducted)
* **Recent Invites**: Last 5 people you invited with their status

**Example Output**:

```
🎯 Invite Statistics for JohnDoe

📊 Total Invites: 15        ✅ Successful Invites: 12
⏳ Pending Invites: 2       💰 Total Rewards Earned: 1200 points
❌ Left Early: 1            ↩️ Left After Reward: 0

📋 Recent Invites (Last 5)
✅ Alice123 - 6/10/2025
⏳ Bob456 - 6/12/2025
✅ Charlie789 - 6/14/2025
⏳ Dana101 - 6/15/2025
✅ Eve202 - 6/16/2025
```

***

### 🎮 How It Works

#### The Process

1. **Admin sets up the system** with rewards and conditions
2. **Members create invite links** (using Discord's regular invite feature)
3. **New people join** using those invite links
4. **System tracks** who invited whom
5. **Conditions are checked**:
   * Does the new member get the required role?
   * Do they stay for the minimum time?
6. **Rewards are given** when all conditions are met
7. **Points are deducted** if someone leaves after you were rewarded

#### Status Meanings

* **⏳ Pending**: Waiting for conditions to be met
* **🔄 Qualified**: Conditions met, processing reward
* **✅ Rewarded**: You received points for this invite
* **❌ Left Early**: Person left before meeting requirements
* **↩️ Left After Reward**: Person left after you got points (points deducted)

***

### 💡 Tips for Success

#### For Admins

* **Start with moderate rewards** (50-100 points) and adjust based on activity
* **Use role requirements** to ensure quality members (like verification roles)
* **Set reasonable minimum stays** (3-7 days works well for most servers)
* **Monitor the leaderboard** to see who's actively helping grow your server
* **Adjust settings** based on your server's point economy

#### For Members

* **Share your invites** in relevant places where your target audience hangs out
* **Help new members** get verified or obtain required roles
* **Be welcoming** to increase the chances people will stay
* **Check your stats regularly** with `/invites`
* **Focus on quality over quantity** - it's better to invite people who will stay

***

### 🔧 Troubleshooting

#### "I'm not getting rewards for my invites"

* Check if the invited person got the required role
* Verify they've stayed for the minimum time requirement
* Make sure the system is enabled (`/invite-tracker view`)

#### "Someone left and I lost points"

* This is normal behavior - if someone leaves after you were rewarded, the points are deducted
* Focus on inviting people who are likely to stay and be active

#### "The leaderboard isn't showing anyone"

* Make sure people are actually using invite links (not just joining directly)
* Verify the system is properly set up and enabled
* Give it time - data accumulates as people invite others

***

### 🎯 Best Practices

#### Recommended Configurations

**For Community Servers**:

```
/invite-tracker setup reward:75 required-role:@Member minimum-stay:5
```

**For Gaming Servers**:

```
/invite-tracker setup reward:100 required-role:@Verified minimum-stay:3
```

**For Professional Servers**:

```
/invite-tracker setup reward:150 required-role:@Verified minimum-stay:14
```

#### Building a Healthy Community

* **Reward quality**: Use role and stay requirements
* **Encourage engagement**: Higher rewards for longer stays
* **Monitor regularly**: Check leaderboards and adjust settings
* **Recognize top inviters**: Maybe give special roles or perks to top performers

***

*This system integrates with your server's existing point economy. Points earned from invites can be used in shops, games, and other bot features!*


---

# 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/invite-tracker.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.