SwearFilter - Advanced Discord Moderation Bot Complete Documentation

The most advanced Discord moderation bot that keeps your community safe using intelligent algorithms. Achieve 96.8% accuracy with sub-10ms response times.

Getting Started with SwearFilter

Everything you need to know to get SwearFilter running in your Discord server

What is SwearFilter?

SwearFilter is a professional Discord moderation bot that uses intelligent algorithms (not AI) to detect and filter inappropriate content in real-time. With 96.8% accuracy and sub-10ms response times, it's the perfect solution for maintaining a clean, family-friendly Discord community.

Key Features Overview

Adding SwearFilter to Your Server

Step 1: Invite SwearFilter

Use our secure invite link to add SwearFilter to your Discord server. You will be redirected to Discord's authorization page.

Step 2: Select Your Server

Choose the Discord server where you want to install SwearFilter from the dropdown menu. Make sure you have the necessary permissions for that server.

Step 3: Authorize Permissions

Review and approve the permissions SwearFilter needs to protect your server effectively. We only request the minimum permissions required for proper functionality.

Required Permissions

SwearFilter needs specific permissions to function effectively:

Initial Configuration

After adding SwearFilter to your server, complete these essential setup steps:

Configure Moderation Actions

Set up what happens when inappropriate content is detected. You can choose from three escalation levels using the /swearaction command.

Set Up Logging (Recommended)

Create a dedicated channel for violation logs to track all moderation activities using /setlogchannel #mod-logs command.

Test the System

Verify everything is working correctly with a test message using /testswear hello world command.

How SwearFilter's Detection System Works

Understand the intelligent algorithms that power SwearFilter's detection system

Algorithm Overview

Our proprietary detection system uses deterministic algorithms that analyze over 369,588 safe words and countless profanity patterns to achieve 96.8% accuracy in content detection while ensuring zero false positives.

Step-by-Step Detection Process

Layer 1: Unicode Normalization

Converts hidden characters, homoglyphs, and Unicode variations to standardized forms for consistent detection. Normalize Unicode characters (NFKC), remove hidden separators, and convert homoglyphs (Cyrillic to Latin).

Layer 2: Smart Text Processing

Intelligently reduces repetition, handles spacing attempts, and processes character variations while preserving context. Smart repetition reduction with swear-awareness and collapse spaced letters.

Layer 3: Safe Word Database

Cross-references against 369,588+ legitimate words to eliminate false positives before applying detection algorithms. Check against 369,588+ safe words database (highest priority).

Layer 4: Multi-Layer Detection

Applies multiple detection algorithms including direct matches, fuzzy matching, character substitution, and transposition detection. Apply multiple detection layers: direct matches, Levenshtein distance, character variants, and transpositions.

Safe Words Protection

Our system uses a massive database of 369,588+ safe words to ensure legitimate messages are never blocked. This comprehensive database includes common words, technical terms, proper nouns, and contextual phrases to minimize false positives.

Protected Word Examples

Words like "assassin", "class", "classical", "assistant", "analysis", "mass", "passed", "message", "assume", "association" are protected from false positive detection.

Performance Metrics

Moderation and Escalation System

Configure smart escalation rules and automated moderation actions

Choose Your Moderation Style

Delete Only - Gentle & Non-Punitive

The gentlest approach that simply removes inappropriate content without further consequences. Perfect for establishing community standards while building trust with your members.

Delete + Timeout - Balanced Escalation

Balanced moderation that escalates consequences for repeat offenders. Messages are deleted immediately, and timeouts are applied after a configurable number of violations.

Immediate Action: Delete message instantly, increment warning counter, log violation details

After Threshold: Apply timeout duration, send notification message, update moderation logs

Delete + Timeout + Kick - Zero Tolerance

Full escalation system for zero-tolerance communities. Progresses from deletion to timeout to permanent removal based on violation patterns and configured thresholds.

Progressive Escalation Flow: 1st Violation → Timeout Threshold → Kick Threshold

Smart Warning System

Individual User Tracking

SwearFilter tracks individual user violations across time, allowing for progressive discipline that escalates appropriately based on user behavior patterns and configured thresholds.

Warning Tracking Features

Complete Bot Commands Reference

All commands are slash commands (start with /). Some commands require specific permissions.

Setup Commands

/autosetup

Automatically configure SwearFilter with recommended settings for your server.

Usage: /autosetup

Permissions: Manage Server or Bypass Role

/importconfig

Import filter configuration from a JSON (from /exportconfig).

Usage: /importconfig

Permissions: Manage Server or Bypass Role

/exportconfig

Export all your server configuration as JSON for backup or transfer.

Usage: /exportconfig

Permissions: Manage Server or Bypass Role

Moderation Commands

/swearaction

Configure moderation actions and escalation behavior

Usage: /swearaction [action] [timeout_threshold] [timeout_duration] [kick_threshold]

Permissions: Manage Server or Bypass Role

/toggle

Enable or disable the filter for the server

Usage: /toggle [enabled]

Permissions: Manage Server or Bypass Role

/setlogchannel

Set the channel for logging filtered messages and actions.

Usage: /setlogchannel [channel]

Permissions: Manage Server or Bypass Role

Word Management Commands

/addword

Add a custom word to your server's filter list

Usage: /addword [word]

Permissions: Manage Server or Bypass Role

/removeword

Remove a custom word from your server's filter list

Usage: /removeword [word]

Permissions: Manage Server or Bypass Role

/listwords

