Moderation System

1. Feature Brief

The Moderation System provides a comprehensive moderation suite built on Discord’s native AutoMod engine. It pairs real-time content filtering with manual moderation utilities, anti-flood protection, and structured case logs, all managed through slash commands or an interactive dashboard.

1. AutoMod rule management - configure, toggle, and manage native Discord AutoMod filters directly through a dashboard GUI
2. Manual enforcement actions - warn, timeout, kick, ban, unban, and purge with strict role-hierarchy checks
3. Warning thresholds - automated timeouts trigger when a user reaches a configurable warning count
4. Anti-flood & media protection - detects rapid text spam, newline floods, and cross-channel phishing media spam
5. Detailed case logging - every moderation action produces a numbered case with actor, target, reason, and timestamps
6. Case history & HTML export - view past cases with /moderation history or export a complete interactive HTML report with /moderation export

Who can use this?

Members with Manage Messages, Kick Members, or Moderate Members permissions, or anyone holding the configured Moderator Role, can run moderation actions. Initial configuration requires Manage Server.

---

2. Sub-Systems

AutoMod Rules

Manage native Discord AutoMod rules through an interactive GUI without having to navigate Server Settings.

Discord permits up to 10 rules per server. The dashboard monitors active rule counts automatically.

Supported Rule Types:

Rule Type	Action
Keyword Filter	Blocks exact words or phrases you define (comma-separated)
Spam Protection	Discord AI-driven spam detection filter
Mention Spam	Blocks messages containing excessive user or role mentions
Preset Keywords	Built-in dictionaries for profanity, slurs, or sexual content
Link Blocker	Blocks unauthorized URL links with domain whitelist support
Repetitive Text	Regex-powered blocker for repeated characters and text floods

Rules default to Block Message and automatically notify your configured moderation log channel.

Flood & Media Protection

Protects your server from rapid-fire text flooding and image-based phishing attacks.

• Message Flood: Times out members who exceed message rate limits within a short time window
• Newline Spam: Automatically deletes single messages containing 15 or more line breaks and applies a timeout
• Media Spam & Phishing Defense: Detects rapid image, sticker, or GIF floods often used in compromised account phishing attacks, deletes the attachments across channels, and applies an automatic timeout
• Role Whitelisting: Use whitelist-role to exempt trusted moderator or bot roles

Role Position Matters

Utilara can only moderate members whose highest role is below the bot’s own role. Ensure the bot’s role is positioned high in your server role hierarchy.

Warnings & History

• Issue Warnings: Run /moderation warn with a user and required reason
• Automated Escalation: When a user reaches the server warning threshold (default: 3), Utilara applies an automatic 1-hour timeout
• Unwarn & Clear: Remove a single warning with /moderation unwarn warning-id:<id> or wipe all warnings with /moderation clearwarnings
• History & HTML Export: Run /moderation history for an overview, or use /moderation export user:<user> to download a formatted HTML case record

Moderation Actions

All actions enforce Discord role hierarchy, ensuring staff cannot target equal or higher roles.

Command	Description
/moderation warn	Issue a numbered warning with a required reason
/moderation timeout	Timeout a member (1 to 40,320 minutes)
/moderation untimeout	Remove an active timeout early
/moderation kick	Remove a member from the server
/moderation ban	Permanently ban with optional message deletion (0 to 7 days)
/moderation unban	Remove an active ban
/moderation purge	Bulk delete 1 to 100 messages (optional user filter)
/moderation history	View recent warnings and action cases for a member
/moderation export	Export a member’s complete moderation case log as HTML

---

3. Setup Guide

1. Initialize moderation - run /moderation setup and optionally select your log-channel and mod-role.

2. Open the dashboard - run /moderation dashboard to configure AutoMod rules, set warning thresholds, and view statistics.

3. Configure anti-flood and media protection - run /moderation antiflood:

   /moderation antiflood enabled:true messages:5 seconds:5 timeout:2
   /moderation antiflood media-spam:true media-limit:3 media-seconds:5 media-timeout:5

4. Verify role hierarchy - ensure Utilara’s role is placed above member roles in Server Settings.

Settings Reference

Setting	Configured via	Default
Log Channel	/moderation setup log-channel:	None
Moderator Role	/moderation setup mod-role:	None
Warning Threshold	Dashboard → Settings → Set Threshold	3 warnings
Message Flood Limit	/moderation antiflood messages:	5 messages
Flood Time Window	/moderation antiflood seconds:	5 seconds
Flood Timeout	/moderation antiflood timeout:	1 minute
Media Spam Limit	/moderation antiflood media-limit:	3 media
Media Time Window	/moderation antiflood media-seconds:	5 seconds
Media Timeout	/moderation antiflood media-timeout:	1 minute