What are punishments?

Punishments are actions like ban, kick or mute that can be given to a user when he violates the rules. You can either call punish users directly by using commands, or you can define punishments that happen after a user reaches a certain amount of strikes.

How can I punish a user after reaching a certain amount of strikes?

With the punishmentconfig command you can set after how many strikes a certain punishment action will be given.

!punishmentconfig <punishmentType> <numberOfStrikesNeeded>

A list of all available punishments:

• ban

• softban

• kick

• mute

• warn

So if you would like to kick a user after he reaches 5 strikes, you would have to execute the following command

!punishmentconfig kick 5

If you want to delete a punishmentconfig, just set the strikes to 0 like that:

!punishmentconfig kick 0

To see all punishment configs, just use the command without giving any arguments:

!punishmentconfig

What are strikes?

Strikes are points that users get for violating server rules. Every time the user receives a strike, he gets a personal message telling him how many strikes he has and why he got them. When a user reaches a certain amount of strikes, he will receive a punishment.

What are violations?

Violations are auto-moderation rules that you can enable or disable on your server. Currently, the following violations exist:

• invites

• links

• words

• allCaps

• duplicateText

• quickMessages

• mentionUsers

• mentionRoles

• emojis

For each of those violations, you have to define how many strikes will be given if someone violates it. You can do that by using the strikeconfig command:

!strikeconfig <violationType> <numberOfStrikes>

For example, if you want users to get 2 strikes for violating the invites rule, then you would use the following command:

!strikeconfig invites 2

You can check the current config by doing:

!strikeconfig

Detailed list of violations

invites

This violation is triggered whenever the user posts an invite link to another discord server.

Example:

!strikeconfig invites 1

To delete the strike config:

!strikeconfig invites 0

Config options:

• autoModInvitesEnabled

links

This violation is triggered whenever the user posts a link.

Example:

!strikeconfig links 1

To delete the strike config:

!strikeconfig links 0

Config options:

• autoModLinksEnabled

• autoModLinksWhitelist

• autoModLinksBlacklist

• autoModLinksFollowRedirects

words

This violation is triggered whenever the user posts blacklisted words.

Example:

!strikeconfig words 1

To delete the strike config:

!strikeconfig words 0

Config options:

• autoModWordsEnabled

• autoModWordsBlacklist

allCaps

This violation is triggered whenever the user posts a message that is mostly in CAPS.

Example:

!strikeconfig allCaps 1

To delete the strike config:

!strikeconfig allCaps 0

Config options:

• autoModAllCapsEnabled

• autoModAllCapsMinCharacters

• autoModAllCapsPercentageCaps

duplicateText

This violation is triggered whenever the user posts the same text multiple times.

Example:

!strikeconfig duplicateText 1

To delete the strike config:

!strikeconfig duplicateText 0

Config options:

• autoModDuplicateTextEnabled

• autoModDuplicateTextTimeframeInSeconds

quickMessages

This violation is triggered whenever the user quickly posts messages.

Example:

!strikeconfig quickMessages 1

To delete the strike config:

!strikeconfig quickMessages 0

Config options:

• autoModQuickMessagesEnabled

• autoModQuickMessagesNumberOfMessages

• autoModQuickMessagesTimeframeInSeconds

mentionUsers

This violation is triggered whenever the user mentions mutliple users.

Example:

!strikeconfig mentionUsers 1

To delete the strike config:

!strikeconfig mentionUsers 0

Config options:

• autoModMentionUsersEnabled

• autoModMentionUsersMaxNumberOfMentions

mentionRoles

This violation is triggered whenever the user mentions mutliple roles.

Example:

!strikeconfig mentionRoles 1

To delete the strike config:

!strikeconfig mentionRoles 0

Config options:

• autoModMentionRolesEnabled

• autoModMentionRolesMaxNumberOfMentions

emojis

This violation is triggered whenever the user posts multiple emojis.

Example:

!strikeconfig emojis 1

To delete the strike config:

!strikeconfig emojis 0

Config options:

• autoModEmojisEnabled

• autoModEmojisMaxNumberOfEmojis