Salvor Security Bot Documentation

Everything you need to secure your Discord server from raids, spam, and coordinated bot networks.

Welcome to the Salvor Security Bot documentation. Our bot utilizes a proprietary Double Captcha system that combines spatial awareness and visual logic puzzles to ensure that only real humans can enter your community. This guide will walk you through completing the verification as a user, as well as installing and configuring the bot as an administrator.

How to Verify (For Server Members)

If you have recently joined a server protected by the Salvor Security Bot, you will need to complete a brief verification process to gain full access. This ensures the community remains free of spam bots and automated raids.

When you click the green Verify button in the server, the bot will send you a temporary, private message within that same channel. Depending on the server's settings, you will face one or more of the following challenges:

Stage 1: The Logic Grid

You will be presented with an image containing a 3x3 grid of numbered squares.

1. Look closely at the 9 images in the grid.
2. Find the odd one out (e.g., 8 pictures of cats, and 1 picture of a dog).
3. Click the numbered button below the image that corresponds to the odd image.
4. If all images belong to the same category, click the red None button.

Stage 2: The Compass

You will be presented with a single image of an object (like a car or a character).

1. Determine which direction the object is facing from your perspective.
2. Click the corresponding directional arrow button below the image (e.g., ⬆️ for away from viewer (you), ↘️ for towards the viewer (you) and also somewhat right).

Timed Out or Failed? If you take too long to answer or select the wrong button, the verification will fail. If you fail too many times, you will be temporarily locked out of verifying to protect the server from brute-force attempts. Simply try again later!

Privacy & Safety

Your digital safety is our absolute priority. When interacting with the Salvor Security Bot, please keep the following safety facts in mind:

• No DMs (Direct Messages): Salvor will never send you a Direct Message. All verifications happen directly inside the server using Discord's "Ephemeral Messages" (messages that only you can see). If a bot DMs you asking you to verify, it is a scam.
• No External Links: Salvor does not require you to click external links, log in to third-party websites, or authorize your Discord account elsewhere to pass the captcha.
• No QR Codes: You will never be asked to scan a QR code. Scanning unknown QR codes with your Discord app can compromise your account.
• No Passwords: Salvor will never ask for your password, email, or token.

Inviting the Bot (For Admins)

Before you can use Salvor, you must invite it to your Discord server and grant it the necessary permissions.

1. Click the Invite Bot button on our main homepage.
2. Select your server from the dropdown list.
3. Leave all requested permissions checked. Salvor requires permissions like Manage Roles, View Channels, and Send Messages to properly verify users and assign them their roles.

Important Role Hierarchy Note: Discord requires a bot's role to be higher in the server settings list than the role it is trying to assign. After inviting Salvor, go to your Server Settings > Roles and drag the "Salvor Security" role above your "Verified" or "Member" role.

Initial Setup

Once Salvor is in your server, you need to tell it where to post the verification button and what role to give users who pass.

In any channel where you have admin permissions, type the following slash command:

/setup verified_role:@Member log_channel:#security-logs portal_channel:#verify-here

Option	Required?	Description
verified_role	Yes	The role Salvor will give to the user after they successfully complete the captcha.
log_channel	Yes	A private staff channel where Salvor will post success/fail audit logs.
portal_channel	No	The channel where the actual "Verify" button will be posted. If left blank, the bot will post it in the channel you are currently typing in.

After running this command, the bot will post a sleek embed with a green Verify button in the chosen portal channel. Your setup is complete!

Using the Dashboard

You can manage all of your servers from the Salvor Web Dashboard.

1. Navigate to the Dashboard and click Login with Discord.
2. Authorize the application. You will only see servers where you have Administrator or Owner permissions.
3. Click on a server on the left sidebar to open its configuration panel. Note: Servers that have not run the /setup command yet will be greyed out.

Settings Explained

Within the Dashboard, you have access to several configuration options to customize the user experience.

Welcome Message

This is the text the bot will display to the user in a private ephemeral message once they successfully pass the captcha. You can use standard Discord markdown (like **bold** or [links](url)).

Timeout (Seconds)

This defines how long a user has to complete a single captcha step before they are automatically failed.

• Default: 100 seconds.
• Set to 0: Disables the timer completely (not recommended for strict security).

Timer Display

This controls how the countdown is visually presented to the user while they are solving the puzzle.

• Relative: Shows a live, ticking Discord timestamp (e.g., "Expires in 1 minute").
• Static Text: Shows a simple sentence (e.g., "You have 100 seconds to complete this.").
• Hidden: Hides the timer entirely from the UI, though the bot will still fail them quietly if they take too long.

Commands Reference

These commands can be executed directly inside Discord.

/setup
# Deploys the verification portal and binds your roles. Requires Administrator permissions.

/set_welcome_message [message]
# A quick way to change your welcome message without logging into the web dashboard.

Premium Membership

Salvor offers a Premium tier for massive communities requiring advanced threat mitigation.

Free 2 week trial includes the same as the premium tier.
Premium Tier ($8.95/mo) Unlocks: Custom welcome message, custom timeout adjustments, AI behavioral anti-raid sweeps, custom dashboard settings, and advanced logging.

If your Premium subscription for the discord server expires, your server will automatically be downgraded to simple single captcha, and there will be ads added to the flow. Any custom server specific settings that you applied via Dashboard will revert to their defaults.

Troubleshooting / FAQ

Users are passing the captcha, but not getting the role!

This is always a Role Hierarchy issue. Go to your Server Settings > Roles. Drag the "Salvor Security" role so it is physically higher up the list than the Verified role it is trying to assign. Also ensure the bot has the "Manage Roles" permission.

The bot says "Server Admin has not completed /setup yet."

This happens if users click the Verify button before you have run the /setup command, or if the bot's database was recently reset. Simply run /setup again to bind the server data.

I clicked Verify and it said "Security limit reached."

To prevent brute-forcing, Salvor locks users out if they fail the captcha too many times (default is 15 fails in a day). The lock is temporary. Server administrators are immune to these lockouts.

Why doesn't the bot DM users?

DMs are an outdated verification method. Many users have DMs disabled for privacy, and scammers frequently use fake verification bots to DM phishing links. Salvor operates entirely via "Ephemeral Messages" inside the server channel, ensuring 100% safety and compliance.