Docs

Moderation

Advanced moderation tools and automation

🛡️ What is Moderation?

Moderation tools help you keep your server safe and friendly. Think of it like having security guards that automatically stop spam, bad words, and other problems before they become big issues.

Modora has two types of moderation: **AutoMod** (automatic protection) and **Manual Commands** (for when you need to take action yourself).

AutoMod Features

Anti-Spam

Automatically detect and prevent spam messages, repeated content, and message flooding.

Bad Words Filter

Filter inappropriate language with customizable word lists and automatic actions.

Anti-Raid Protection

Protect against server raids with join speed limits and verification systems.

Mod Logging

Track all moderation actions with detailed logs in a dedicated channel.

Custom Strike Ladder

Build your own escalation path — DM, timeout, kick, temp ban or ban — at any strike count you choose.

Strike System

Every /warn adds a strike. With the strike system enabled, Modora automatically applies the highest matching rule from your custom ladder.

Example ladder

  • 1 strike → DM notification
  • 2 strikes → Timeout (custom duration)
  • 3 strikes → Longer timeout
  • 4 strikes → Kick or temporary ban
  • 5 strikes → Permanent ban

How to configure

  1. Open Dashboard → your server → Moderation.
  2. Enable the Strike system toggle.
  3. Add or edit rules: set the strike count, choose an action, and set a duration for timeout or temp ban.
  4. Save. The next /warn that reaches a threshold will apply that action automatically.

Info

Only the highest matching rule runs (e.g. at 5 strikes a ban rule wins over a timeout rule).

Info

The strike ladder is stored apart from AutoMod. Running /modutils config strikes enabled:true creates it, and the ladder it starts with is 3 strikes for a one hour timeout, 5 for a kick and 10 for a ban. Every /warn add adds a strike and then applies the highest rule the member now matches.

How to Set Up AutoMod (Step-by-Step)

AutoMod stops spam and bad content automatically. Follow these steps.

01

Open the Dashboard

Go to modora.gg/dashboard and select your server. Open Modules, find AutoMod (or Moderation), enable it, then click to open.

Dashboard → Your Server → Modules → AutoMod
02

Open AutoMod Settings

You're now on the AutoMod page. Continue with the next step.

AutoMod module page
03

Enable AutoMod

Turn the main enable switch ON.

AutoMod -> Enable switch
04

Configure Rules

Enable the protections you want: Anti-Spam, Bad Words filter, Anti-Invite Links, etc. Each has its own toggle and settings.

AutoMod → Rules / Filters section
05

Set Log Channel

Select a channel where AutoMod logs its actions (deleted messages, warnings, etc.). Helps you review what happened.

AutoMod → Log channel dropdown
06

Set Actions per Rule

For each rule, choose the action: Warn, Delete message, Timeout, Kick, or Ban. You can use different actions for different rules.

AutoMod → Rule settings → Action dropdown
07

Save

Click 'Save'. AutoMod is now active. Test in a test channel (have someone spam or use a bad word) to verify it works.

AutoMod → Save button

Manual Moderation Commands

Use these commands when you need to take action yourself:

/warn [user] [reason]

Give someone a warning. This records the warning so you can see if they've been warned before.

/warn @user Stop spamming

Moderate Members

/mute [user] [duration] [reason]

Temporarily prevent someone from talking. They can still see messages but can't send any.

/mute @user 1h Being rude

Moderate Members

/kick [user] [reason]

Remove someone from the server. They can join back if they have an invite link.

/kick @user Breaking rules

Kick Members

/ban [user] [reason]

Permanently ban someone. They cannot rejoin unless you unban them.

/ban @user Repeated rule violations

Ban Members

/purge [amount]

Delete multiple messages at once. Useful for cleaning up spam.

/purge 50

Manage Messages

/timeout [user] [duration] [reason]

Same as mute - prevents someone from talking for a set time.

/timeout @user 30m Spam

Moderate Members

AutoMod

AutoMod is its own module, at Dashboard → your server → AutoMod. It holds a list of rules. Each rule has one trigger, one or more actions, and its own list of roles, channels and members that it skips.

Rules are checked in order of priority and the first rule that matches ends the check for that message. The server owner is skipped by every rule.

Triggers

  • Spam detection: repeated characters, and the caps percentage of a message.
  • Link filter: everything that is not on the allowed domain list.
  • Invite links: Discord invites, with an option to allow your own server.
  • Bad words: your own word list, whole words only unless you turn that off.
  • Caps lock: messages above a caps percentage.
  • Mention spam: more mentions in one message than you allow.
  • Emoji spam: more emoji in one message than you allow.

