Documentation

Everything you need to know about setting up and using DisGuard to protect your Discord server.

Getting Started

DisGuard is a powerful Discord verification bot designed to protect your server from raids, bots, and malicious users. With multiple verification methods and advanced moderation tools, DisGuard provides comprehensive security for communities of all sizes.

Quick Setup

  1. Click the "Add to Discord" button to invite DisGuard to your server
  2. Authorize the bot with the required permissions
  3. Visit the dashboard and select your server
  4. Configure your verification and moderation settings
  5. Your server is now protected!

Note: You must be the dedicated server owner in order to configure it's settings in your dashboard.

Verification Configuration

DisGuard offers four flexible verification methods to suit your server's needs. Each method provides a different balance between security and user experience.

Button Verification

Users click the correct button from a set of options to verify. You can configure the number of buttons (1-5) to adjust difficulty. This method is quick and user-friendly while still providing effective bot protection.

Best for: General servers, gaming communities, casual groups

Code Verification

Users must type a randomly generated code to verify. Configure the code length (4-8 characters) and complexity (numbers only, alphanumeric, or alphanumeric with symbols) to match your security requirements.

Best for: High-security servers, professional communities, sensitive content

Phrase Verification

Users type a custom phrase or sentence to verify. Configure the number of words (1-10) to adjust difficulty. This method is highly effective against automated bots while remaining accessible to legitimate users.

Best for: Medium-security servers, educational communities, niche groups

Link Verification

Users receive a unique verification link when they join your server. They click the link and authenticate with their Discord account through OAuth. This method provides the highest level of security by ensuring users are legitimate Discord accounts.

Best for: Maximum security servers, exclusive communities, servers requiring verified Discord accounts

Additional Settings

Log Channel

Specify a channel ID where verification events will be logged for monitoring and auditing purposes.

Roles to Grant

Add role IDs that will be automatically assigned to users upon successful verification.

Moderation Configuration

Configure moderation settings to empower your staff team and maintain comprehensive logs of moderation actions.

Moderator Roles

Add role IDs for your moderation team. Users with these roles will have access to moderation commands and features. You can add multiple roles to create a tiered moderation structure.

Logging Channel

Specify a channel ID where moderation actions will be logged. This creates an audit trail of all moderation activities including warnings, kicks, bans, and other actions.

Word Filter

Enable automatic filtering of unwanted words from user messages. Add specific words or phrases to your banned words list, and DisGuard will automatically detect and remove messages containing these terms. This helps maintain a clean and respectful environment in your server.

How it works: When enabled, messages containing banned words are automatically deleted, and the action is logged to your moderation channel.

Link Filter

Enable automatic filtering of unwanted links (URLs) from user messages. Add specific domains or URLs to your banned links list, and DisGuard will automatically detect and remove messages containing these links. This protects your community from phishing, scams, and inappropriate content.

How it works: When enabled, messages containing banned links are automatically deleted, and the action is logged to your moderation channel.

User Reporting Configuration

Enable community-driven moderation with DisGuard's user reporting system. Allow your server members to report problematic behavior, and configure automatic actions when reports reach a threshold.

Report Channel

Specify a channel ID where user reports will be logged. This channel should be visible only to moderators to maintain privacy and prevent abuse of the reporting system.

Report Threshold

Set the number of reports required before automatic action is taken. When a user receives this many reports, the configured action will be executed automatically. Choose a threshold that balances protection with preventing false reports.

Automatic Actions

Choose what action DisGuard should take when a user reaches the report threshold:

  • Kick: Remove the user from the server (they can rejoin)
  • Ban: Permanently ban the user from the server
  • Timeout: Temporarily prevent the user from sending messages and participating

Timeout Duration

If you choose "Timeout" as your action, configure how long the timeout should last. Options range from 5 minutes to 1 week, allowing you to match the duration to the severity of typical infractions.

Best Practices

  • Set the threshold high enough to prevent abuse (3-5 reports recommended)
  • Review the report channel regularly to identify patterns
  • Use timeouts for first-time offenders, escalating to kicks or bans for repeat issues
  • Make your reporting command known to users through welcome messages or rules

Spam Filters Configuration

Protect your server from spam with intelligent, configurable filters that detect and prevent message, media, and mention spam. Each filter can be independently enabled and configured to match your server's needs.

Message Spam

Set a limit for messages sent within a certain time period. When a user exceeds this limit, the configured action is automatically applied.

Example: Configure to allow 5 messages per 10 seconds. If a user sends 6 messages in 10 seconds, they are automatically timed out or kicked.

  • Limit: Number of messages allowed
  • Period: Time window in seconds
  • Action: Timeout or Kick

Media Spam

Set a limit for attachments sent without text within a certain time period. This prevents users from flooding channels with images, videos, or files.

Example: Configure to allow 3 media attachments per 30 seconds. If a user sends 4 images in 30 seconds, they are automatically actioned.

  • Limit: Number of media attachments allowed
  • Period: Time window in seconds
  • Action: Timeout or Kick

Mention Spam

Set a limit for mentions sent within a certain time period. Prevents users from mass pinging members or roles, which is a common harassment tactic.

Example: Configure to allow 4 mentions per 15 seconds. If a user mentions 5 people in 15 seconds, they are automatically actioned.

  • Limit: Number of mentions allowed
  • Period: Time window in seconds
  • Action: Timeout or Kick

Best Practices

  • Set limits based on your server's activity level and culture
  • Use timeouts for first offenses, escalating to kicks for repeat offenders
  • Monitor your log channel to fine-tune settings and reduce false positives
  • Consider different limits for different channels (e.g., stricter in general chat)

