Invite-Tracking
Track who invited who
Using this module to reward users for inviting other users in any way is in violation of Discord's Developer Policy and our Terms of Service; violations will lead to your server (and your account) being banned from SCNX. Report abuse to [email protected].
Features
- Log new user joins and who invited them and easily remove the invite by clicking a button below the log message.
- Trace the invite activity of a user, including
- who invited the user.
- who the user invited.
- what invites the user has created.
- Easily revoke all invites created by a user.
- Distinguish between active invites and invites where the invited user has already left the server.
- Integrates with the Info Commands and Moderation & Security modules.
Setup
- Make sure your bot has "Manage invites" permissions on your server.
- Enable the module to start tracking invites - you might need to restart your bot to initiate the required hook.
- Please set up permissions for
/trace-invites
to avoid unauthorized usage. - To log new joins and their invitees, configure a log-channel - make sure the bot has the "Send messages" permissions on the channel. Please note that users with the "Manage invites" permission on your server will be able to revoke invites by clicking on the "Remove this invite" button below the log entry message.
Usage
- If configured, the bot will log who invited the new user when they join in the log channel.
- The bot will automatically store invite data about every user that joins your server.
- To get invite activity (who invited the user, who the user invited, invites created, …) of a user, run
the
/trace-invites
Slash-Command. - To revoke all invites of a user, run the
/trace-invites
Slash-Command and click on "Remove all invites by this user" button below the message. - If this module is enabled, other modules (such as Moderation & Security and Info Commands) will use data about tracked invites to improve functionality - this is done automatically.
Commands
name
und dem Typen Typ
als name:<Typ>
. Optionen, die nicht Pflichtfelder sind, werden als [name:<Typ>]
angegeben. Wenn sich die Aktionen eines Befehls zwischen Pflichtfeldern und Nicht-Pflichtfeldern sehr unterscheiden, listen wir sie eventuell separat.Beispiele
/moderate ban user:<Mitglied>
: Dieser Befehl (/moderate ban) hat nur eine verpflichtende Option mit dem Namen "user", die nur ein Mitglied akzeptiert./moderate ban victim:<Mitglied> reason:<Text>
: Dieser Befehl (/moderate ban) hat eine Option mit dem Namen "victim" als Pflichtangabe, die nur ein Mitglied akzeptiert, und ein weiteres Pflichtfeld mit dem Namen "reason", das jeglichen Text als Wert akzeptiert./moderate ban victim:<Mitglied> reason:<Text> [proof:<Anhang>]
: Dieser Befehl (/moderate ban) hat eine Option mit dem Namen "victim" als Pflichtangabe, die nur ein Mitglied akzeptiert, und ein weiteres Pflichtfeld mit dem Namen "reason", das jeglichen Text als Wert akzeptiert. Zusätzlich gibt es eine optionale Option mit dem Namen "proof", die einen Anhang als Wert akzeptiert.
Command | Description |
---|---|
/trace-invites user:<User> | This commands shows the invite activity of a user. Information includes who invited the user, who the user invited and what invites the user created. Additionally, a button to revoke all invites created by this user will be added below the response. |
Configuration
Use this configuration file to set up a Logging-Channel - open the file in your Dashboard.
Field | Description |
---|---|
Log-Channel | Configure a log channel here. Anytime a user joins or leaves your server, your bot will log what invite the user used. A button to remove the invite will be added below the message (can be used by anyone with "Manage invites" permission). |
Troubleshooting
If you are experiencing issues with this module, make sure that
- the bot has the "Manage invites" permission on your server.
- you have restarted the bot after enabling this module and after granting "Manage invites" permissions.
- the bot has the "Send messages" and "Embed links" permissions in the configured Log-Channel.
- you are not requesting information about a user that joined via an untracked invite - the bot is only able to store data about users that joined AFTER the module was enabled.
Stored data
When a user joins your server and the module is enabled, the following data will be stored:
- An unique integer identifying the database entry.
- The ID of the user who joined.
- Whether the user has left the server in the meanwhile.
- The code of the invite used.
- The type of the invite (e.g: Vanity-Invite).
- The ID of the user who created the invite used.
- Metadata about the entry (date when created and last updated).
When a user leaves your server, the invite entry will be marked as "inactive", but won't be deleted.
To avoid manipulation of data, this stored data can't be deleted on case-by-case basis. Instead, you can purge the module database to delete all data stored about invites.