> For the complete documentation index, see [llms.txt](https://docs.tektools.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tektools.app/product-guides/configuring-in-discord/invite-tracker.md).

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