Gatekeeper
Gatekeeper is a versatile feature of Dogbot that allows you to block users from entering your server under times of stress.
In a private channel (preferably where your other moderators can chat), type
d?gk enable. This will enable Gatekeeper. New member joins will be broadcasted
to the channel you enabled Gatekeeper in.
Disable Gatekeeper with d?gk disable. Make sure you have reactions enabled, as
Dogbot will ask for confirmation with them.
Right now, Gatekeeper won't do anything except for broadcast joins. You'll have to configure it to add checks. Checks allow you to limit who can join your server based on arbitrary criteria.
You can also view the full list of settings in Discord. Just type:
d?gk settings.
Set a setting with d?gk set <check name>. This will "enable" the check.
However, some checks require an associated value. For these, type
d?gk set <check name> <check value>. The check value will be different for
every check.
-
minimum_creation_time: Specifies the minimum amount of seconds that an account has to exist on Discord in order for them to join your server. Useful to keep new accounts out.- Associated value: The minimum time, in seconds.
-
block_all: Blocks all users that attempt to join your server. If you enable this "check", you should also set the bounce message to ensure that people who try to join aren't confused because they got instantly kicked out for no reason. -
block_default_avatar: Blocks users with a default avatar set. Also useful for blocking new users who have been around, but don't have an avatar. -
username_regex: Blocks usernames that match a regex. The associated value should be the regex.- Associated value: The regex to search for in the username.
You can remove a setting/check with d?gk unset <setting name> (this includes
the bounce message).
You can configure a message to be sent to users just before being bounced, if they are getting bounced.
Use d?gk set bounce_message Your message here! to set the bounce message.
You format the bounce message, too. Surround any keyword below in curly braces to include its represented value inline in the message:
-
member.username: The user's username. -
member.mention: The user's mention. -
member.tag: The user's username,#, then discriminator. -
member.id: The user's ID. -
reason: The reason why they got bounced.
Here's an example:
d?gk set bounce_message Sorry, {member.mention}! I kicked you out because: `{reason}`
Here's what it will look like to users who get kicked out:
Keep in mind that bounced users might have DMs disabled by default, meaning that they won't get a message at all.
Not sure if Gatekeeper is enabled, or what your settings are? Type
d?gk status for some insight on what's going on.