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
The channel where bot actions are logged.
Enable to receive development updates about InviteLogger.
The channels in which the bot will react to commands.
The channels in which the bot will ignore commands.

Invites

General

Setting
Description
Roles that are assigned to all members when joining.

Joins

Setting
Description
Message
The message sent when someone joins the server.
The channel that the message on join is sent to.

Leaves

Setting
Description
Message
The message sent when someone leaves the server.
The channel that the leave message is sent to.
Automatically remove invites from the inviter when the invited user leaves.
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 members that left the server from the leaderboard.

Fakes

Setting
Description
Automatically subtract fake invites.

Ranks

Setting
Description
How ranks are rewarded to users.
The channel where users receiving a new rank are announced.
The message that is sent when a user receives a new rank.

Moderation

Captcha

Setting
Description
Enabled
Whether or not captcha verification is enabled.
The message a user will get after joining a server and instructing them to enter the captcha.
The welcome message that will be sent to the user after he successfully verifies.
The message sent to the user if he enters an invalid captcha.
The time within which the captcha has to be entered successfully.
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).
The list of moderated channels (this acts as a whitelist, leave empty to moderate all channels, or use autoModIgnoredChannels to ignore certain channels).
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).
Channels that are ignored while automatically moderating.
Any members with these roles will not automatically be moderated.
The role that is given to people who are muted. Make sure this role is denied the "Send Message" permission.
Disabled auto moderation for members that have been in your server for a long time.
The amount of time a member has to be in your server to be considered 'old'.

Logging

Setting
Description
Log any moderation actions that the bot makes.
The channel where moderation logs will be posted in.
Automatically delete the bots own messages (keeps your chat clean).
The timeout after which bot messages are deleted.
Whether or not "Ban" pushment messages will be deleted automatically.
Whether or not "Kick" pushment messages will be deleted automatically.
Whether or not "Softban" pushment messages will be deleted automatically.
Whether or not "Warn" pushment messages will be deleted automatically.
Whether or not "Mute" pushment messages will be deleted automatically.

Invites

Setting
Description
Enabled
Automatically scan messages for discord invite links and remove them.
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.
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.
The minimum amount of characters in a message to be considered for moderating (setting to '3' would ignore 'OK').
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).
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.
The number of messages that have to be sent within the timeframe to trigger the rule.
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.
The maximum amount of users a member can mention in a message.
Enabled
Automatically moderate messages that mention an excessive amount of roles.
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.
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 modified 1yr ago