Kanin's BotBaseAnalytics - Invite Tracking
When someone joins, the bot works out which invite they used and credits its creator (the inviter). /invites view and /invites top then show each inviter's totals, and the Successful Invites metric can feed activity roles and leaderboards.
Invite tracking runs in every server the bot is in; there is nothing to switch on. The bot needs the Manage Server permission to read your invites. Joins through the server's vanity URL have no inviter, so nobody is credited for them.
How the total is calculated
Each inviter has four numbers:
| Number | What it counts |
|---|---|
| Successful | Every member who joined through one of their invites |
| Fake | Of those, members whose Discord account was newer than the Fake invite account age threshold when they joined |
| Left | Of the non-fake ones, members who have since left the server |
| Bonus | Manual adjustments by admins with /invites add and /invites remove (can be negative) |
Total = successful - fake - left + bonus. /invites view shows all four and the total, and /invites top ranks inviters by total (it notes the formula under the list).
Fake accounts
Accounts created just before joining are often alts or raid accounts. Set Fake invite account age threshold on the Settings tab to a number of days (for example 7): a join from a newer account still counts as successful but is also counted as fake, so it adds nothing to the total. It is 0, off, by default.
Manual adjustments
Admins can correct totals, for example after a contest or a mistaken attribution:
/invites add member: amount: reason:adds 1 to 10,000 bonus points./invites remove member: amount: reason:subtracts points./invites reset member: reason:sets the member's bonus back to zero (their tracked invites stay).
Every adjustment is recorded in the staff log with its reason.
Commands
| Command | Description | Options | Permission |
|---|---|---|---|
/invites add | Add manual invite bonus to a member | member (member): The member to creditamount (whole number; 1 to 10,000): How many invite points to addreason (text; optional; length 1 to 300): Why this manual bonus is being applied | Admin |
/invites remove | Remove invite points from a member via manual adjustment | member (member): The member to debitamount (whole number; 1 to 10,000): How many invite points to removereason (text; optional; length 1 to 300): Why this manual removal is being applied | Admin |
/invites reset | Reset a member's manual invite bonus back to zero | member (member): The member to resetreason (text; optional; length 1 to 300): Why the manual invite bonus is being reset | Admin |
/invites top | Rank members by invite total | limit (whole number; optional; 1 to 25): How many members to show | Everyone |
/invites view | View invite totals for a member | member (member; optional): The member to inspect | Everyone |