Burger Bot’s moderation suite gives your Moderators and Admins precise control over member behaviour without ever leaving Discord. Every action is logged automatically to your configured audit log channel, so your team always has a full paper trail.
/warn
Description: Issue a formal warning to a member. Warnings are stored and can be reviewed or cleared later.
Usage: /warn <user> [reason]
Permissions: Moderator+
Parameters:
| Parameter | Type | Required | Description |
|---|
user | User mention | ✅ Yes | The member to warn. |
reason | String | ❌ No | A brief explanation for the warning. |
/warnings
Description: View the full warning history for a member, including timestamps and issuing moderators.
Usage: /warnings <user>
Permissions: Moderator+
Parameters:
| Parameter | Type | Required | Description |
|---|
user | User mention | ✅ Yes | The member whose warnings you want to review. |
/clearwarn
Description: Clear one or all warnings from a member’s record. Omit warn_id to clear all warnings.
Usage: /clearwarn <user> [warn_id]
Permissions: Admin+
Parameters:
| Parameter | Type | Required | Description |
|---|
user | User mention | ✅ Yes | The member whose warnings you want to clear. |
warn_id | String | ❌ No | The ID of a specific warning to remove. Leave blank to clear all. |
/timeout
Description: Apply a Discord timeout to a member, temporarily revoking their ability to send messages or join voice channels.
Usage: /timeout <user> <duration> [reason]
Permissions: Moderator+
Parameters:
| Parameter | Type | Required | Description |
|---|
user | User mention | ✅ Yes | The member to time out. |
duration | Choice | ✅ Yes | Timeout length: 10m, 1h, 1d, or 7d. |
reason | String | ❌ No | A brief explanation for the timeout. |
/untimeout
Description: Immediately remove an active timeout from a member, restoring their ability to interact in the server.
Usage: /untimeout <user> [reason]
Permissions: Moderator+
Parameters:
| Parameter | Type | Required | Description |
|---|
user | User mention | ✅ Yes | The member whose timeout you want to remove. |
reason | String | ❌ No | A brief explanation for removing the timeout. |
/kick
Description: Remove a member from the server. They will be able to rejoin with a valid invite link.
Usage: /kick <user> [reason]
Permissions: Moderator+
Parameters:
| Parameter | Type | Required | Description |
|---|
user | User mention | ✅ Yes | The member to kick. |
reason | String | ❌ No | A brief explanation for the kick. |
/ban
Description: Permanently ban a member from the server. Optionally delete a portion of their recent message history.
Usage: /ban <user> [reason] [delete_messages]
Permissions: Admin+
Parameters:
| Parameter | Type | Required | Description |
|---|
user | User mention | ✅ Yes | The member to ban. |
reason | String | ❌ No | A brief explanation for the ban. |
delete_messages | Choice | ❌ No | How far back to delete the user’s messages (e.g. 1d, 7d). |
/unban
Description: Lift an existing ban using the target’s Discord user ID. The user must not be in the server to use this command.
Usage: /unban <user_id> [reason]
Permissions: Admin+
Parameters:
| Parameter | Type | Required | Description |
|---|
user_id | String | ✅ Yes | The Discord user ID of the banned member. |
reason | String | ❌ No | A brief explanation for lifting the ban. |
/purge
Description: Bulk-delete messages from a channel. Optionally filter by a specific user or target a different channel.
Usage: /purge <amount> [user] [channel]
Permissions: Moderator+
Parameters:
| Parameter | Type | Required | Description |
|---|
amount | Integer | ✅ Yes | Number of messages to delete (1–100). |
user | User mention | ❌ No | Only delete messages from this specific user. |
channel | Channel mention | ❌ No | Target channel. Defaults to the current channel. |
Discord restricts bulk deletion to messages under 14 days old. Messages older than this cannot be purged in bulk.
/lock
Description: Lock a channel, preventing members from sending messages. Moderators and above retain access.
Usage: /lock [channel] [reason]
Permissions: Moderator+
Parameters:
| Parameter | Type | Required | Description |
|---|
channel | Channel mention | ❌ No | The channel to lock. Defaults to the current channel. |
reason | String | ❌ No | A brief explanation for the lockdown. |
/unlock
Description: Unlock a previously locked channel, restoring standard member send permissions.
Usage: /unlock [channel] [reason]
Permissions: Moderator+
Parameters:
| Parameter | Type | Required | Description |
|---|
channel | Channel mention | ❌ No | The channel to unlock. Defaults to the current channel. |
reason | String | ❌ No | A brief explanation for restoring access. |
/slowmode
Description: Set a slowmode delay on a channel, limiting how frequently members can send messages. Set to 0 to disable.
Usage: /slowmode <seconds> [channel]
Permissions: Moderator+
Parameters:
| Parameter | Type | Required | Description |
|---|
seconds | Integer | ✅ Yes | Slowmode delay in seconds (0–21600). Set to 0 to disable. |
channel | Channel mention | ❌ No | The channel to apply slowmode to. Defaults to the current channel. |
/nickname
Description: Change or reset a member’s server nickname. Leave the nickname parameter blank to reset it to their username.
Usage: /nickname <user> [nickname]
Permissions: Moderator+
Parameters:
| Parameter | Type | Required | Description |
|---|
user | User mention | ✅ Yes | The member whose nickname you want to change. |
nickname | String | ❌ No | The new nickname. Leave blank to reset to the member’s username. |
