Moderation Overview
Nevi's moderation toolkit: banning, kicking, muting, warnings, message purging, channel locking, and audit logging.
What you can do
Nevi provides moderation tools to keep your server safe without needing multiple bots. Every action is logged with a case ID, and your moderators get the tools they need without over-reaching.
Ban & Kick
Permanently ban or remove users, including hackban and softban.
Mute
Silence a user for a set duration using Discord's timeout feature.
Warn
Issue tracked warnings stored in the moderation log.
Purge
Bulk-delete messages with optional user filtering.
Lock
Instantly lock a channel to prevent messages.
Nickname & Unhoist
Force-change a user's nickname or remove special characters used to appear at the top of the member list.
Quarantine
Restrict a user's permissions while you investigate an issue.
Voicekick
Disconnect a user from a voice channel without banning them.
Find & Lookup
Search for users and view detailed information about accounts.
Rename
Change a channel name from chat.
Auto-Moderation
Filter words, detect spam, and escalate punishments automatically.
Permission requirements
Nevi uses a permission level system to control who can run which commands. Moderation commands are restricted to users who meet a minimum permission level.
| Command | Minimum Level |
|---|---|
ban / unban / hackban / softban | Mod |
kick / voicekick | Mod |
mute / unmute | Mod |
warn | Mod |
purge | Mod |
lock | Mod |
nick / unhoist | Mod |
quarantine | Mod |
reason | Mod |
find / lookup | Mod |
filter | Admin |
automod | Admin |
verification | Admin |
To learn how permission levels work and how to assign them, see the Understanding Permissions guide.
Moderation logging
Every moderation action Nevi takes can be logged to a dedicated channel in your server. This gives you a full audit trail of who did what and when.
Each log entry includes the moderator who performed the action, the target user, the reason (if provided), and a case ID you can reference later with the /reason command.
To set up moderation logging, head over to the Logging System docs.
Setup checklist
Set up a modrole
Use /config set modrole @YourModRole to assign a role as your moderation role. Anyone with this role will have Mod-level permissions in Nevi, even without Discord's built-in permissions.
Enable DM notifications
Run /config set dmPunishments true so that users receive a DM when they are punished. This tells them why they were banned, kicked, muted, or warned, which reduces confusion and repeat offenses.
Enable logging
Set up a private mod log channel so your team has a complete history of all actions taken. This is invaluable for accountability and reviewing past decisions.
Provide reasons
Every moderation command accepts a reason parameter. Use it. Reasons appear in Discord's audit log, Nevi's moderation log, and in DM notifications to the user.
Related Commands
/filtermanagementRequires modManage the word filter for this server
/softbanmoderationRequires modBan and immediately unban a user to delete their messages
/quarantinemoderationRequires modQuarantine users to restrict them to a single channel
/voicekickmoderationRequires modDisconnect all members from a voice channel
/banmoderationRequires modBan a user from the server
/nickmoderationRequires modChange or clear a user's nickname
/findmoderationRequires modSearch for members by name or ID
/hackbanmoderationRequires modBan a user by ID who isn't in the server
/unhoistmoderationRequires modRemove hoisting characters from member names
/mutemoderationRequires modMute a user (mute role or timeout)
/lookupmoderationRequires modView moderation history and info for a user
/lockmoderationRequires modLock or unlock a channel
/kickmoderationRequires modKick a user from the server
/warnmoderationRequires modWarn a user
/purgemoderationRequires modBulk delete messages from a channel