Moderation Overview
The Moderation module is the core protection system for your Discord server. It provides comprehensive tools for managing user behavior, preventing abuse, and maintaining a healthy community. This module integrates seamlessly with Security and Logging systems to provide complete visibility and control over moderation actions.
Module Components
The Moderation module consists of several interconnected components designed to work together:
Auto-Moderation Profiles
Create and manage moderation profiles that automatically detect and respond to rule violations. Each profile can target specific trigger types (spam, bad words, links, invites, excessive caps, mention spam) with configurable actions and escalation policies.
Manual Moderation Tools
Execute immediate moderation actions with bot commands and dashboard controls. Includes warn, mute, kick, ban, timeout, and purge capabilities with full audit logging.
Warning System
Track user warnings with automatic escalation. Set thresholds to automatically trigger mutes, kicks, or bans when a user accumulates too many warnings.
Anti-Raid Protection
Detect and respond to raid attempts with configurable sensitivity levels. Automatically lock down channels, require verification, or ban mass-joining users based on your thresholds.
Module Integration
The Moderation module integrates with other SYNTHET systems:
Security Module Integration
Moderation actions coordinate with security features. When anti-raid is triggered, it works with verification systems to challenge new users. Auto-moderation can escalate to bans which are tracked by the security module.
Logging Module Integration
Every moderation action is automatically logged to your designated logging channel. This includes auto-mod triggers, manual commands, warnings, and anti-raid events with full context and audit trails.
Behavioral Insights Integration
Enable BIE (Behavioral Insights Engine) integration to enhance auto-moderation with AI-powered detection. This analyzes user behavior patterns to identify suspicious activity beyond simple rule matching.
Accessing Moderation in Dashboard
The Moderation module is located in the Protection category of your dashboard:
Dashboard → Protection → ModerationFrom this page, you can configure auto-moderation profiles, manage anti-raid settings, toggle BIE integration, and view moderation statistics and recent actions.
Key Features
Real-Time Message Scanning
Auto-moderation profiles scan every message in real-time, detecting rule violations instantly and executing configured actions without delay.
Configurable Action Escalation
Set escalation rules where repeated violations trigger increasingly severe actions. For example: first offense warns, second mutes, third kicks, fourth bans.
Per-Channel Rules
Apply different moderation profiles to different channels. For example, stricter rules in announcements, lenient rules in off-topic. Override global rules at the channel level.
Immune Roles & Channels
Designate roles (staff, mods, bots) and channels (bot-commands) that are exempt from auto-moderation. Useful for preventing false positives and protecting important content.
Moderation Commands
In addition to dashboard configuration, moderators can use these slash commands for immediate action:
| Command | Parameters | Description |
|---|---|---|
/warn | user, reason (optional), silent (optional) | Warn a user and increment their warning count. Triggers escalation if threshold exceeded. |
/mute | user, duration, reason (optional) | Mute a user in text channels. Prevents message sending for specified duration. |
/unmute | user, reason (optional) | Remove mute from a user and restore their ability to send messages. |
/kick | user, reason (optional), purge-days (optional) | Remove a user from the server. They can rejoin if they have an invite link. |
/ban | user, reason (optional), purge-days (optional), appeal-code (optional) | Permanently ban a user from the server. Optionally provide an appeal code for later review. |
/unban | user-id, reason (optional) | Lift a ban from a user and allow them to rejoin the server. |
/timeout | user, duration, reason (optional) | Apply Discord timeout to a user. User cannot send messages or interact for duration. |
/purge | amount, user (optional), reason (optional) | Bulk delete recent messages. Optionally filter by user. Limited to messages under 14 days old. |
Bot Commands vs Dashboard Configuration
The moderation system works with both slash commands and dashboard configuration:
Slash Commands
Use slash commands for immediate, one-time moderation actions. These are ideal for addressing urgent issues in real-time and take effect immediately.
- •Instant execution with no lag
- •Full context from command invoker
- •Can override profiles for special cases
Dashboard Configuration
Use the dashboard to set up automated moderation rules. These profiles handle ongoing moderation automatically without requiring manual intervention.
- •Automatic 24/7 monitoring and enforcement
- •Configurable escalation and thresholds
- •Per-channel and per-role customization
Getting Started
To set up moderation for your server:
- 1.Navigate to Dashboard → Protection → Moderation
- 2.Create your first auto-moderation profile with rules for your community
- 3.Specify immune roles (staff, bots) to prevent false positives
- 4.Enable logging to track all moderation actions
- 5.Test with sample messages and review the log entries
Important Considerations
- • Always ensure the bot has appropriate permissions in the server and relevant channels
- • Test profiles in a testing channel before deploying to public channels
- • Review and adjust thresholds based on false positive rates
- • Add your staff team to immune roles to prevent accidental moderation
- • Monitor logs regularly to identify patterns and adjust rules accordingly
Quick Start: Setting Up Moderation
New to SYNTHET moderation? Here's the recommended setup order:
- 1.Enable Logging First - Set up a mod-log channel so you can track all actions
- 2.Configure Auto-Moderation - Create profiles for spam, bad words, and invites with light actions (delete/warn)
- 3.Set Warning Escalation - Define thresholds so repeated violations auto-escalate (3 warns = mute, 5 = kick, etc.)
- 4.Enable Anti-Raid - Configure sensitivity and lockdown triggers for raid protection
- 5.Monitor & Adjust - Watch logs for 1-2 weeks, adjust thresholds based on false positives