SudoBot provides a comprehensive set of moderation commands that let you take action against members, manage channels, and keep a detailed record of infractions. Every moderation action that creates a punishment also records an infraction automatically, giving you a full audit trail.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/onesoft-sudo/sudobot/llms.txt
Use this file to discover all available pages before exploring further.
Ban and unban
ban
Bans a member from the server. Accepts an optional duration (for temp-bans) and an optional reason. Also accepts a user ID to ban someone not currently in the server.
unban
Removes an existing ban by user ID or username. Records an unban infraction for the audit log.
massban
Bans multiple users at once. Accepts a space-separated list of user IDs. Useful for cleaning up after a raid.
fakeban
Sends a ban notification to the target user without actually banning them. Useful for testing DM delivery.
Mute and unmute
mute
Applies a Discord timeout to a member for a specified duration. Accepts an optional reason.
unmute
Removes an active timeout from a member before it expires naturally.
Kick
kick
Removes a member from the server without banning them. The member can rejoin with a new invite.
masskick
Kicks multiple members at once by providing a space-separated list of user IDs or mentions.
Warn and note
warn
Issues a formal warning to a member and records an infraction. Optionally sends the user a DM.
note
Adds a moderator-only note to a user’s infraction record without notifying the user.
Channel management
lock
Locks a channel by removing the
Send Messages permission for the default role. Accepts an optional reason.unlock
Restores the
Send Messages permission on a previously locked channel.lockall
Locks all channels in the server simultaneously. Use during active raids or emergencies.
unlockall
Unlocks all channels that were locked with
lockall.Message management
clear
Bulk-deletes messages in a channel. Accepts a count, and optionally a user filter to delete only that user’s messages.
clearreactions
Removes all reactions from a specific message by its ID.
snipe
Retrieves the most recently deleted message in the current channel.
Messaging utilities
echo
Sends a message as the bot in the current or a specified channel.
send
Sends a direct message to a specified user from the bot.
sendreply
Sends a message as a reply to a specified message ID.
editmessage
Edits a message previously sent by the bot.
modmessage
Sends a moderation-related DM to a user with a standardized format.
Role management
role
Adds or removes a role from a member. Accepts
add and remove subcommands.Infraction management
All infraction commands are subcommands of the maininfraction command (aliases: inf, infs, infractions).
| Subcommand | Description |
|---|---|
infraction create | Manually creates an infraction record for a user without taking a moderation action. |
infraction view <id> | Shows the full details of a single infraction by its numeric ID. |
infraction list <user> | Lists all infractions for a given user. Alias: infraction ls. |
infraction delete <id> | Permanently removes an infraction from the database. Alias: infraction d. |
infraction reason <id> <reason> | Updates the reason text on an existing infraction. |
infraction duration <id> <duration> | Updates the recorded duration of a timed infraction. |
infraction clear <user> | Deletes all infractions for a given user. |
infraction attachment <id> | Views a file attachment associated with an infraction. |
Miscellaneous staff tools
bean
A joke command that “beans” a user. Records a bean infraction with no real punishment.
shot
Issues a “shot” to a user. Similar to
bean — a novelty infraction type.modstats
Displays moderation statistics for the server or a specific moderator.
dmhistory
Shows the recent DM history that the bot has sent to a user.
sendhistory
Shows a history of messages sent via the
send and sendreply commands.reportmessage
Context menu command that lets users report a message to the moderation team.
savemessage
Saves the content of a message to the bot’s storage for later reference.
Commands that perform punishments (ban, kick, mute, warn) automatically create infractions. You do not need to run
infraction create separately after using these commands.