Moderation Commands

All moderation commands are available as slash and prefix commands.

Prefix Moderation Notes

Prefix moderation now supports:

short flags like -r, -t, -u, -id, -del, -dm, and -p
attachment-based proof on supported commands
a confirmation review before high-impact actions are applied
cleaner help output with a quick-use line and a ready-to-copy example

Reading Prefix Examples

When you see a command like this:

@Modulus ban @User -r "Raiding" -del 1 -dm false -p

Read it like this:

@User is the target
-r is the reason
-del removes recent messages
-dm false skips the direct message
-p uses the attached proof file or image

Examples:

@Modulus ban @User -r "Raid participation" -del 7 -dm false -p
@Modulus mute @User -t 30m -r "Spam" -p
@Modulus unban -id 123456789012345678 -r "Appeal approved"

/ban

Ban a user with optional message deletion and DM.

Options

Option	Type	Required	Notes
`user`	user	yes	Target user.
`reason`	string	no	Autocomplete reasons.
`delete_messages`	integer	no	0, 1, 3, or 7 days.
`dm`	boolean	no	Defaults to true when DM on punish is enabled.

Example

/ban user:@User reason:Spam delete_messages:7 dm:false
@Modulus ban @User -r "Spam" -del 7 -dm false -p

/case

View a moderation case by ID.

Options

Option	Type	Required	Notes
`id`	integer	yes	Case ID.

Example

/case id:123

/history

View recent moderation cases for a user.

Options

Option	Type	Required	Notes
`user`	user	yes	Target user.
`limit`	integer	no	1 to 20.

Example

/history user:@User limit:10

/kick

Kick a user from the server.

Options

Option	Type	Required	Notes
`user`	user	yes	Target user.
`reason`	string	no	Reason for the kick.
`dm`	boolean	no	Defaults to true when DM on punish is enabled.

Example

/kick user:@User reason:Spam

/lockdown

Lock or unlock channels without destroying overwrite history.

Options

Option	Type	Required	Notes
`mode`	string	yes	`on` or `off`.
`reason`	string	yes	Reason shown in logs.
`channel`	channel	no	Target channel, otherwise all text and announcement channels.

Example

/lockdown mode:on reason:"Raid detected"

/mute

Timeout a user for a duration.

Options

Option	Type	Required	Notes
`user`	user	yes	Target user.
`time`	string	yes	Duration in `s`, `m`, `h`, `d` (example `10m`).
`reason`	string	no	Reason.

Example

/mute user:@User time:30m reason:"Spam"
@Modulus mute @User -t 30m -r "Spam" -p

/purge

Bulk delete messages from a channel.

Options

Option	Type	Required	Notes
`amount`	integer	yes	1 to 100 messages.
`user`	user	no	Only delete messages from this user.
`proof`	attachment	no	Optional evidence image or file.

Example

/purge amount:25 user:@User proof:[attachment]
@Modulus purge 25 -u @User -p

/quarantine

Place a user in quarantine.

Options

Option	Type	Required	Notes
`user`	user	yes	Target user.
`reason`	string	yes	Reason.
`dm`	boolean	no	Defaults to true when DM on punish is enabled.

Example

/quarantine user:@User reason:"Raid"

/revokeallwarns

Clear all active warnings for a user.

Options

Option	Type	Required	Notes
`user`	user	yes	Target user.
`proof`	attachment	no	Optional evidence image or file.

Example

/revokeallwarns user:@User proof:[attachment]

/slowmode

Set slowmode on a channel.

Options

Option	Type	Required	Notes
`seconds`	integer	yes	0 to 21600 seconds.
`channel`	channel	no	Target channel, defaults to current.
`proof`	attachment	no	Optional evidence image or file.

Example

/slowmode seconds:10 channel:#general proof:[attachment]

/softban

Ban and immediately unban to delete recent messages.

Options

Option	Type	Required	Notes
`user`	user	yes	Target user.
`reason`	string	no	Reason.
`delete_messages`	integer	no	1, 3, or 7 days.
`dm`	boolean	no	Defaults to true when DM on punish is enabled.

Example

/softban user:@User reason:"Raid" delete_messages:7

/tempban

Temporarily ban a user.

Options

Option	Type	Required	Notes
`user`	user	yes	Target user.
`duration`	string	yes	Duration in `s`, `m`, `h`, `d` (example `7d`).
`reason`	string	yes	Reason.

Example

/tempban user:@User duration:7d reason:"Appeal pending"
@Modulus tempban @User -t 7d -r "Appeal pending" -p

/unban

Unban a user by ID.

Options

Option	Type	Required	Notes
`id`	string	yes	User ID.
`reason`	string	no	Reason.

Example

/unban id:123456789012345678 reason:"Appeal approved"
@Modulus unban -id 123456789012345678 -r "Appeal approved"

/unmute

Remove a timeout.

Options

Option	Type	Required	Notes
`user`	user	yes	Target user.

Example

/unmute user:@User

/unquarantine

Remove a user from quarantine.

Options

Option	Type	Required	Notes
`user`	user	yes	Target user.
`reason`	string	no	Reason.

Example

/unquarantine user:@User reason:"Resolved"

/unwarn

Revoke a warning.

Options

Option	Type	Required	Notes
`user`	user	yes	Target user.
`id`	string	yes	Warning ID.

Example

/unwarn user:@User id:warn_123

/voicemute

Server mute or unmute a user in voice.

Options

Option	Type	Required	Notes
`user`	user	yes	Target user.
`mode`	string	yes	`on` or `off`.
`reason`	string	no	Reason.

Example

/voicemute user:@User mode:on reason:"Mic spam"

/warn

Warn a user.

Options

Option	Type	Required	Notes
`user`	user	yes	Target user.
`reason`	string	yes	Reason.

Example

/warn user:@User reason:"Spam"
@Modulus warn @User -r "Spam" -p

/warns

View active warnings for a user.

Options

Option	Type	Required	Notes
`user`	user	yes	Target user.

Example

/warns user:@User
@Modulus warns @User

Prefix Command Guide

Utility