Invites

Overview

Tracks who invited whom, with a leaderboard of who’s bringing in the most members. Use it to reward members who grow the server, run invite contests by week or month, or find out how someone joined. Petto counts on its own once it can see the invite links; there is nothing to turn on.

liam runs invites top and Petto lists the top six inviters with their invites, joins, leaves and bonus — In Discord: the invite leaderboard of the server.

Commands

!invites user [user]
!invites top [all|week|month]
!invites who [user]
!invites list [user]
!invites codes [user]
!invites bonus <user> <amount>
!invites reset <user>
!invites config [fake_days] [quick_leave_minutes] [ignore_bots] [subtract_leaves]
!invites reward add <invites> <role>
!invites reward remove <role>
!invites reward list

!invites user @Someone
!invites who @NewMember
!invites bonus @Someone 5

user defaults to yourself if omitted, and !invites alone is !invites user. Short name: !invs. Petto needs Manage Server to see the invite links.

Invites = joined - left + bonus. The leaderboard (top) is ordered by this number. With subtract leaves off (see the settings below) the members who left stay in it: joined + bonus.
Fake joins are not counted: an account less than 3 days old, or somebody who left and came back. When a fake member leaves, that does not count either.
who says who invited a member and how: an invite, the server’s vanity link, or a link Petto could not tell. A single-use invite is recognized too.
list shows the last 15 members someone brought. codes shows the links someone made and how much each was used.
bonus adds (or, with a negative number, takes away) bonus invites and needs Manage Server. reset puts someone’s counters back to zero and needs Administrator.
top week and top month rank who brought the most members in the period (weeks start on Monday, in GMT-5).
config alone shows the four settings of the server. To change one, give it a value: !invites config --fake_days 7 (the short name is !icon, so !icon --fake_days 7), or in order, !icon 7 10 on off. Slash: /invites config fake_days:7. Changing needs Manage Server; looking does not.

Settings

Setting	Default	What it does
`fake_days`	3	An account younger than this many days (0 to 365) is a fake join. 0 turns the age check off; somebody who comes back is always fake.
`quick_leave_minutes`	0 (off)	A member who leaves within this many minutes (0 to 1440) of joining counts as a fake join instead of a real one, so the invite is not credited.
`ignore_bots`	off	Bot accounts are written down (as coming from a bot) and never credited to an inviter. Bots do not use invite links, so this only keeps them out of the record.
`subtract_leaves`	on	The members who left are taken off the total. Turn it off to keep them in it (joined + bonus).

Nothing changes until you change a setting: the defaults are how the tracker always worked. The same total is used by !invites, the leaderboards, the reward roles and {inviter.invites}.

The AutoMod invite link filter is a different thing: it deletes messages that advertise other servers (see Allowed invites). The tracker here only counts who brought whom in.

!invites user

!invites top week

!invites who

!invites list

!invites codes

!invites bonus

!invites reset

!invites config

!invites config fake_days

!inviteinfo <code> (short !ii) shows where an invite link leads, from any server: the server, its description, members and online members, the channel, who made the link and when it ends.

Chillet runs !inviteinfo discord.gg/cozycafe: Cozy Café with its description, the code, the channel, who made it, never expires, 2416 members and 538 online, and an Open invite button — In Discord: what an invite link of another server leads to.

Rewards

!invites reward add 10 @Recruiter gives that role to whoever reaches 10 invites, and takes it away if they fall below. Add as many as you like with reward add, remove one with reward remove and see them with reward list. When you add a reward, Petto gives it to those who already have enough. The role has to be below Petto’s highest role and below yours.

!invites reward add

!invites reward remove

!invites reward list

Dashboard

The Invites tab of Statistics on the dashboard has an Invite settings part with the same checks as the commands:

Roles for invites: add a role and how many invites earn it (choosing a role that is already there changes its number), or remove one. Members who already have enough get it right away; members who have it keep it when it is removed.
Settings: the four settings above in one card, with one Save settings button: the account age in days (0 to 365) under which a join does not count (with 0, a new account counts like any other), the minutes of a quick leave (0 to 1440, 0 is off), Ignore bot accounts and Take away members who left. The fields use the full width on a phone.
Top inviters: the leaderboard with a filter for All time, This week or This month. Click a name to look at that member.
Look up a member: type a name (or paste a member ID) to see their joined, left, fake, bonus and total, who invited them and how, and the codes they brought people in with. The tab reads this from the database, so looking costs the bot nothing.
Adjust the invites of a member: Add bonus (a negative number takes invites away) or Reset to zero. Reward roles follow the new number. Resetting needs Administrator, like the command.

The Invites tab of Statistics with the joins through invites per day, the top inviters, two roles for invites and the fake joins setting — Dashboard → Statistics → Invites: joins through invites, the top inviters and the Invite settings.

The Adjust the invites of a member card with a member box, the bonus number, Add bonus and Reset to zero — Dashboard → Statistics → Invites: Adjust the invites of a member: a bonus (negative takes away) or a reset to zero.

Variables for the welcome message

In the welcome message (and the DM on join) you can use {inviter} (mentions who invited, or Unknown), {inviter.name}, {inviter.id}, {inviter.invites} (how many invites that person has) and {invite.code}. For example Welcome {user}! Invited by {inviter.name}, who now has {inviter.invites} invites. See Invites variables.

In #welcome Petto says: Welcome @sam! Invited by mia.draws, who now has 29 invites. — In Discord: a welcome message that names who invited the new member and how many invites they have.

Joins and leaves are also counted per day for !summary and the dashboard’s Statistics page.

Overview

Guides

Concepts

Moderation

Automation

Community

Roleplay

Miscellaneous

Onboarding

Setup

Resources

Common Issues

Changelog

Overview