Punishments
Ban, kick, mute, warn, purge messages, and manage channels with Nevi's moderation commands.
Quick reference
All punishment and channel management commands at a glance.
| Command | Description | Level |
|---|---|---|
/ban @user [reason] [delete_days] | Permanently ban a user | Mod |
/kick @user [reason] | Remove user (can rejoin) | Mod |
/hackban <user_id> [reason] | Ban by user ID (not in server) | Mod |
/softban @user [reason] | Ban+unban to delete messages | Mod |
/unban <user_id> [reason] | Remove a ban | Mod |
/mute @user [duration] [reason] | Silence with mute role | Mod |
/unmute @user [reason] | Remove mute | Mod |
/warn @user <reason> | Issue tracked warning | Mod |
/reason <case-id> <new reason> | Edit a case reason | Mod |
/purge <amount> [@user] | Bulk-delete messages (1-100) | Mod |
/lock [#channel] | Toggle channel lock | Mod |
/renamechannel <name> | Rename current channel | Admin |
Bans & kicks
Commands for removing users from the server, temporarily or permanently.
/ban @user [reason] [delete_days]
Permanently removes a user from the server. They cannot rejoin until unbanned. The optional delete_days parameter deletes their messages from the past 0-7 days.
/kick @user [reason]
Removes a user from the server, but they can rejoin with a new invite. Good for minor offenses or first-time rule breaks.
/hackban <user_id> [reason]
Ban a user by their ID, even if they are not currently in the server. Useful for preemptive bans during raid cleanup or banning users who already left.
/softban @user [reason]
Bans and then immediately unbans the user. This deletes their recent messages without keeping them permanently banned. Acts as a message cleanup tool.
/unban <user_id> [reason]
Lifts a ban from a user. You can find user IDs in the mod log or under Server Settings > Bans.
Mutes & warnings
Commands for silencing users and issuing tracked warnings.
/mute @user [duration] [reason]
Assigns the configured mute role to a user. Supported durations include 30m, 2h, 1d, and 1w. Omit the duration for an indefinite mute.
/unmute @user [reason]
Removes the mute role and cancels any active timer for the user.
/warn @user <reason>
Issues a formal warning that is tracked in the moderation log with a case ID. The user keeps all permissions. Warnings build a record you can review later.
/reason <case-id> <new reason>
Updates the reason on any past moderation action by its case ID. Useful for adding context after the fact or correcting a typo.
Set the mute role with /config set muteRole @Muted. Nevi automatically creates channel permission overwrites so muted users cannot send messages in any channel.
Purging messages
Bulk-delete messages to clean up spam, off-topic content, or rule-breaking posts.
/purge <amount>
Deletes the specified number of messages (1-100) from the current channel.
/purge <amount> @user
Only deletes messages from the specified user within the last amount messages.
Limitations
- Discord only allows deleting messages less than 14 days old.
- Maximum of 100 messages per command.
- Pinned messages are included in the deletion count.
Tip: lock the channel first during active spam, then purge. This prevents new messages from being sent while you clean up.
Channel management
Quick commands for controlling channel access and naming.
/lock [#channel]
Toggles the Send Messages permission for @everyone in the specified channel (or the current channel if none is given). Run the command again to unlock.
/renamechannel <new-name>
Renames the current channel. Requires Admin level permissions.
Common Use Cases
- Lock channels during a raid to stop spam instantly.
- Create announcements-only channels by locking after posting.
- Rename temporary event channels without opening server settings.
DM notifications
Nevi can notify users via DM when they receive a punishment.
Enable DM Notifications
Run /config set dmPunishments true to send DMs on ban, kick, mute, and warn actions.
What Users Receive
Each DM includes the server name, the action taken, and the reason (if provided).
DMs Disabled
If a user has DMs disabled or has blocked Nevi, the notification fails silently. The punishment still applies normally.
Tips
Always provide a reason
Reasons appear in Discord's audit log, Nevi's moderation log, and in DM notifications to the user. A clear reason helps your team stay aligned and gives punished users context.
Escalation path
Start with warnings for minor issues, move to mutes for repeat behavior, then kick or ban for serious violations. This gives users a chance to correct course before permanent action.
Enable logging
Set up a private mod log channel so your team has a complete record of all moderation actions. This is critical for accountability and reviewing past decisions. See the Logging System docs to get started.
Related Commands
/softbanmoderationRequires modBan and immediately unban a user to delete their messages
/banmoderationRequires modBan a user from the server
/reasonmoderationRequires modEdit the reason for a punishment case
/unmutemoderationRequires modUnmute a user (remove timeout)
/hackbanmoderationRequires modBan a user by ID who isn't in the server
/unbanmoderationRequires modUnban a user from the server
/mutemoderationRequires modMute a user (mute role or timeout)
/lockmoderationRequires modLock or unlock a channel
/kickmoderationRequires modKick a user from the server
/renamechannelmoderationRequires modRename a channel
/warnmoderationRequires modWarn a user
/purgemoderationRequires modBulk delete messages from a channel