Permanently bans a user from the server. Optional message-history purge between 0 and 7 days. Discord requires the bot to have the **Ban Members** permission and the executor to have a higher role than the target.
/kick
Kick Members
Argsuser: User, reason: String (optional)
/kick @troll Reason: Disruptive behaviour
Kicks the user from the server. They can rejoin with a valid invite.
Timeouts (Discord's native *Moderate Members* feature). Maximum duration is 28 days. The command accepts human-readable strings: `30s`, `10m`, `2h`, `1d`.
/unmute
Moderate Members
Argsuser: User, reason: String (optional)
/unmute @user
Removes an active timeout from a user.
/warn
Manage Messages
Argsuser: User, reason: String
/warn @user reason:Inappropriate language
Adds a warning to a user's moderation record. Warnings are visible to staff in the dashboard under **Moderation → Log**.
/warnings
Manage Messages
Argsuser: User
/warnings @user
Lists all warnings for the given user, including the moderator, reason and timestamp.
/clear-warnings
Manage Messages
Argsuser: User
/clear-warnings @user
Removes every warning from a user's record. The action is logged.
/purge
Manage Messages
Argsamount: Integer (1-100), user: User (optional)
/purge amount:50 user:@spammer
Bulk-deletes messages. Defaults to the last 100 messages in the current channel. If `user` is provided, only messages authored by that user are deleted.
/slowmode
Manage Channels
Argsseconds: Integer (0-21600)
/slowmode seconds:5
Sets the channel slow-mode in seconds. `0` disables it.
/lock
Manage Channels
Argschannel: Channel (optional, defaults to current)
/lock
Locks a channel by removing the `@everyone` *Send Messages* permission. The bot records the previous state so `/unlock` restores it.
/unlock
Manage Channels
Argschannel: Channel (optional)
/unlock
Restores the channel's previous *Send Messages* permission for `@everyone`.
Utility
/userinfo
None
Argsuser: User (optional)
/userinfo user:@member
Shows account age, join date, roles, highest role and warning count for a user.
/serverinfo
None
Args—
/serverinfo
Displays server stats: member count, online count, channel breakdown, boost level, creation date and verification level.
/avatar
None
Argsuser: User (optional)
/avatar @user
Sends the user's global and server avatar at full resolution with a download link.
/roleinfo
None
Argsrole: Role
/roleinfo role:@Member
Displays member count, colour, hoist status, mentionable state and position of a role.
/channelinfo
None
Argschannel: Channel (optional)
/channelinfo
Lists channel ID, type, topic, position, slow-mode and NSFW setting.
/invites
None
Argsuser: User (optional)
/invites @user
Shows how many members a user has invited, the valid invite codes they used and how many are still redeemable.
/ping
None
Args—
/ping
Returns the bot's gateway and REST latency in milliseconds.
Levels
/rank
None
Argsuser: User (optional)
/rank
Shows the user's current level, XP, progress to the next level and server rank.
/leaderboard
None
Argsscope: Choice (server | global)
/leaderboard scope:global
Top 10 users by XP. `scope:global` aggregates XP across every server using Donut Bot.
/setxp
Administrator
Argsuser: User, amount: Integer
/setxp @user amount:5000
Sets a user's XP to an exact value. Useful for corrections or events.
/addxp
Administrator
Argsuser: User, amount: Integer
/addxp @user amount:500
Adds XP to a user without overwriting their existing total.
/resetlevel
Administrator
Argsuser: User
/resetlevel @user
Resets a user's XP and level for the current server.
