đź“š Commands Reference

Server Assistant supports three interaction modes. Most commands are available in all three:

  1. Text commands in the configured staff-chat (warn @user)
  2. Slash commands anywhere (/warn)
  3. Right-click context menus on users and messages

Most commands are role-gated. If a command isn’t listed for your tier, you don’t have permission. Run help (text) or /help (slash) to see what’s available to you specifically.

🛡️ Moderation

Targeting users supports @mention, plain-text username (e.g. mute jen), or numeric Discord user ID.

Command Description Example
ban @user [reason] Ban a user ban @spammer raid
kick @user [reason] Kick a user kick username spam
softban @user Ban + immediate unban — clears recent messages, lets user rejoin softban @user
mute @user 30 min Timeout a user. Supports min / hour units mute @user 2 hr
unmute @user Remove a user’s timeout unmute @user
warn @user reason Issue a tracked warning. DMs the user. warn @user posting NSFW
warnings @user View a user’s warning history warnings @user
unwarn @user [id] Remove a warning. Without ID, removes the latest unwarn @user 3
nick @user new-name Change a user’s nickname nick @user Helper
nick reset @user Reset a user’s nickname nick reset @user

Bulk operations: mention a role to apply the action to everyone in it. Examples: mute @TrollRole 1 hour, ban @SpamRole. Mod-tier maxes at 5 users; Admin/Owner have higher limits.

đź“ť Notes (private staff-only)

Notes are invisible to the user. Used for tracking patterns of behaviour without an official warning.

Command Description
note @user text Add a private note
notes @user View notes on a user
delnote @user 3 Remove note #3

đź“Š Information

Command Description
info @user Profile, roles, joined date, warning + note count
history @user 15 Last 15 messages from this user across all channels
stats Server statistics — members, channels, boosts, etc.
actions 10 Recent staff actions audit log
report @user AI-generated context summary of recent activity
report #channel AI summary of recent activity in a channel

đź“‚ Channel management

Command Description
lock #channel Block @everyone from sending messages
unlock #channel Restore send permission
slowmode 5s Set channel slowmode (supports s/m/h)
slowmode off Disable slowmode
pin (reply to a message) Pin the replied-to message
unpin (reply to a message) Unpin the replied-to message
purge 50 Delete last 50 messages
purge since 1pm Time-based — uses your personal timezone
purge 30 minutes ago Relative time
purge since [discord-link] Delete everything after a specific message
delete #channel Delete a channel (Owner instant; Admin needs âś… approval)
create channel name Create a new text channel
rename #old new-name Rename a channel

Discord only allows bulk delete of messages newer than 14 days. The bot warns you and adjusts the cutoff automatically.

đź’¬ Communication

Command Description
say <text> Bot speaks in the current channel
dm @user <text> Send a private message to a user
send to #channel <text> Bot posts in another channel
snippet <name> [@user] Post a saved canned response. Placeholders auto-fill if a user is mentioned
snippet add <name> <text> Save a new canned response
snippet list List all saved snippets
snippet remove <name> Delete a saved snippet

Placeholders for snippets and onboarding messages

Token Replaced with
[user] User’s tag (e.g. Coding#0001)
[userid] User ID
[username] Username only
[usermention] @mention of the user
[usercreatedat] When their account was created
[userjoinedat] When they joined the server
[servername] Server name
[membercount] Total members
[owner] Owner’s @mention
[ownerid] Owner’s user ID

Both [brackets] and {braces} syntax work, case-insensitive.

đź“… Scheduling

Command Description
schedule in 30 min: <task> Schedule a one-shot reminder
remind in 2 hours: <task> Alias for schedule
schedule at 9am: <task> Specific local time today (uses your timezone)
schedule tomorrow at 9am: <task> Tomorrow’s local time
scheduled list View your pending tasks
scheduled cancel 3 Cancel task #3

↩️ Undo (24h window)

The undo command reverses your most recent reversible action.

Reversible: bans → unban · mutes → remove timeout · channel deletes → recreate with original settings · nickname changes → restore previous

Command Description
undo Reverse your last reversible action (within 24h)

⚠️ Channel undo recreates the channel with original name, topic, NSFW, slowmode, category, and all permission overwrites — but messages and threads cannot be recovered. Discord doesn’t preserve them.

⚙️ Personal settings

Command Description
timezone Australia/Sydney Set your personal timezone (used by /schedule and purge since 1pm)
timezone AEST Common abbreviations work too
timezone View your current timezone
help Interactive help

🛂 Owner / Admin only

Command Description
/setup Run the initial setup wizard (owner only)
/settings Open the customisation hub (owner / admin)
/automod Configure auto-moderation (admin and above)
/onboarding Configure new-member welcome DMs
/snippets Manage canned responses
/ai-config Configure AI provider/key (owner only)
/invite Get the bot’s invite URL

🖱️ Right-click context menus

Right-click any user or message → hover Apps ▸ Server Assistant:

On a user

On a message

💡 If “Apps ▸” looks empty, hard-refresh Discord (Ctrl+R) to pull the latest commands.

⚡ Slash command quick reference

Type / anywhere to see autocomplete:

Slash command What it does
/setup Initial config wizard (owner only)
/settings Open customisation hub
/automod Configure auto-moderation
/onboarding Configure welcome DMs
/snippets Manage canned responses
/ai-config Configure AI provider
/imagine <prompt> AI image generation
/info <user> User profile
/warn <user> <reason> Quick warn
/warnings <user> View warnings
/note <user> <text> Add note
/notes <user> View notes
/manage-warnings <user> Multi-select removal wizard
/manage-notes <user> Multi-select removal wizard
/stats Server statistics
/timezone Set personal timezone
/schedule Schedule a reminder via modal
/help Interactive button-driven help
/vote Vote for the bot on Top.gg
/invite Get the bot’s invite URL

Most slash command responses are ephemeral by default (only you see them) for sensitive operations.

What’s next?