Moderation
MJ Bot provides a full suite of moderation commands to keep your server safe and organized. Every action is logged into a case system, making it easy to track moderator activity and member history.
Commands
Core Actions
| Command | Description | Usage |
|---|---|---|
/ban | Permanently ban a member from the server | /ban @user [reason] |
/kick | Kick a member from the server | /kick @user [reason] |
/warn | Issue a warning to a member | /warn @user [reason] |
/mute | Timeout a member for a specified duration | /mute @user <duration> [reason] |
/unmute | Remove a timeout from a member | /unmute @user [reason] |
/unban | Unban a previously banned user | /unban <user-id> [reason] |
/softban | Ban and immediately unban a member to delete their messages | /softban @user [reason] |
Channel Management
| Command | Description | Usage |
|---|---|---|
/purge | Bulk delete messages from a channel | /purge <amount> [@user] |
/lock | Lock a channel to prevent members from sending messages | /lock [#channel] [reason] |
/unlock | Unlock a previously locked channel | /unlock [#channel] |
/lockdown | Lock all channels in the server simultaneously | /lockdown [reason] |
/slowmode | Set slowmode delay on a channel | /slowmode <seconds> [#channel] |
Case & Warning Management
| Command | Description | Usage |
|---|---|---|
/case | View details of a specific moderation case | /case <case-id> |
/modlogs | View all moderation cases for a member | /modlogs @user |
/warnings | View all active warnings for a member | /warnings @user |
/clearwarnings | Clear all warnings for a member | /clearwarnings @user |
Extras
| Command | Description | Usage |
|---|---|---|
/temprole | Assign a temporary role that auto-removes after a duration | /temprole @user @role <duration> |
/escalation | Configure automatic punishment escalation | /escalation <threshold> <action> |
Dashboard Configuration
You can configure all moderation settings from the Moderation section of the dashboard.
Roles
- Mod Roles -- Roles that are allowed to use moderation commands such as warn, mute, kick, and purge.
- Admin Roles -- Roles that have access to elevated commands such as ban, lockdown, and clearwarnings.
Log Channel
Set a dedicated channel where all moderation actions are logged automatically. Each log entry includes the moderator, the target member, the reason, and the case ID.
It is strongly recommended to set a mod log channel so your team has a clear audit trail of every action taken.
Auto-Escalation
Auto-escalation allows you to define automatic punishments that trigger when a member reaches a certain number of warnings.
Example configuration:
| Warning Threshold | Action |
|---|---|
| 3 warnings | Mute for 1 hour |
| 5 warnings | Kick |
| 7 warnings | Ban |
Escalation actions are cumulative. When a member hits a threshold, the corresponding action fires automatically in addition to the warning itself.
Case System
Every moderation action (ban, kick, warn, mute, etc.) creates a case with a unique ID. Cases store:
- The action type
- The moderator who performed the action
- The target member
- The reason provided
- A timestamp
Use /case <id> to look up any case, or /modlogs @user to see a member's complete history.
Clearing warnings with /clearwarnings removes warning records but does not delete other case types (bans, kicks, mutes). Those remain in the moderation log permanently.