View all custom words in your server's filter list

Usage: /listwords

Permissions: Manage Server or Bypass Role

Role and Channel Commands

/addallowedrole

Grant bypass permissions to a specific role

Usage: /addallowedrole [role]

Permissions: Manage Server or Bypass Role

/removeallowedrole

Remove bypass permissions from a role

Usage: /removeallowedrole [role]

Permissions: Manage Server or Bypass Role

/addchannel

Exempt a specific channel from filtering

Usage: /addchannel [channel]

Permissions: Manage Server or Bypass Role

/removechannel

Re-enable filtering for a channel

Usage: /removechannel [channel]

Permissions: Manage Server or Bypass Role

Monitoring and Debug Commands

/health

Check bot status and configuration

Usage: /health

/stats

View server moderation statistics

Usage: /stats

/logs

Access recent violation logs

Usage: /logs [user]

/testswear

Test whether a message would be filtered (for debugging only).

Usage: /testswear [message]

Parameters: message - Message to test (required)

/debugperms

Debug permission issues

Usage: /debugperms [user]

/reset

Reset violation counts for users

Usage: /reset [user]

Permissions: Manage Server or Bypass Role

/listroles

List all roles in the server

Usage: /listroles

/listchannels

List all channels in the server

Usage: /listchannels

Web Dashboard Features

Real-time analytics, logs, and seamless settings management

Dashboard Overview

Access your personalized dashboard with live statistics, violation tracking, and instant settings synchronization between Discord and the web interface. Monitor your server's health in real-time.

Real-time Monitoring Features

Viewing Violation Logs

The logs section provides comprehensive tracking of all filter actions with powerful filtering and export capabilities. Each log entry includes detailed information about violations, user information, timestamps, and actions taken.

Log Entry Information

Analytics and Charts

Gain valuable insights into your server's moderation patterns with interactive charts and statistical analysis.

Available Analytics

CSV Export Capabilities

Export your violation data for external analysis, reporting, or backup purposes with comprehensive formatting options.

Export Contents

Bypass and Exemptions System

Configure smart bypasses for trusted users and channels

Role-Based Bypasses

Grant selective immunity to trusted members and staff without compromising overall protection. Perfect for moderators, VIPs, or trusted community members who need unrestricted communication.

How Role Bypasses Work

Users with bypass roles can send messages that would normally be filtered. This system respects Discord's role hierarchy and automatically detects role changes in real-time.

Role Management Commands

Channel Exemptions

Exclude specific channels from filtering for unrestricted discussion areas or staff channels. Perfect for adult content channels, staff-only areas, or casual discussion spaces.

Channel Exemption System

Channels in the exemption list will not have their messages filtered. The system supports individual channels, categories, and even thread exemptions for maximum flexibility.

Channel Management Commands

Best Practices and Guidelines

Recommended Practices

Security Considerations

Security and Privacy

Comprehensive data protection and security measures

What Data We Store

Your data security and user privacy are our top priorities. We implement industry-leading security measures and maintain full transparency about our data handling practices.

Data Collection

Data We Never Store

Data Retention Policy

Automatic Data Cleanup

When Bot is Removed

When SwearFilter is removed from your server, all associated data is automatically deleted within 24 hours. This includes all logs, configuration settings, violation counts, and cached data. This deletion is permanent and cannot be undone.

Security Infrastructure

Security Measures

Troubleshooting and Support

Common issues, solutions, and getting help

Frequently Asked Questions

Why isn't the bot responding to commands?

Check if the bot has the required permissions and that your server allows slash commands. Try re-inviting the bot with the latest OAuth2 link if issues persist.

How can I view detailed moderation logs?

Set up a log channel using /setlogchannel #your-log-channel. All filtered messages and moderation actions will be posted there with detailed information.

Can I customize the moderation actions and thresholds?

Yes! Use /swearaction to configure whether to delete only, timeout users, or kick repeat offenders. You can also customize violation thresholds and timeout durations.

The bot is not filtering some messages, what's wrong?

Check if the user has a bypass role or if the channel is exempted from filtering. Use /debugperms to check permissions and /health to verify bot status.

How do I reset violation counts for users?

Use the /reset command followed by the user mention to clear their violation history. You can also reset all users through the dashboard.

Common Issues and Solutions

Bot Not Responding

Permission Problems

Dashboard Issues

Getting Additional Help

Discord Support Server

Join our support server for real-time help from our community and team. Connect with other server administrators and get expert advice on configuration and best practices.

Documentation and Guides

Comprehensive guides covering setup, configuration, and advanced features. Access step-by-step tutorials, video guides, and detailed explanations of all features.

Direct Support

Report bugs, suggest features, or share your experience with our team. Use /quickfeedback command or contact us through our support channels for direct assistance.

Technical Specifications and Performance

System Performance Metrics

Supported Features

SwearFilter Community Impact

SwearFilter protects over 1,300 Discord communities worldwide, processing millions of messages daily and maintaining safe, positive environments for users of all ages. Our advanced detection system has blocked hundreds of thousands of toxic messages while maintaining legitimate conversation flow.

Real-time statistics show over 1,000,000 messages scanned and 300,000+ threats blocked across all protected servers. The system maintains consistent performance with zero downtime and continuous protection.

SwearFilter remains free for all Discord communities, providing enterprise-grade moderation capabilities without cost barriers. Our mission is to make Discord safer for everyone, regardless of community size or budget. No premium tiers, no feature restrictions, no hidden costs.