Server Captcha Bot

Welcome to Server Captcha Bot!

Spambots and targeted raids using automated user accounts are real issues for some servers.
Just in the past few months, I've seen servers with more than 10,000 users get raided using these methods.
This bot helps irradicate the fear of your server getting autonomously attacked.

Currently protecting over 60,000 servers with over 9.5 million users!

Stay up to date on the latest news regarding Server Captcha Bot! Follow us on Twitter.

---

Since 16th of April 2020
Created over 15 million captchas.
Seen over 2.1 billion messages.
Had over 3.7 million commands ran.
Processed over 84 million events

---

Need help setting up the bot?

Scroll down to the setup instructions, if still having issues with the bot setup,
Join our support server discord.gg/plexidev & ask in the #captcha-bot channel!

---

You can invite the bot for yourself here: Invite Link

There's also a video showcasing usage and setup, you can check it out here: youtube.com/watch?v=mKGRLyIFF4I

---

Commands

Since this bot is highly autonomous, there aren't that many commands required. Although, here is the full list:

Category	command	Description
User	!verify	Sends a Captcha to the message sender, gives the configured role when completed
General	!help	Displays a general help message
General	!stats	Displays the statistics for the bot
Admin	!checklist	Displays a checklist of the required actions to set up the bot
Admin	!config	Display the current configuration for the bot

---

How does it work?

When a user joins the server, they aren't able to see any of the main channels. They are also DMed by the main bot, as shown in the corner.
When a user completes the captcha they unlock all avaiable channels.

The user completes the Captcha, and is added to the server. (Captcha Completion)

That's it! - It's as simple as that, no interaction needed by administrators of the server.

---

Setup

Follow either Basic Setup Instructions or Detailed Setup Instructions to begin using Server Captcha Bot

---

Basic Setup Instructions

1: Invite Server Captcha Bot
2: Run !checklist to check what needs to be completed.
3: Run !config to edit and fill in each config field.
4: Edit Each Channels Permissions to denying @everyone to viewing while allowing userRole to viewing.
5: Setup Complete.

Running into issues? Join our Discord and ask for assistance in #captcha-bot channel. Discord Invite

---

Detailed Setup Instructions

Step One - Invite Server Captcha Bot.

• Click on Invite Server Captcha Bot and it will open up a Discord OAuth URL.
• Invite the bot with Manage Roles and Manage Channels permissions.
  
  Discord OAuth Should look like this:
  

---

Step Two - Run !checklist.

On first run of the command it will output something like this:

This simply just notes to you that the server has not been setup.
You will need to set things within the !config such as the verificationChannel and userRole

---

Step Three - Editing the Config.

By editing the config of Server Captcha Bot it sets up the bot to run automatically for your server.
Below is all the commands, you can also view this menu by typing !config in any channel the bot can view.

!config	Display the current configuration for the bot
!config verificationChannel [ #channel | none ]	Channel which users can run !verify or be mentioned within alerting to turn on DM's
!config userRole [ roleName | none ]	Role which is given once a user is verified on the server
!config logsChannel [ #channel | none ]	Channel which the captcha logs are sent to
!config bypassCaptcha [ Yes | No ]	Allow any user who has verified with the bot to bypass the captcha
!config prefix [ Prefix ]	Change the prefix the bot responds to

---

To edit any of the config options run a command in your Discord server like noted above in the menu.

For Example, if you wanted to edit the verificationChannel option you would do something like this:

!config verificationChannel #verification

Ensuring that #verification is the channel you want set as the entry channel for new unverified users.

Fill out all !config options to ensure the server is configured right.
To ensure the bot is setup correctly you can run !checklist again.

---

Step Four - Editing Permissions

Automatic Feature is Currently Disabled
We Apologise for this feature being disabled and plan to bring it back within rewrite.

Manual Method:

---

Option 1
Within each Category and Channel permissions, you will want to deny @everyone from viewing permissions.
You will also want to grant your userRole with viewing permissions.

ONLY DISABLE VIEWING PERMISSIONS TO @everyone THEN ENABLE VIEWING PERMISSIONS FOR userRole.
Server Captcha Bot only requires viewing, sending and embedding message permissions for verificationChannel and logsChannel if both are enabled.

This needs to happen within all channels and categories you wish the unverified user to not view.

---

Option 2
Go to Server Settings -> Roles
-> @everyone -> set Read Text Channels & See Voice Channels to Disabled
-> userRole -> set Read Text Channels & See Voice Channels to Enabled

Optional: Go to the channels you want users awaiting to complete captcha to still see and/or do the following:

Go to Channel Permissions
-> @everyone -> set Send Messages and Read Messages to Enabled
-> userRole -> set Send Messages and Read Messages to Disabled

---

You're done setup complete!

---

Captcha Logging

This bot has a feature that allows administrators/staff to view everyone completing the Captcha's in real-time.
It can be set by using the !config command.

To use this feature, ensure logsChannel within the !config is set to the channel you want to view captchas within.
This channel should be for your server staff only.

---

Frequently Asked Questions

• How can i get support with setting up the bot?
  
  You can join our Discord Server and ask questions within #captcha-bot support channel.
  

---

• How do i set the userRole in config?
  
  Within the Config there is a variable asking for userRole.
  When you are selecting the role, head to Server Settings > Roles > Role you want to set as the "Verified Role" and COPY to your clipboard (ctrl + c) the role name.
  Once you have copied the role name, enter it into the config like so:

!config userRole ROLENAME
To PASTE from your clipboard: (ctrl + v)

MUST BE THE ROLE NAME AND NOT THE ROLE MENTION

---

• What if a user has their DMs turned off?
  
  Since the setup requires you to have a verificationChannel (essentially a waiting room), they are pinged there with an example of how to temporarily turn on their DMs. (image below)

---

• What if a user fails the Captcha?
  
  Users get three attempts at the Captcha until they are told to type !verify into the verification channel, which gives them a new Captcha. (image below)
  

---

• Are the Captcha's pre-created?
  
  No, all Captcha's are unique and generated when the user requests a Captcha. The bot generates hundreds per day, having preset Captcha's would ruin the security.

---

• Are any new features planned?
  
  Yes, there are a few features that are planned, mostly relating to backend security. Although, it's better if they weren't known so the people trying to bypass this system will have a harder time doing so.

---