Invite & Promo Tracking

The Invite & Promotion Tracking System in OneeChan allows server administrators to track invites, manage promotional campaigns, and analyze user growth through invite codes.

This system automatically tracks invites, logs who invited whom, and calculates promotional costs per user or verified member. Administrators can create, remove, and monitor promotional campaigns linked to invites.

---

Features

• Invite Tracking – Detects which invite was used when a new member joins.

• Invite Leaderboard – Displays top inviters for different time periods.

• Promo Management – Assigns promotional campaigns to invite codes for tracking.

• Cost Analysis – Tracks cost per join and cost per verified user for promotions.

• Source Management – Allows tracking of invite sources (ads, campaigns, etc.).

• Vanity URL Support – Logs vanity invite usage if enabled.

---

Invite System Slash Commands

/invites list – View Top Inviters

Required Permission: Administrator Description: Lists the top inviters in a selected time period.

Argument	Type	Required	Description
period	enum	✅ Yes	View invites for 24h, 7d, 14d, or 30d.

Example Usage

/invites list period:7d

Example Output:

---

/invites source – Manage Invite Sources

Required Permission: Administrator Description: Assigns, removes, or lists invite sources for tracking.

Argument	Type	Required	Description
action	enum	✅ Yes	Choose add, remove, or list.
invite_code	string	❌ No	Invite code to update (required for add).
source_name	string	❌ No	Source name to assign (required for add).

Example Usage

/invites source action:add invite_code:"abcd123" source_name:"Ad Campaign"

Example Output:

Invite 'abcd123' has been assigned to source 'Ad Campaign'.

Removing an Invite Source

/invites source action:remove invite_code:"abcd123"

Example Output:

Invite 'abcd123' has been removed from the source tracking.

Listing Invite Sources

/invites source action:list

Example Output:

Current Tracked Invite Sources:
- Invite: abcd123 | Source: "Ad Campaign"
- Invite: efgh567 | Source: "Partnership Event"

---

/invites lookup – Find Users Invited by a Specific User or Invite Code

Required Permission: Administrator Description: Finds users invited by a specific user or invite code.

Argument	Type	Required	Description
user	@user	❌ No	Look up users invited by a specific user.
invite_code	string	❌ No	Look up users who joined via a specific invite.

Example Usage

/invites lookup user:@UserA

/invites lookup invite_code:"abcd123"

Example Output:

Users invited by @UserA:
✅ - @NewMember1 (Joined 3 days ago)
❌ - @LeftMember (Joined 5 days ago, left 2 days ago)

---

Promo System Slash Commands

/promo add – Create a New Promo Campaign

Required Permission: Administrator Description: Creates a new promotional campaign linked to an invite.

Argument	Type	Required	Description
invite_code	string	✅ Yes	The invite code to link the promo to.
promo_name	string	✅ Yes	The name of the promo.
start_date	date	✅ Yes	The start date of the promo.
duration_days	int	✅ Yes	How long the promo lasts.
price	decimal	✅ Yes	The price of the promo campaign.
type	enum	✅ Yes	Type of promo (one-time, time-limited).

Example Usage

/promo add invite_code:"abcd123" promo_name:"Spring Sale" start_date:"01-04-2024" duration_days:30 price:100 type:time-limited

Example Output:

Promo 'Spring Sale' added for invite 'abcd123'.

---

/promo list – View Active Promotions

Required Permission: Administrator Description: Lists all active promotions currently running.

Example Usage

/promo list

Example Output:

Active Promotions:
1. 'Spring Sale' - Invite Code: abcd123 | Price: $100 | 30 days
2. 'Summer Boost' - Invite Code: efgh567 | Price: $200 | 14 days

---

/promo remove – Remove a Promo from an Invite Code

Required Permission: Administrator Description: Deletes a promo campaign linked to an invite.

Argument	Type	Required	Description
invite_code	string	✅ Yes	The invite code to remove.

Example Usage

/promo remove invite_code:"abcd123"

Example Output:

Promo 'Spring Sale' linked to 'abcd123' has been removed.

---