Invite Tracker plugin

See who invited whom: every join is matched to the invite it came through, so members get an invite count (with fake and rejoin detection), there's a leaderboard, and staff can look up who invited anyone. Tracked links record where members came from and can give them roles, join and leave messages can name the inviter, the dashboard shows analytics, and a join burst can alert staff or pause invites.

There are no rewards for invite counts. Discord's Platform Manipulation Policy prohibits invite rewards, so counts never give roles, coins or anything else. The only roles involved are a tracked link's roles, given for joining through that link (they record where someone came from and don't reward the inviter).

Everything is free. The only limits are hard caps (50 tracked links per server, 5 roles per link).

#Configuration

Dashboard-managed: the Invite Tracker page on the website covers settings, the leaderboard, member lookups, tracked links, analytics and raid pausing.

plugins:
  invite_tracker:
    enabled: true
    config:
      log_channel_id: "123456789012345678"
      ignore_bots: true
      blacklist:
        user_ids: []
        role_ids: []
      count_on: join              # or verified (wait for Passport)
      passport:
        pending_timeout_hours: 72
      fake:
        min_account_age_days: 7
        rejoin_policy: fake        # count | fake | ignore
        quick_leave_minutes: 0     # 0 = off
        quick_leave_as: left       # left | fake
      join_message:
        enabled: true
        channel_id: "234567890123456789"
        message:
          content: "{user} joined, invited by **{inviter_name}** ({invites} invites)"
        unknown_message:
          content: "{user} joined via {join_source}"
      leave_message:
        enabled: true
        channel_id: "234567890123456789"
        message:
          content: "{user_name} left. They were invited by **{inviter_name}** ({invites} invites)"
      leaderboard:
        show_left: true
        show_fake: true
      raid:
        enabled: true
        threshold_joins: 10
        window_seconds: 60
        action: alert              # alert | delete_invite | pause_all
        pause_minutes: 60
        alert_role_id: "345678901234567890"
      retention_days: 365

#Placeholders

On top of the usual welcomer placeholders ({user}, {user_name}, {user_display}, {guild}, ...):

Join and leave messages only ever ping the member who joined.

#Counting

A member's total is regular − left − fake + bonus, always worked out from the stored joins:

• Regular: every join through their invite that isn't waiting on Passport.
• Left: a counted join whose member has since left.
• Fake: a join counted as fake, for one of the reasons above (self is someone joining through their own invite).
• Bonus: manual adjustments from /invites bonus or the dashboard.

Resets are soft: joins before the reset stop counting (and bonuses are cleared), but the join history and analytics stay.

#Commands

can_view and can_view_others are granted to the built-in Member role, can_raid to Moderator, and can_manage to Admin.

#Behavior

• Joins are matched by comparing the server's invite uses before and after each join, one join at a time per server. A single-use invite that vanished counts too. When several invites go up at once (or during a burst of joins, or before the cache is ready after a restart), the join is unknown.
• Tracked links are invites created by Dreamliner, so they credit nobody; joins through them are recorded against the link instead. Deleting a link deletes the Discord invite but keeps its stats.
• With count_on: verified, the join message and the link's roles wait until the member passes Passport.
• Pausing uses Discord's own "pause invites" (up to 24 hours), so it shows in the server settings too.

#Requirements

• Manage Server, to read invites (without it every join is unknown) and to pause invites.
• Create Invite in a tracked link's channel.
• Manage Roles for tracked-link roles, which must sit below the bot's highest role and carry no staff permissions.