Moderation & safety
The everyday toolkit: warnings, notes, timeouts, removals, bulk purge and raid response. Every command is a Discord slash command, works in any channel, and writes to your log channel for an audit trail.
Who can run these: the server owner, a matching staff role, or the equivalent Discord permission. The bot checks the specific capability (e.g. warn, ban) before acting, and refuses if you’re missing it.
Command tags:
FREE available on every plan · ADMIN requires a staff role or permission · AI uses AI tokens
Warnings & notes
Warnings are on the record and the member is told; notes are private staff context the member never sees. Both are numbered, so you can refer back to or remove individual entries later.
Issue a warning to a member. It's logged with a number, the member is notified, and it feeds the punishment ladder and threat signals.
| Argument | Type | Notes |
|---|---|---|
user required | member | The user to warn. |
reason required | text | Reason for the warning. |
Look up a member's warning history. The reply is private to you (ephemeral).
| Argument | Type | Notes |
|---|---|---|
user required | member | The user to look up. |
Add a private staff note to a member. Notes are for your team only, the member is never told.
| Argument | Type | Notes |
|---|---|---|
user required | member | The user the note is about. |
text required | text | The note to record. |
View the private staff notes on a member. The reply is private to you.
| Argument | Type | Notes |
|---|---|---|
user required | member | The user to look up. |
Tidying up: /manage-warnings & /manage-notes
These open a private panel with a dropdown of the member’s warnings (or notes). Tick the ones to remove and the list updates in place.
View and remove a member's warnings from a private dropdown panel. Needs the warning capability.
| Argument | Type | Notes |
|---|---|---|
user required | member | The user to manage warnings for. |
View and remove staff notes on a member from a private dropdown panel. Needs the notes capability.
| Argument | Type | Notes |
|---|---|---|
user required | member | The user to manage notes for. |
Pick what to remove. The dropdown lists each warning with its number, reason and who issued it. It's a multi-select, so you can clear several at once.
The list updates in place. The selected warnings are gone and the total drops. Once a member has no warnings left the dropdown simply shows (no warnings) and goes quiet. /manage-notes works exactly the same way for notes.
Quick actions
The lighter touch: calm a channel, cool someone down, change a nickname or hand out a role. None of these remove anyone.
Time a member out for a set number of minutes, they can't talk or react until it lifts.
| Argument | Type | Notes |
|---|---|---|
user required | member | User to mute. |
minutes required | number | Duration in minutes (1 to 40320, i.e. up to 28 days). |
reason optional | text | Optional reason for the log. |
Lift a member's timeout early.
| Argument | Type | Notes |
|---|---|---|
user required | member | User to unmute. |
Set how long members must wait between messages in a channel, great for slowing a busy chat.
| Argument | Type | Notes |
|---|---|---|
seconds required | number | Seconds between messages (0 to disable, max 21600). |
channel optional | channel | Which channel, defaults to the one you're in. |
Stop (or restore) @everyone being able to send messages in a single channel. Use it to pause a heated thread, then reopen it.
| Argument | Type | Notes |
|---|---|---|
channel optional | channel | Which channel to lock or unlock, defaults to the one you're in. |
Change a member's nickname, or leave it blank to reset them to their username.
| Argument | Type | Notes |
|---|---|---|
user required | member | The member to rename. |
nickname optional | text | The new nickname, leave blank to reset. |
Add or remove a role from a member. The bot enforces your role hierarchy, it won't touch managed roles, @everyone, or anything above its own (or your) top role.
| Argument | Type | Notes |
|---|---|---|
action required | choice | add or remove. |
user required | member | The member to update. |
role required | role | The role to add or remove. |
Removals
When a warning won’t cut it: a kick, a temporary or permanent ban, or a soft-ban that clears recent messages but lets the person rejoin. Every removal is logged with a one-tap reversal where it makes sense.
Remove a member from the server. They can rejoin with a fresh invite, it's the lightest removal.
| Argument | Type | Notes |
|---|---|---|
user required | member | User to kick. |
reason optional | text | Optional reason for the log. |
Permanently ban a user, and you can optionally wipe their recent messages. Works even on someone who has already left.
| Argument | Type | Notes |
|---|---|---|
user required | user | User to ban (works even if they've already left). |
reason optional | text | Optional reason for the log. |
delete_days optional | number | Days of their messages to delete (0 to 7). Defaults to 0. |
Lift a ban by the user's ID.
| Argument | Type | Notes |
|---|---|---|
user_id required | text | The banned user's numeric ID. |
reason optional | text | Optional reason for the log. |
Ban then immediately unban, a quick way to clear a member's recent messages and boot them while still letting them rejoin.
| Argument | Type | Notes |
|---|---|---|
user required | user | User to soft-ban. |
reason optional | text | Optional reason for the log. |
Ban a user for a set time, then auto-unban them. The timer survives a bot restart.
| Argument | Type | Notes |
|---|---|---|
user required | user | User to ban. |
duration required | text | How long, e.g. 30m, 2h, 7d, 1w (1m to 28d). |
reason optional | text | Optional reason for the log. |
delete_days optional | number | Days of their messages to delete (0 to 7). Defaults to 0. |
Bulk & raid response
The heavy machinery: clear a flood of messages, lock every channel at once, and shut the door on ban-evading alts, plus the alert the bot raises on its own when it spots a raid.
Bulk-delete recent messages. In Smart mode the AI reads the messages and removes only the problematic ones, after showing you a preview to confirm.
| Argument | Type | Notes |
|---|---|---|
count required | number | How many recent messages to scan or delete (1 to 200). |
user optional | member | Only delete this member's messages. |
mode optional | choice | All recent messages (default) or Smart, AI removes only the problematic ones. The AI tag applies to Smart mode only. |
Smart purge: preview before anything is deleted
Run /purge with mode: Smart and the AI reads the recent messages, decides
which to keep and which to remove, and shows you a preview first. Nothing is
deleted until you press the button; removed messages are archived to your log
channel for review.
Smart mode. The AI scans the last 50 messages and classifies each as keep or remove, it never deletes blindly.
Review, then choose. The preview lists who'd be removed and why. Only the person who ran the command can confirm. Cancel leaves everything untouched.
Done. The flagged messages are gone, the rest are untouched, and a copy of everything removed is saved to your log channel so you can double-check the AI's call.
Lock or unlock every channel at once, your fastest raid response. start shuts everything and remembers the prior permissions; end restores them exactly.
| Argument | Type | Notes |
|---|---|---|
action required | choice | start = lock all channels, end = restore prior permissions. |
reason optional | text | Optional reason for the log. |
Repeat-offender detection. When it's on, likely ban-evading alts are flagged, or auto-banned when the match is confident, the moment they join. Only an admin or the owner can change this.
| Argument | Type | Notes |
|---|---|---|
mode required | choice | on, off or status. |
When the bot spots a raid
If a burst of accounts joins in a short window, Server Assistant raises a raid alert in your log channel, pings the owner, and hands you two buttons: lock everything down on the spot, or dismiss it as a false alarm.
Lock down runs a full /lockdown (every channel shut,
prior permissions saved); lift it later with /lockdown end.
Dismiss clears a false alarm. Either button needs the lock
capability or Manage Channels. The join threshold and time window are
configurable per server.
See also
- The
/setupwizard: configure channels, staff roles and anti-raid in about a minute - Settings: AutoMod, the punishment ladder and per-feature panels
- SAi & AI features: how AI features like Smart purge are tiered and metered
- Back to the Wiki hub