Settings
There are many config options that can be set. You don't have to set all of them. If you just added the bot, just run !setup, which will guide you through the most important ones.
Overview
General
Setting | Description |
Prefix | The prefix used to trigger bot commands. |
Language | The language of the bot |
Log Channel | The channel where bot actions are logged. |
Get Updates | Enable to receive development updates about InviteLogger. |
Command channels | The channels in which the bot will react to commands. |
Ignored channels | The channels in which the bot will ignore commands. |
Invites
General
Setting | Description |
Join Roles | Roles that are assigned to all members when joining. |
Joins
Setting | Description |
Message | The message sent when someone joins the server. |
Message Channel | The channel that the message on join is sent to. |
Leaves
Setting | Description |
Message | The message sent when someone leaves the server. |
Message Channel | The channel that the leave message is sent to. |
Auto Subtract | Automatically remove invites from the inviter when the invited user leaves. |
Auto Subtract Threshold | The time in seconds for which a user has to stay in the server for the invite to count. |
Leaderboard
Setting | Description |
Style | The display style of the leaderboard. |
Hide left members | Hide members that left the server from the leaderboard. |
Fakes
Setting | Description |
Auto Subtract | Automatically subtract fake invites. |
Ranks
Setting | Description |
Assignment Style | How ranks are rewarded to users. |
Announcement Channel | The channel where users receiving a new rank are announced. |
Announcement Message | The message that is sent when a user receives a new rank. |
Moderation
Captcha
Setting | Description |
Enabled | Whether or not captcha verification is enabled. |
Welcome Message | The message a user will get after joining a server and instructing them to enter the captcha. |
Success Message | The welcome message that will be sent to the user after he successfully verifies. |
Failed Message | The message sent to the user if he enters an invalid captcha. |
Verification Timeout | The time within which the captcha has to be entered successfully. |
Log Enabled | Whether or not verification attempts will be logged. |
General
Setting | Description |
Enabled | Automatically moderate messages (specific rules can also be turned on or off, this has to be ON for ANY rule to work). |
Moderated Channels | The list of moderated channels (this acts as a whitelist, leave empty to moderate all channels, or use |
Moderated Roles | The list of roles that are moderated (this acts as a whitelist, leave empty to moderate all roles, or use |
Ignored Channels | Channels that are ignored while automatically moderating. |
Ignored Roles | Any members with these roles will not automatically be moderated. |
Muted Role | The role that is given to people who are muted. Make sure this role is denied the "Send Message" permission. |
Disabled for Old Members | Disabled auto moderation for members that have been in your server for a long time. |
Old Members Threshold | The amount of time a member has to be in your server to be considered 'old'. |
Logging
Setting | Description |
Log Enabled | Log any moderation actions that the bot makes. |
Mod Log Channel | The channel where moderation logs will be posted in. |
Delete Bot Messages | Automatically delete the bots own messages (keeps your chat clean). |
Delete Bot Message Timeout | The timeout after which bot messages are deleted. |
Delete Ban Messages | Whether or not "Ban" pushment messages will be deleted automatically. |
Delete Kick Messages | Whether or not "Kick" pushment messages will be deleted automatically. |
Delete Softban Messages | Whether or not "Softban" pushment messages will be deleted automatically. |
Delete Warn Messages | Whether or not "Warn" pushment messages will be deleted automatically. |
Delete Mute Messages | Whether or not "Mute" pushment messages will be deleted automatically. |
Invites
Setting | Description |
Enabled | Automatically scan messages for discord invite links and remove them. |
Links
Setting | Description |
Enabled | Automatically remove messages containing links (you can set a whitelist and blacklist). |
Whitelist | A list of links that users are allowed to post. |
Blacklist | Blacklist certain links which users won't be able to post. |
Follow Redirects | Enable this to resolve redirects for links. |
Banned Words
Setting | Description |
Enabled | Whether or not blacklisted words will be automoderated. |
Blacklist | A list of words that are banned. |
Caps
Setting | Description |
Enabled | Automatically moderate messages with A LOT OF CAPS. |
Min. Characters | The minimum amount of characters in a message to be considered for moderating (setting to '3' would ignore 'OK'). |
Percentage CAPs | The percentage of characters of the message that have to be CAPs for the rule to trigger. |
Duplicate Messages
Setting | Description |
Enabled | Automatically moderate duplicate messages (copy-paste spam). |
Timeframe in Seconds | The timeframe whithin which messages will be considered duplicates. |
Spam
Setting | Description |
Enabled | Automatically moderate users sending a lot of messages in a short time. |
# of Messages | The number of messages that have to be sent within the timeframe to trigger the rule. |
Timeframe in Seconds | The timeframe within which a user is allowed to send a maximum amount of messages. |
Mentions
Setting | Description |
Enabled | Automatically moderate messages that mention an excessive amount of users. |
Max # of Mentions | The maximum amount of users a member can mention in a message. |
Enabled | Automatically moderate messages that mention an excessive amount of roles. |
Max # of Mentions | The maximum amount of roles a member can mention in a message. |
Emojis
Setting | Description |
Enabled | Automatically moderate messages with an excessive amount of emojis. |
Max # of Emojis | The maximum amount of emojis a message is allowed to have before trigger the rule. |
Enabled | Automatically give members nicknames if they try to hoist (use special characters to appear at the top of the user list). |
Prefix
The prefix used to trigger bot commands.
Type: String
Default: !
Reset to default: !config prefix default
Examples:
!config prefix +
!config prefix >
Language
The language of the bot
Type: Enum<Lang>
Default: en
Reset to default: !config lang default
Possible values: ar, bg, cs, de, el, en, es, fr, hu, id_ID, it, ja, lt, nl, pl, pt, pt_BR, ro, ru, sr, tr, zh_CN, zh_TW
Example:
!config lang ar
Log Channel
The channel where bot actions are logged.
Type: Channel
Default: null
Reset to default: !config logChannel default
Examples:
!config logChannel #channel
Get Updates
Enable to receive development updates about InviteLogger.
Type: Boolean
Default: true
Reset to default: !config getUpdates default
Enable:
!config getUpdates true
Disable:
!config getUpdates false
Command channels
The channels in which the bot will react to commands.
Type: Channel[]
Default: ``
Reset to default: !config channels default
Ignored channels
The channels in which the bot will ignore commands.
Type: Channel[]
Default: ``
Reset to default: !config ignoredChannels default
Join Roles
Roles that are assigned to all members when joining.
Type: Role[]
Default: ``
Reset to default: !config joinRoles default
Message
The message sent when someone joins the server.
Type: String
Default: {memberMention} **joined**; Invited by **{inviterName}** (**{numInvites}** invites)
Reset to default: !config joinMessage default
Message Channel
The channel that the message on join is sent to.
Type: Channel
Default: null
Reset to default: !config joinMessageChannel default
Examples:
!config joinMessageChannel #general
!config joinMessageChannel #joins
Message
The message sent when someone leaves the server.
Type: String
Default: {memberName} **left**; Invited by **{inviterName}**
Reset to default: !config leaveMessage default
Examples:
!config leaveMessage
!config leaveMessage
Message Channel
The channel that the leave message is sent to.
Type: Channel
Default: null
Reset to default: !config leaveMessageChannel default
Examples:
!config leaveMessageChannel #general
!config leaveMessageChannel #leaves
Style
The display style of the leaderboard.
Type: Enum<LeaderboardStyle>
Default: normal
Reset to default: !config leaderboardStyle default
Possible values: normal, table, mentions
Example:
!config leaderboardStyle normal
Hide left members
Hide members that left the server from the leaderboard.
Type: Boolean
Default: true
Reset to default: !config hideLeftMembersFromLeaderboard default
Enable:
!config hideLeftMembersFromLeaderboard true
Disable:
!config hideLeftMembersFromLeaderboard false
Auto Subtract
Automatically subtract fake invites.
Type: Boolean
Default: true
Reset to default: !config autoSubtractFakes default
Enable:
!config autoSubtractFakes true
Disable:
!config autoSubtractFakes false
Auto Subtract
Automatically remove invites from the inviter when the invited user leaves.
Type: Boolean
Default: true
Reset to default: !config autoSubtractLeaves default
Enable:
!config autoSubtractLeaves true
Disable:
!config autoSubtractLeaves false
Auto Subtract Threshold
The time in seconds for which a user has to stay in the server for the invite to count.
Type: Number
Default: 600
Reset to default: !config autoSubtractLeaveThreshold default
Examples:
!config autoSubtractLeaveThreshold 60
!config autoSubtractLeaveThreshold 3600
Assignment Style
How ranks are rewarded to users.
Type: Enum<RankAssignmentStyle>
Default: all
Reset to default: !config rankAssignmentStyle default
Possible values: all, highest, onlyAdd
Example:
!config rankAssignmentStyle all
Announcement Channel
The channel where users receiving a new rank are announced.
Type: Channel
Default: null
Reset to default: !config rankAnnouncementChannel default
Examples:
!config rankAnnouncementChannel
!config rankAnnouncementChannel
Announcement Message
The message that is sent when a user receives a new rank.
Type: String
Default: Congratulations, **{memberMention}** has reached the **{rankName}** rank!
Reset to default: !config rankAnnouncementMessage default
Examples:
!config rankAnnouncementMessage
!config rankAnnouncementMessage
Enabled
Whether or not captcha verification is enabled.
Type: Boolean
Default: false
Reset to default: !config captchaVerificationOnJoin default
Enable:
!config captchaVerificationOnJoin true
Disable:
!config captchaVerificationOnJoin false
Welcome Message
The message a user will get after joining a server and instructing them to enter the captcha.
Type: String
Default: Welcome to the server **{serverName}**! For extra protection, new members are required to enter a captcha.
Reset to default: !config captchaVerificationWelcomeMessage default
Examples:
!config captchaVerificationWelcomeMessage Welcome, please enter the captcha below!
Success Message
The welcome message that will be sent to the user after he successfully verifies.
Type: String
Default: You have successfully entered the captcha. Welcome to the server!
Reset to default: !config captchaVerificationSuccessMessage default
Examples:
!config captchaVerificationSuccessMessage Thanks for entering the captcha, enjoy our server!
Failed Message
The message sent to the user if he enters an invalid captcha.
Type: String
Default: You did not enter the captha right within the specified time.We're sorry, but we have to kick you from the server. Feel free to join again.
Reset to default: !config captchaVerificationFailedMessage default
Examples:
!config captchaVerificationFailedMessage Looks like you are not human :(. You can join again and try again later if this was a mistake!
Verification Timeout
The time within which the captcha has to be entered successfully.
Type: Number
Default: 180
Reset to default: !config captchaVerificationTimeout default
Examples:
!config captchaVerificationTimeout 60
!config captchaVerificationTimeout 600
Log Enabled
Whether or not verification attempts will be logged.
Type: Boolean
Default: true
Reset to default: !config captchaVerificationLogEnabled default
Enable:
!config captchaVerificationLogEnabled true
Disable:
!config captchaVerificationLogEnabled false
Enabled
Automatically moderate messages (specific rules can also be turned on or off, this has to be ON for ANY rule to work).
Type: Boolean
Default: false
Reset to default: !config autoModEnabled default
Enable:
!config autoModEnabled true
Disable:
!config autoModEnabled false
Moderated Channels
The list of moderated channels (this acts as a whitelist, leave empty to moderate all channels, or use autoModIgnoredChannels to ignore certain channels).
Type: Channel[]
Default: ``
Reset to default: !config autoModModeratedChannels default
Examples:
!config autoModModeratedChannels #general
!config autoModModeratedChannels #support,#help
Moderated Roles
The list of roles that are moderated (this acts as a whitelist, leave empty to moderate all roles, or use autoModIgnoredRoles to ignore certain roles).
Type: Role[]
Default: ``
Reset to default: !config autoModModeratedRoles default
Examples:
!config autoModModeratedRoles @NewMembers
!config autoModModeratedRoles @Newbies,@Starters
Ignored Channels
Channels that are ignored while automatically moderating.
Type: Channel[]
Default: ``
Reset to default: !config autoModIgnoredChannels default
Examples:
!config autoModIgnoredChannels #general
!config autoModIgnoredChannels #off-topic,#nsfw
Ignored Roles
Any members with these roles will not automatically be moderated.
Type: Role[]
Default: ``
Reset to default: !config autoModIgnoredRoles default
Examples:
!config autoModIgnoredRoles @TrustedMembers
!config autoModIgnoredRoles @Moderators,@Staff
Muted Role
The role that is given to people who are muted. Make sure this role is denied the "Send Message" permission.
Type: Role
Default: null
Reset to default: !config mutedRole default
Examples:
!config mutedRole @muted
Disabled for Old Members
Disabled auto moderation for members that have been in your server for a long time.
Type: Boolean
Default: false
Reset to default: !config autoModDisabledForOldMembers default
Enable:
!config autoModDisabledForOldMembers true
Disable:
!config autoModDisabledForOldMembers false
Old Members Threshold
The amount of time a member has to be in your server to be considered 'old'.
Type: Number
Default: 604800
Reset to default: !config autoModDisabledForOldMembersThreshold default
Examples:
!config autoModDisabledForOldMembersThreshold 604800 (1 week)``
!config autoModDisabledForOldMembersThreshold 2419200 (1 month)``
Log Enabled
Log any moderation actions that the bot makes.
Type: Boolean
Default: true
Reset to default: !config autoModLogEnabled default
Enable:
!config autoModLogEnabled true
Disable:
!config autoModLogEnabled false
Mod Log Channel
The channel where moderation logs will be posted in.
Type: Channel
Default: null
Reset to default: !config modLogChannel default
Examples:
!config modLogChannel #channel
!config modLogChannel #logs
Delete Bot Messages
Automatically delete the bots own messages (keeps your chat clean).
Type: Boolean
Default: true
Reset to default: !config autoModDeleteBotMessage default
Enable:
!config autoModDeleteBotMessage true
Disable:
!config autoModDeleteBotMessage false
Delete Bot Message Timeout
The timeout after which bot messages are deleted.
Type: Number
Default: 5
Reset to default: !config autoModDeleteBotMessageTimeoutInSeconds default
Examples:
!config autoModDeleteBotMessageTimeoutInSeconds 5
!config autoModDeleteBotMessageTimeoutInSeconds 10
Delete Ban Messages
Whether or not "Ban" pushment messages will be deleted automatically.
Type: Boolean
Default: true
Reset to default: !config modPunishmentBanDeleteMessage default
Enable:
!config modPunishmentBanDeleteMessage true
Disable:
!config modPunishmentBanDeleteMessage false
Delete Kick Messages
Whether or not "Kick" pushment messages will be deleted automatically.
Type: Boolean
Default: true
Reset to default: !config modPunishmentKickDeleteMessage default
Enable:
!config modPunishmentKickDeleteMessage true
Disable:
!config modPunishmentKickDeleteMessage false
Delete Softban Messages
Whether or not "Softban" pushment messages will be deleted automatically.
Type: Boolean
Default: true
Reset to default: !config modPunishmentSoftbanDeleteMessage default
Enable:
!config modPunishmentSoftbanDeleteMessage true
Disable:
!config modPunishmentSoftbanDeleteMessage false
Delete Warn Messages
Whether or not "Warn" pushment messages will be deleted automatically.
Type: Boolean
Default: true
Reset to default: !config modPunishmentWarnDeleteMessage default
Enable:
!config modPunishmentWarnDeleteMessage true
Disable:
!config modPunishmentWarnDeleteMessage false
Delete Mute Messages
Whether or not "Mute" pushment messages will be deleted automatically.
Type: Boolean
Default: true
Reset to default: !config modPunishmentMuteDeleteMessage default
Enable:
!config modPunishmentMuteDeleteMessage true
Disable:
!config modPunishmentMuteDeleteMessage false
Enabled
Automatically scan messages for discord invite links and remove them.
Type: Boolean
Default: true
Reset to default: !config autoModInvitesEnabled default
Enable:
!config autoModInvitesEnabled true
Disable:
!config autoModInvitesEnabled false
Enabled
Automatically remove messages containing links (you can set a whitelist and blacklist).
Type: Boolean
Default: true
Reset to default: !config autoModLinksEnabled default
Enable:
!config autoModLinksEnabled true
Disable:
!config autoModLinksEnabled false
Whitelist
A list of links that users are allowed to post.
Type: String[]
Default: ``
Reset to default: !config autoModLinksWhitelist default
Examples:
!config autoModLinksWhitelist discordbots.org
!config autoModLinksWhitelist youtube.com,twitch.com
Blacklist
Blacklist certain links which users won't be able to post.
Type: String[]
Default: ``
Reset to default: !config autoModLinksBlacklist default
Examples:
!config autoModLinksBlacklist google.com
!config autoModLinksBlacklist twitch.com,youtube.com
Follow Redirects
Enable this to resolve redirects for links.
Type: Boolean
Default: true
Reset to default: !config autoModLinksFollowRedirects default
Enable:
!config autoModLinksFollowRedirects true
Disable:
!config autoModLinksFollowRedirects false
Enabled
Whether or not blacklisted words will be automoderated.
Type: Boolean
Default: true
Reset to default: !config autoModWordsEnabled default
Enable:
!config autoModWordsEnabled true
Disable:
!config autoModWordsEnabled false
Blacklist
A list of words that are banned.
Type: String[]
Default: ``
Reset to default: !config autoModWordsBlacklist default
Examples:
!config autoModWordsBlacklist gay
!config autoModWordsBlacklist stupid,fuck
Enabled
Automatically moderate messages with A LOT OF CAPS.
Type: Boolean
Default: true
Reset to default: !config autoModAllCapsEnabled default
Enable:
!config autoModAllCapsEnabled true
Disable:
!config autoModAllCapsEnabled false
Min. Characters
The minimum amount of characters in a message to be considered for moderating (setting to '3' would ignore 'OK').
Type: Number
Default: 10
Reset to default: !config autoModAllCapsMinCharacters default
Examples:
!config autoModAllCapsMinCharacters 5
!config autoModAllCapsMinCharacters 15
Percentage CAPs
The percentage of characters of the message that have to be CAPs for the rule to trigger.
Type: Number
Default: 70
Reset to default: !config autoModAllCapsPercentageCaps default
Examples:
!config autoModAllCapsPercentageCaps 50
!config autoModAllCapsPercentageCaps 90
Enabled
Automatically moderate duplicate messages (copy-paste spam).
Type: Boolean
Default: true
Reset to default: !config autoModDuplicateTextEnabled default
Enable:
!config autoModDuplicateTextEnabled true
Disable:
!config autoModDuplicateTextEnabled false
Timeframe in Seconds
The timeframe whithin which messages will be considered duplicates.
Type: Number
Default: 60
Reset to default: !config autoModDuplicateTextTimeframeInSeconds default
Examples:
!config autoModDuplicateTextTimeframeInSeconds 5
!config autoModDuplicateTextTimeframeInSeconds 20
Enabled
Automatically moderate users sending a lot of messages in a short time.
Type: Boolean
Default: true
Reset to default: !config autoModQuickMessagesEnabled default
Enable:
!config autoModQuickMessagesEnabled true
Disable:
!config autoModQuickMessagesEnabled false
# of Messages
The number of messages that have to be sent within the timeframe to trigger the rule.
Type: Number
Default: 5
Reset to default: !config autoModQuickMessagesNumberOfMessages default
Examples:
!config autoModQuickMessagesNumberOfMessages 5
!config autoModQuickMessagesNumberOfMessages 10
Timeframe in Seconds
The timeframe within which a user is allowed to send a maximum amount of messages.
Type: Number
Default: 3
Reset to default: !config autoModQuickMessagesTimeframeInSeconds default
Examples:
!config autoModQuickMessagesTimeframeInSeconds 2
!config autoModQuickMessagesTimeframeInSeconds 10
Enabled
Automatically moderate messages that mention an excessive amount of users.
Type: Boolean
Default: true
Reset to default: !config autoModMentionUsersEnabled default
Enable:
!config autoModMentionUsersEnabled true
Disable:
!config autoModMentionUsersEnabled false
Max # of Mentions
The maximum amount of users a member can mention in a message.
Type: Number
Default: 5
Reset to default: !config autoModMentionUsersMaxNumberOfMentions default
Examples:
!config autoModMentionUsersMaxNumberOfMentions 2
!config autoModMentionUsersMaxNumberOfMentions 5
Enabled
Automatically moderate messages that mention an excessive amount of roles.
Type: Boolean
Default: true
Reset to default: !config autoModMentionRolesEnabled default
Enable:
!config autoModMentionRolesEnabled true
Disable:
!config autoModMentionRolesEnabled false
Max # of Mentions
The maximum amount of roles a member can mention in a message.
Type: Number
Default: 3
Reset to default: !config autoModMentionRolesMaxNumberOfMentions default
Examples:
!config autoModMentionRolesMaxNumberOfMentions 2
!config autoModMentionRolesMaxNumberOfMentions 5
Enabled
Automatically moderate messages with an excessive amount of emojis.
Type: Boolean
Default: true
Reset to default: !config autoModEmojisEnabled default
Enable:
!config autoModEmojisEnabled true
Disable:
!config autoModEmojisEnabled false
Max # of Emojis
The maximum amount of emojis a message is allowed to have before trigger the rule.
Type: Number
Default: 5
Reset to default: !config autoModEmojisMaxNumberOfEmojis default
Examples:
!config autoModEmojisMaxNumberOfEmojis 5
!config autoModEmojisMaxNumberOfEmojis 10
Enabled
Automatically give members nicknames if they try to hoist (use special characters to appear at the top of the user list).
Type: Boolean
Default: true
Reset to default: !config autoModHoistEnabled default
Enable:
!config autoModHoistEnabled true
Disable:
!config autoModHoistEnabled false
Last updated