Moderation System

Keep your server safe with Natsumi's comprehensive moderation tools. From warnings to bans, automod to logging - everything you need to manage your community.

Overview

Natsumi's moderation system provides server moderators with powerful tools to maintain order and safety. The system is designed to be flexible yet easy to use, with both manual commands and automatic moderation features.

• Tiered warning system with history tracking
• Automatic punishment escalation
• Temporary and permanent bans/mutes
• Advanced auto-moderation rules
• Detailed moderation logs

Warning System

Warnings are the foundation of progressive discipline. Each warning is stored with the reason, moderator, and timestamp for full accountability.

Issuing Warnings

Slash Command

/warn @user <reason>

When a warning is issued:

• The user receives a DM notification with the reason
• The warning is logged to the mod log channel
• The warning is stored in the user's history
• If configured, automatic escalation may trigger

Viewing Warning History

Slash Command

/warnings @user

This displays all warnings for a user, including the date, reason, and which moderator issued each warning.

Removing Warnings

Warnings are removed from the dashboard rather than with a command. Open your server's dashboard, go to Moderation, find the member, and delete either a single warning or their whole history.

/history shows the same records in Discord, including the warning IDs the dashboard lists.

Punishments

Natsumi supports various punishment types for different situations. All punishments are logged and can be configured to auto-expire.

Timeout/Mute

Temporarily prevents the user from sending messages or joining voice channels.

/timeout @user <duration> [reason]

Kick

Removes the user from the server. They can rejoin with a new invite.

/kick @user [reason]

Ban

Permanently (or temporarily) bans the user from the server.

/ban @user [duration] [reason]

Duration Format

For temporary punishments, use these duration formats:

• 30m = 30 minutes 2h = 2 hours 1d = 1 day 1w = 1 week

Automatic Escalation

Configure automatic punishment escalation based on warning thresholds. When a user reaches a certain number of warnings, Natsumi can automatically apply the next level of punishment.

Configuration

Set up escalation through the dashboard or using commands:

• Warnings Action Duration
• 3 warnings Timeout 1 hour
• 5 warnings Timeout 24 hours
• 7 warnings Kick -
• 10 warnings Ban Permanent

Pro Tip

These thresholds are customizable via the dashboard. Adjust them to match your server's moderation philosophy.

Auto-Moderation

Natsumi's auto-moderation system can automatically detect and act on rule violations. Configure rules for spam, links, banned words, and more.

Available Automod Rules

Spam Detection

Recommended

Detects rapid message posting, duplicate messages, and mention spam.

• Max messages per 5 seconds
• Max duplicate messages
• Max mentions per message

Link Filtering

Block or filter links with whitelist/blacklist support.

• Block all links
• Whitelist specific domains
• Blacklist specific domains

Word Filter

Block messages containing specific words or phrases.

• Custom word list
• Wildcard matching
• Case insensitive

Caps Lock

Limit excessive use of capital letters in messages.

• Max caps percentage
• Minimum message length

Invite Links

Block Discord server invite links from being posted.

• Delete invite links
• Whitelist partner servers

New Account Filter

Restrict new Discord accounts from certain actions.

• Minimum account age
• Restrict links for new accounts

Automod Actions

When a rule is triggered, Natsumi can:

• Delete - Remove the offending message
• Warn - Issue an automatic warning
• Timeout - Temporarily mute the user
• Log - Record the violation without action

Mod Log

The mod log channel records all moderation actions for accountability and transparency. Set up a mod log channel to track:

• Warnings, kicks, bans, and timeouts
• Message deletions and edits
• Automod violations
• Member joins and leaves
• Role and channel changes

Setting Up Mod Log

Set Mod Log Channel

/moderation modlog setup channel:#channel

Multiple Log Channels

You can set up different channels for different log types. See the Logging documentation for more details.

All Moderation Commands

Quick reference for all moderation commands. Click any command to see more details on the commands page.

Command	Description
/warn	Warn a user
/warnings	View a user's warning history
/history	View the full punishment history for a user
/timeout	Timeout a member
/removetimeout	Remove a member's timeout
/mute	Mute a member using the configured mute role
/unmute	Unmute a member
/kick	Kick a member from the server
/ban	Ban a member from the server
/tempban	Temporarily ban a member from the server
/unban	Unban a user from the server

Configuration commands

Command	Description
/moderation muterole set	Set the role used for muting members
/moderation muterole view	View the current mute role configuration
/moderation muterole remove	Remove the current mute role configuration
/moderation modlog setup	Set the main modlog channel
/moderation modlog toggle	Enable or disable specific events by category
/moderation modlog channel	Set a custom channel for specific events
/moderation modlog ignore	Never log a channel or a user
/moderation modlog list	View all available events and configuration