Medusa/modules/Invites

Invites

Tracks who invited each member, filters fake joins and gives roles at invite milestones.

Invites works out which invite each new member used and credits the person who made it.

Counting

Each member has four counts: regular, left, fake and bonus. Their total is regular minus left plus bonus.

  • A join counts as fake when the account is younger than Fake Account Age (Days). Fake joins never count toward the total.
  • A member who leaves and rejoins is also fake unless Credit Rejoins is on.
  • With Remove Invite On Leave on, the inviter loses the invite when the member leaves.
  • Joins through the server's vanity URL are tracked with no inviter.

Medusa needs the Manage Server permission to read invites. Without it, joins are recorded with an unknown inviter.

Milestone Roles

Give roles when a member's total reaches a number. Each milestone has an Invites Required count and a Reward Role. Reward Assignment Mode decides whether members keep every role they earned (Stack) or only the highest one (Highest).

Settings

Invite Settings

SettingDefaultWhat it does
Enable Invite TrackingOnTurns tracking on or off.
Announce JoinsOnPosts who invited each new member.
Announcement ChannelNoneWhere joins are announced.
Fake Account Age (Days)7Accounts younger than this are fake. 0 turns it off.
Remove Invite On LeaveOnTakes the invite away when the member leaves.
Credit RejoinsOffCounts members who rejoin.

Invite Milestone Roles

SettingDefaultWhat it does
Reward Assignment ModeStackKeep every earned role or only the highest.
Announce MilestonesOnPosts when a member reaches a milestone.
Milestone RolesNoneInvite counts and the role each one gives.

Commands

CommandWhat it does
/invites view [user]Show a member's counts.
/invites leaderboardShow the top inviters.
/invites add <user> <amount>Add bonus invites.
/invites remove <user> <amount>Remove invites.
/invites reset <user>Reset all of a member's counts.
View InvitesRight-click a member, then Apps > View Invites. Off by default on the Commands page.

Add, remove and reset need Invites ( Manage ) or Administrator. Totals also show on /leaderboard, and the Invite Events log records joins, leaves, fake joins, milestones and manual changes.