Moderation

Moderation

Aegis provides a full moderation suite with warnings, kicks, bans, mutes, timeouts, and a complete per-member strike history — all with optional DMs to the user and detailed logging.

✓ No setup required Dashboard configurable Slash commands

Overview

All moderation actions are executed via slash commands. Each action is logged to your configured Moderation Log channel and optionally sends a DM to the targeted user. A full strike history is maintained per member and viewable from the dashboard.

💡

Aegis checks its own role position before executing moderation actions. If the target has a role higher than Aegis in the role hierarchy, the action will fail. Make sure the Aegis role is above all member roles.

Commands

Warnings

/warn
Issue a warning to a member. Warns are logged to their strike history and can trigger automated punishment thresholds.
user: required reason: required
/warnings
View all warnings for a member, including date, moderator, and reason.
user: required
/delwarn
Delete a specific warning from a member's history by its ID.
user: required id: required
/clearwarnings
Remove all warnings from a member's history.
user: required

Punishments

/kick
Kick a member from the server. They can rejoin via invite.
user: required reason: optional
/ban
Ban a member from the server. Optionally delete their recent messages.
user: required reason: optional delete_messages: optional
/unban
Remove a ban from a user by their ID.
user_id: required reason: optional
/mute
Assign the configured mute role to a member, preventing them from sending messages.
user: required reason: optional duration: optional
/unmute
Remove the mute role from a member.
user: required
/timeout
Apply a Discord native timeout to a member. They cannot send messages or join voice until it expires.
user: required duration: required reason: optional
/untimeout
Remove an active timeout from a member early.
user: required

Utility

/purge
Bulk delete messages in the current channel. Optionally filter to messages from a specific user.
amount: required user: optional
/slowmode
Set slowmode on a channel. Use 0 to disable.
seconds: required channel: optional
/lock
Lock a channel, preventing members from sending messages.
channel: optional reason: optional
/unlock
Unlock a previously locked channel.
channel: optional
/note
Add a private staff note to a member's record. Notes are only visible to staff on the dashboard.
user: required note: required

Warning Thresholds

You can configure automatic punishments that trigger when a member reaches a set number of warnings. Configure these in the dashboard under Moderation → Warning Thresholds.

Available auto-actions: Kick, Ban, Mute, Timeout. Each threshold can have its own action and an optional DM message sent to the user explaining the escalation.

⚠️

Thresholds count total warnings, not just recent ones. If you clear a member's warnings, the threshold counter resets.

DM Notifications

When enabled in dashboard settings, Aegis will DM the targeted user when a moderation action is taken against them. The DM includes:

DMs are sent on a best-effort basis — if the user has DMs disabled or has blocked the bot, it fails silently without affecting the action.

Moderation Log

All moderation actions are sent to your configured Moderation Log channel as embeds. Each log entry includes the action type, target, moderator, reason, and timestamp. Configure the log channel under Logging in the dashboard.

Strike History (Dashboard)

The dashboard's Moderation section shows a searchable list of all members with warnings. Click any member to view their full strike history, add notes, or delete individual warnings.

Mute Role Setup

The /mute command requires a configured Mute Role. Set this in Server Settings in the dashboard. The role should have Send Messages denied in all channels where you want muted members to be silenced.

🔧

Aegis has a Mute Role Repair tool in the dashboard that automatically applies the correct channel permission overwrites to your mute role across all channels.