Moderation Dashboard UI Guide
This guide walks you through every feature of the Moderation dashboard. Learn how to create and manage auto-moderation profiles, configure anti-raid protection, and integrate Behavioral Insights Engine for advanced threat detection.
Dashboard Overview
The Moderation dashboard is organized into tabs for easy navigation:
Profiles Tab
Create and manage auto-moderation profiles. Each profile contains trigger rules, actions, and exemptions.
Anti-Raid Tab
Configure raid detection sensitivity, lockdown triggers, and mass-join thresholds.
Settings Tab
Global moderation settings including BIE integration, logging channel, and default escalation rules.
Statistics Tab
View charts and metrics for moderation actions, trends, and system health.
Creating Auto-Moderation Profiles
Auto-moderation profiles are the core of the moderation system. Each profile contains rules and actions that apply to specific channels.
Step 1: Click Create Profile
In the Profiles tab, click the "Create Profile" button. A modal will appear where you can enter:
- •Profile Name: A descriptive name like "Spam Detection" or "Invite Links"
- •Description: Optional explanation of what this profile detects
- •Enabled: Toggle to activate the profile immediately
Step 2: Configure Trigger Rules
After creating the profile, add trigger rules. Each rule specifies what to detect:
Trigger Types (use the Trigger Type dropdown):
- • Spam: Repeated messages or rapid message sending
- • Bad Words: Messages containing blocked keywords or phrases
- • Links: Messages containing suspicious or unapproved URLs
- • Invites: Discord server invites in messages
- • Caps: Excessive uppercase text (all caps messages)
- • Mentions: Mass mentions or spam pings (@everyone, @here)
Step 3: Set Thresholds
Configure when the rule triggers. For each trigger type, you can set:
- •Threshold Number: How many violations before action (e.g., 3 repeated messages = spam)
- •Time Window: Detection period (e.g., trigger if 3 messages within 10 seconds)
- •Severity Level: Low, Medium, High for escalation purposes
Step 4: Choose Actions
Select what happens when a rule is triggered. Use the Action dropdown to choose:
- •Delete: Remove the offending message
- •Warn: Issue a warning to the user
- •Mute: Silence the user for a specified duration
- •Timeout: Apply Discord timeout (user cannot send messages)
- •Kick: Remove the user from the server
- •Ban: Permanently ban the user
Step 5: Configure Exemptions
Prevent false positives by exempting important roles and channels:
Immune Roles (SearchableSelect)
Click the "Select Immune Roles" field to search and select roles that should be exempt from this profile. Common choices:
- • Administrator role
- • Moderator role
- • Bot role (for other bots)
Immune Channels (SearchableSelect)
Click the "Select Immune Channels" field to choose channels where this profile should not apply. Common choices:
- • #bot-commands (bots may legitimately use caps or links)
- • #spam (designated spam channel)
- • #off-topic (more lenient channel)
Editing Profiles
To modify an existing profile:
- 1.Find the profile in the Profiles list
- 2.Click the profile name or the edit icon to open the configuration panel
- 3.Make your changes to rules, actions, or exemptions
- 4.Click "Save Changes" to apply the update immediately
Note: Profile changes take effect immediately. Test changes in a private channel first if needed.
BIE Integration (Behavioral Insights Engine)
Enable AI-powered threat detection for advanced moderation:
Enabling BIE
In the Settings tab, find the "Behavioral Insights Engine" section:
- 1. Toggle "Enable BIE Integration" to ON
- 2. Select BIE detection sensitivity: Low, Medium, or High
- 3. Choose which profile types to enhance with BIE
- 4. Click "Save and Connect"
What BIE Does
Beyond simple rule matching, BIE analyzes:
- •User behavior patterns (account age, activity history, previous violations)
- •Coordinated suspicious activity (multiple users behaving similarly)
- •Context-aware intent (is message spam or genuine conversation)
- •Evasion attempts (users trying to bypass filters)
Sensitivity Levels: Low reduces false positives but misses some threats. High catches more threats but may flag innocent messages. Medium is recommended for most servers.
Anti-Raid Configuration
Protect your server from raid attacks with automated detection and response:
Raid Detection Settings
In the Anti-Raid tab, configure detection parameters:
Detection Sensitivity (dropdown):
- • Low: Only extreme raids (50+ joins in 10s)
- • Medium: Moderate raids (20+ joins in 10s)
- • High: Aggressive detection (5+ joins in 10s)
Lockdown Triggers
Set what happens when a raid is detected:
- •Lockdown Action (dropdown): Ban raiders, require verification, require admin approval
- •Duration (number input): How long to maintain lockdown (1 hour, 24 hours, etc.)
- •Auto-Ban Accounts (toggle): Automatically ban new accounts below join age threshold
- •Min Account Age (number input): Minimum age (in days) for accounts during lockdown
Raid Management
Additional anti-raid features:
- •Whitelist Management: Add trusted users who won't be auto-banned during lockdown
- •Notification Channel (SearchableSelect): Select channel for raid alerts
- •Ping on Raid (toggle): Mention staff roles when raid detected
During a Raid
When a raid is detected, the system automatically:
- 1. Triggers lockdown in all channels
- 2. Begins filtering new member joins
- 3. Notifies configured staff channel
- 4. Begins logging raid activity
- 5. Removes lockdown after configured duration
Global Moderation Settings
In the Settings tab, configure server-wide moderation defaults:
Logging Channel (SearchableSelect)
Select the channel where all moderation actions are logged. This should be a private staff-only channel.
Warning Escalation (toggle)
Enable automatic escalation: 3 warnings = mute, 6 warnings = kick, 9 warnings = ban.
Default Mute Duration (dropdown)
Set the default mute length: 5 minutes, 1 hour, 24 hours, 7 days, or custom.
Appeal System (toggle)
Allow banned users to appeal their ban. Specify a channel for appeals and who reviews them.
DM Notifications (toggle)
When enabled, users receive DM notifications when they're warned, muted, or other moderation actions.
Profile Types & Templates
The dashboard includes pre-configured profile templates for quick setup:
Spam Detection Profile
Detects repeated messages and rapid message sending. Default action: Delete + Warn.
Bad Words Profile
Filters prohibited keywords and phrases. Configurable word list. Default action: Delete + Warn.
Link Control Profile
Blocks unapproved links and URLs. Option to whitelist specific domains. Default action: Delete.
Invite Prevention Profile
Blocks Discord server invites. Option to allow invites to your own server. Default action: Delete + Warn.
Caps Limiter Profile
Detects excessive uppercase text. Configurable threshold. Default action: Delete.
Mention Spam Profile
Blocks mass mentions and @everyone/@here abuse. Default action: Delete + Warn.
Testing & Refinement
Best practices for setting up moderation:
Testing Profiles
- 1. Create a private test channel
- 2. Apply the profile to only this channel
- 3. Send test messages to verify detection
- 4. Check the log channel for action records
- 5. Adjust thresholds if too many false positives
- 6. Apply to public channels when satisfied
Monitoring False Positives
Review logs regularly to identify legitimate messages being flagged. If you notice false positives:
- • Increase thresholds for that trigger type
- • Add channels to the immune list
- • Create role exemptions for community members
Key Points
- • SearchableSelect fields allow you to type to search (e.g., type "mod" to find "Moderator" role)
- • Green save buttons have BLACK text for accessibility
- • Changes to profiles take effect immediately across all channels
- • Always test sensitive changes in private channels first
- • Review moderation logs daily to monitor system performance