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

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

Example Output:

Removing an Invite Source

Example Output:

Listing Invite Sources

Example Output:


/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

Example Output:


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

Example Output:


/promo list – View Active Promotions

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

Example Usage

Example Output:


/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

Example Output:


Last updated