Anti-Nuke Protection

Protect your server from nuke attacks with DisGuard's intelligent detection system. A "nuke" is when a malicious user with elevated permissions attempts to destroy your server by mass-deleting channels, banning members, or removing roles.

What DisGuard Detects

DisGuard monitors for suspicious mass actions that indicate a nuke attempt:

  • Rapid deletion of multiple channels (3+ channels in 10 seconds)
  • Mass banning of members (5+ bans in 10 seconds)
  • Bulk role deletions (3+ roles in 10 seconds)
  • Multiple channel creations with suspicious names

Automatic Actions

When a nuke attempt is detected, DisGuard takes immediate action to stop the threat:

  • Kick User: Immediately removes the user from the server to stop the attack
  • Ban User: Permanently bans the user and prevents them from rejoining

All detected nuke attempts are logged with detailed information including the user, detected actions, and timestamp for your review.

Configuration

Enable anti-nuke protection from the Anti-Raid tab in your server dashboard. Choose your preferred action (kick or ban) based on your security needs. We recommend using "Ban" for maximum protection.

Important Security Notes

  • DisGuard can only protect against users with lower permissions than the bot
  • Ensure DisGuard's role is positioned high in your role hierarchy
  • Only grant administrator permissions to users you completely trust
  • Regularly review your server's permission structure and member roles
  • Consider creating regular server backups for additional protection

Backup System

Create and manage server backups to protect your server configuration and structure. In case of a nuke attack, accidental changes, or data loss, you can quickly restore your server to a previous state.

What Gets Backed Up

DisGuard backs up critical server structure and configuration:

  • Roles: All server roles with their permissions, colors, and positions
  • Channels: Text, voice, and announcement channels with their settings
  • Categories: Channel categories and their organization
  • Permissions: Channel-specific permission overrides for roles and users

Note: Backups do not include messages, member data, or server settings like verification level.

Creating Backups

Create a backup by using the following command in your Discord server:

/restore create

Example: /restore create pre-event "Before summer event changes"

Each backup is timestamped and stored securely. You can view all your backups from the Backup tab in your server dashboard.

Restoring from Backup

Restore your server to a previous backup state using:

/restore restore

Warning: Restoring a backup will overwrite your current server structure. This action cannot be undone. We recommend creating a new backup before restoring.

Viewing Backups

Access the Backup tab in your server dashboard to view all available backups. You'll see:

  • Backup name and description
  • Creation date and time
  • Number of roles, channels, and categories
  • Backup version and creator
  • Backup size and validity status

Best Practices

  • Create regular backups (weekly or before major changes)
  • Use descriptive names and descriptions for easy identification
  • Keep at least 2-3 backups at all times
  • Create a backup before granting new users elevated permissions
  • Test backup restoration in a test server periodically

Dashboard Features

The DisGuard dashboard provides an intuitive interface for managing your server's security settings.

  • Real-time configuration updates - changes are saved automatically
  • Multi-server management - switch between servers seamlessly
  • Visual configuration preview - see how settings will appear to users
  • Role and channel ID management with tag-based input
  • Responsive design - manage your server from any device

Frequently Asked Questions

What permissions does DisGuard need?

DisGuard requires permissions to manage roles, send messages, and view channels. These permissions are necessary to verify users and assign roles upon successful verification.

How do I find channel and role IDs?

Enable Developer Mode in Discord (User Settings → Advanced → Developer Mode). Then right-click on any channel or role and select "Copy ID" to get the ID number.

Can I use multiple verification methods?

Currently, you can configure one verification method at a time. However, you can change the method at any time from the dashboard, and the changes will take effect immediately.

What happens if a user fails verification?

Users who fail verification will be removed from the Server. Failed attempts are logged in your configured log channel for monitoring purposes. You can set up additional actions through Discord's built-in moderation tools.

Is my data secure?

Yes. DisGuard only stores essential configuration data (server IDs, channel IDs, role IDs, and settings). We do not store user messages or personal information. All data is encrypted and stored securely.

How do the Word and Link Filters work?

The Word Filter and Link Filter automatically scan messages for banned content. When a message contains a banned word or link, it is immediately deleted before other users can see it. The action is logged in your moderation channel, including details about the user and the filtered content. You can manage your banned words and links list directly from the dashboard moderation tab.

How does the User Reporting system work?

Users can report problematic behavior using a report command (configured by your bot). Each report is logged in your designated report channel. When a user accumulates the configured number of reports (threshold), the automatic action you've set (kick, ban, or timeout) is applied. This empowers your community to help moderate while ensuring consistent enforcement of your server rules.

How do I configure the spam filters to avoid false positives?

Start with moderate limits and adjust based on your server's activity. For example, begin with 6 messages per 10 seconds, 4 media per 30 seconds, and 5 mentions per 15 seconds. Monitor your moderation logs and adjust the limits if you notice legitimate users being affected. Different servers have different activity levels, so customize the settings to match your community's behavior.

Can DisGuard prevent all nuke attacks?

DisGuard can detect and stop most nuke attacks by monitoring for suspicious mass actions. However, it can only act against users with lower permissions than the bot. To maximize protection, ensure DisGuard's role is positioned high in your role hierarchy (below only the owner and most trusted admins), and be very selective about granting administrator permissions to users.

How long are backups stored?

Backups are stored indefinitely until you manually delete them. However, we recommend maintaining only your most recent and important backups. You can view and manage all backups from the Backup tab in your server dashboard. Each backup includes information about when it was created and what it contains.

Need Help?

If you have questions or need assistance, join our Discord server for support from our team and community.

Join Support Server →