Escalation & Actions
Configure escalating punishment steps and understand how Nevi's automod violation tracking works.
How escalation works
Each violation is recorded with a timestamp. The system counts how many violations a user has within the violation window (default: 1 hour) and applies the highest matching step number.
Example
A spam filter has steps 1 and 3 configured. When a user triggers the filter:
Violations 1-2: step 1 is applied (the highest step that does not exceed the count)
Violations 3+: step 3 is applied
Old violations are cleaned after 7 days, regardless of the violation window setting. This prevents indefinite accumulation in the database.
Available actions
Each escalation step can apply one or more of these 7 actions. Combine them with commas (e.g., warn,delete).
| Action | Description |
|---|---|
delete | Delete the triggering message |
warn | Issue a warning to the user |
mute | Mute the user. Default 10 minutes if no duration specified. Capped at 28 days. |
kick | Kick the user from the server |
ban | Ban the user. Optional duration for temporary bans. |
softban | Ban and immediately unban the user. Deletes 7 days of their messages. |
lockdown | Set guild verification to VERY_HIGH. Automatically reverts after the specified duration. |
Configuring steps
Use the /automod step command to add or update escalation steps for any filter.
Usage
/automod step <filter> <step_number> <actions> [duration] [reason]
Example
/automod step spam 1 warn,delete— First spam violation: warn and delete
/automod step spam 2 mute,delete 10m Repeated spam— Second violation: mute 10m, delete, log reason
filter: spam, links, words, mentions, or raids
step_number: 1 through 7
actions: comma-separated action list (e.g., "warn,delete" or "mute,delete")
duration: optional, for mute, ban, or lockdown (e.g., 10m, 1h, 7d)
reason: optional, attached to the moderation log entry
Removing steps & filters
Remove individual steps or entire filters when you no longer need them.
Usage
/automod removestep <filter> <step_number>— Remove a specific step from a filter
/automod removefilter <filter>— Remove an entire filter and all of its escalation steps
Violation window
The violation window controls how long past violations count toward escalation. Only violations within this window are counted when determining which step to apply.
Usage
/automod window <duration>— Default: 1 hour. Accepts durations like 30m, 2h, 1d
A shorter window means users "reset" faster and need to re-offend quickly to escalate. A longer window means violations accumulate over a longer period, making escalation more likely for repeat offenders.
Related Commands
/automodmanagementRequires modConfigure the automod system