Warning

Profile names are handled by their own filter, not by a rule. Switch it on in the AutoMod panel and give it a word list. It runs when someone joins and when they change their name. Modora can clear or replace a nickname, but it cannot change someone's Discord username, and it cannot touch the server owner or anyone with a higher role.

Actions

Block message deletes it, Warn user sends a warning, Timeout user mutes them for the duration on the rule, and Alert moderators posts a notice. A rule can carry several at once.

The timeout durations the rule editor offers are 1 minute, 5 minutes, 10 minutes, 30 minutes and 1 hour, plus 24 hours on rules that allow the longer list.

Presets and Discord rules

A preset fills the rule list in one step. Merge adds the preset rules to what you already have, replace throws your list away first. Merge is what happens if you do not choose.

Sync from Discord reads the AutoMod rules Discord itself holds into your list. Sync to Discord writes yours back the other way.

The log

Every action AutoMod takes is sent back to the dashboard and shown on the same page. Send test log writes one entry so you can check the panel is reading before you wait for a real one.

Warn System

/warn add writes the warning, opens a moderation case and adds a strike in one go. Dashboard → your server → Warn System lists every warning in the server, and lets you add or delete one from the browser.

A warning added from the dashboard takes a reason of up to 1000 characters, a severity from 1 to 5, an optional expiry date, and can open a case for itself.

/warn list shows a member's active warnings. /warn remove deletes one, by id or the most recent.

Warning

The same page offers Maximum warnings, automatic actions, DM on warn, a log channel and a list of preset reasons. Those are stored in a table nothing else reads. What actually escalates a warning is the strike ladder, and whether a warned member is sent a DM is decided by the Moderation module's DM setting.

Cases

Dashboard → your server → Case Management. A case has a number in the form CASE-000001, a type (ban, kick, mute, warn, note or other), a status, the member, the moderator, a reason of up to 2000 characters, evidence, an optional assignee and an optional expiry.

You can comment on a case; a comment is at most 2000 characters and can be marked internal. Setting a case to resolved or closed stamps the time and who did it.

Warning

This page and the /case command read the same list. A case opened from Discord by /warn, /ban or /kick shows up here, and a case opened here is visible to /case view, /case list and /case search.

Member notes

Private staff notes on a member. /member-notes add, /member-notes list and /member-notes remove in Discord, or Dashboard → your server → Member Notes. Both write the same notes. A note is at most 2000 characters and /member-notes list shows the 25 most recent.

From the dashboard a note also carries a type (note, warning, positive or other), a pin flag and an optional case reference. A note added with the command carries only its text.

Slowmode Manager

/slowmode sets a rate limit on one channel by hand and needs Manage Channels. The Slowmode Manager module raises and lowers it on its own, per channel, from how busy that channel is.

Busy is measured in messages per minute. At or above the activity threshold the slowmode goes up: from zero it jumps to 5 seconds or your minimum, whichever is higher, and after that it doubles. At or below half the threshold it halves again, never past your base or minimum. In between it is left alone.

Base, minimum and maximum slowmode are in seconds, from 0 to 21600. That ceiling is Discord's own. The activity threshold is 1 to 1000 messages, and the adjustment interval is 60 to 3600 seconds. A new server starts at base 0, minimum 0, maximum 21600, threshold 10 and interval 300.

The interval is a floor on how often one channel may move, so a channel climbs in steps instead of jumping every cycle. The bot never checks a channel more than once every 30 seconds regardless.

If the slowmode on a channel is already above your maximum, it is left alone: somebody set that on purpose. Channels on the exclusion list are skipped, and messages from excluded roles do not count towards the rate. A log channel gets one line per change.

Warning

Two things on this page do not do anything yet. Per-channel overrides are saved but never read, and the history list stays empty because nothing writes to it. The log channel is the way to see what the module changed.

Common Questions

Best Practices

💡 Tip:

Set up a dedicated moderation log channel to track all automated and manual actions. This helps you see what's happening and why.

Tip

Make sure Modora's role is above the roles it needs to moderate. In Discord, go to Server Settings → Roles and drag Modora's role higher in the list.

Tip

Use a graduated punishment system: First offense = warn, Second = mute, Third = kick, Fourth = ban. This gives people chances to improve.

Was this page helpful?