Getting Started
Welcome to SellerBeware! This documentation will guide you through everything you need to know about using the bot to protect your Discord community from scammers and bad actors.
What is SellerBeware?
SellerBeware is a powerful Discord bot designed to flag and track suspicious users across multiple servers. It provides a robust database system for storing flagged user information and automatically alerts servers when flagged users join.
Key Features
- User Flagging: Flag suspicious users with detailed reasons and manual review system
- Cross-Server Protection: Track flagged users across all servers using the bot
- Smart Database: Intelligent database system with zero external dependencies
- Real-time Alerts: Instant notifications when flagged users join servers
- Privacy Focused: Minimal data collection, only stores necessary information
Quick Start
- 1Add SellerBeware to your Discord server
- 2Run the setup command to configure the bot
- 3Set up permissions for your moderators
- 4Start flagging suspicious users
Setup Guide
Adding the Bot to Your Server
- Click the "Add to Discord" button on our website or use the invite link
- Select your server from the dropdown menu
- Review and authorize the required permissions
- Complete the verification process
Important: Make sure you have "Manage Server" permissions to add the bot to your server.
Initial Configuration
After adding the bot, you'll need to run the setup command to configure it for your server:
+setup
Administrator
+setup
Interactive setup wizard to configure the bot for your server
Example: +setup
Setup Process
- Run
+setup in any channel where the bot can see messages
- The bot will ask you to provide a channel ID for alerts
- Copy the channel ID where you want flagged user alerts to be sent
- Paste the channel ID when prompted
- The bot will confirm the setup is complete
Setup Complete! Your server is now configured to receive alerts when flagged users join.
Commands
Core Commands
+add
Ban Members
+add @user [reason]
Flag a user as suspicious with an optional reason
Example: +add @scammer123 Attempted to sell fake items
+search
None
+search @user
Search for a user in the flagged database
Example: +search @user123
Configuration Commands
+setchannel
Administrator
+setchannel #channel
Set the channel for flagged user alerts
Example: +setchannel #alerts
+settings
Ban Members
+settings
View current server settings
Example: +settings
Utility Commands
+help
None
+help [command]
Show help information for commands
Example: +help add
Permissions
SellerBeware requires specific Discord permissions to function properly. Here's a breakdown of what each permission is used for:
Send Messages
Required for the bot to send command responses and alerts
Read Message History
Needed to read commands and process user mentions
Use Slash Commands
Required for slash command functionality
View Channels
Needed to access channels for sending alerts
Manage Messages
Required for moderators to use flagging commands
Administrator
Required for server setup and configuration commands
Role-Based Permissions
The bot uses Discord's built-in permission system. Users need the following permissions to use specific commands:
| Command |
Required Permission |
Description |
| +add |
Ban Members |
Flag users as suspicious |
| +search |
None |
Search the database |
| +setup |
Administrator |
Configure the bot |
| +setchannel |
Administrator |
Change alert channel |
| +settings |
Ban Members |
View server settings |
Configuration
Server Settings
Each server can configure the following settings:
- Alert Channel: The channel where flagged user alerts are sent
- Permissions: Which roles can use bot commands
Changing Alert Channel
To change the channel where alerts are sent:
+setchannel
Administrator
+setchannel #channel
Update the alert channel for flagged user notifications
Example: +setchannel #moderation-alerts
Viewing Current Settings
Check your current server configuration:
+settings
Ban Members
+settings
Display current server settings and configuration
Example: +settings
How It Works
Cross-Server Protection
SellerBeware works by maintaining a shared database of flagged users across all servers that use the bot. Here's how it protects your community:
- User Flagging: When a moderator flags a suspicious user in any server, their information is added to the global database
- Real-time Monitoring: The bot continuously monitors all servers for new user joins
- Instant Alerts: When a flagged user joins your server, an alert is immediately sent to your configured alert channel
- Detailed Information: The alert includes the user's information and the reason they were flagged
Privacy Notice: The bot only stores necessary information for moderation purposes. No personal messages, server content, or sensitive data is collected. All data is stored securely in a private database.
What Information is Stored
For each flagged user, the bot stores:
- User ID: Discord user ID (unique identifier)
- Username: Discord username at time of flagging
- Reason: Reason for flagging the user
- Server Information: Server where the user was flagged
- Flagged By: User who flagged the suspicious user
- Timestamp: When the user was flagged
Alert System
When a flagged user joins your server, you'll receive an alert that includes:
- The user's current username and ID
- The reason they were originally flagged
- Which server they were flagged in
- Who flagged them and when
- Quick action buttons to manage the user
Troubleshooting
Common Issues
Bot Not Responding to Commands
- Check if the bot has the required permissions
- Verify the bot is online and connected
- Ensure you're using the correct command prefix (+)
- Check if the bot can see the channel where you're typing
Alerts Not Being Sent
- Verify the alert channel is properly configured
- Check if the bot has permission to send messages in the alert channel
- Ensure the alert channel still exists
- Run
+settings to check current configuration
Permission Errors
- Make sure you have the required Discord permissions
- Check your role hierarchy (bot role must be above user roles)
- Verify the bot has the necessary permissions
- Contact a server administrator if issues persist
Getting Help
If you're experiencing issues not covered in this documentation:
- Check our FAQ section for common questions
- Join our Support Server
- Create a support ticket with detailed information about your issue
- Include error messages, screenshots, and steps to reproduce the problem
Before Contacting Support: Please check this documentation and the FAQ section first. Most issues can be resolved by following the setup guide and checking permissions.
Best Practices
Moderation Guidelines
- Verify Before Flagging: Always verify suspicious activity before flagging users
- Detailed Reasons: Provide clear, specific reasons when flagging users
- Regular Reviews: Periodically review flagged users and remove false positives
Server Setup
- Dedicated Alert Channel: Use a dedicated channel for alerts to avoid spam
- Role Permissions: Set up proper role permissions for moderators
- Regular Monitoring: Monitor the alert channel regularly for new flagged users
- Backup Configuration: Keep a record of your bot configuration
Security Considerations
- Permission Management: Only give necessary permissions to bot roles
- Access Control: Limit who can use flagging commands
Frequently Asked Questions
General Questions
What data does the bot store?
SellerBeware stores only flagged user information (user IDs, usernames, reasons, timestamps) and server settings (alert channel IDs). No personal messages, server content, or sensitive data is collected. All data is stored securely in a private database.
How do I set up the bot?
Simply run +setup in your server and follow the interactive prompts. You'll need to provide a channel ID for alerts where flagged user notifications will be sent.
Can false flags be removed?
If you've been flagged and believe it's incorrect, you can join our support server and create a ticket to request removal. We'll review your case and remove the flag if it was indeed a false positive.
Does the bot work across multiple servers?
Yes! SellerBeware tracks flagged users across all servers it's in. When a flagged user joins any server with the bot, an alert is sent to that server's configured alerts channel.
Technical Questions
What permissions does the bot need?
The bot requires Send Messages, Read Message History, Use Slash Commands, View Channels, Manage Messages, and Manage Server permissions to function properly. See the Permissions section for detailed information.
How do I change the alert channel?
Use the +setchannel (channel_id) command to change where alerts are sent. You need Administrator permissions to use this command.
What happens if the bot goes offline?
If the bot goes offline, it won't be able to send alerts for new flagged users joining servers. However, all flagged user data is preserved and the bot will resume normal operation when it comes back online.
Support Questions
How do I get help?
Join our Support Server and create a ticket with detailed information about your issue. Include error messages, screenshots, and steps to reproduce the problem.
Can I request new features?
Yes! We welcome feature requests. Join our support server and submit your ideas. We regularly review and implement user suggestions.
Is the bot free to use?
Yes, SellerBeware is completely free to use. There are no premium features or paid tiers.