Ban¶
The ban command allows server moderators to permanently remove members from the server. Banned members cannot rejoin the server unless they are explicitly unbanned. This command is intended for severe rule violations or users who are no longer welcome in the community.
When a user is banned, Tux can optionally delete their recent message history from the server, helping to quickly clean up spam or offensive content. By default, the bot will attempt to DM the user with the reason for their ban before executing the action.
Syntax¶
The ban command can be used in two ways:
Slash Command:
/ban member:@user [reason:STRING] [purge:0-7] [silent:true/false]
Prefix Command:
$ban @user [reason] [-purge X] [-silent]
Aliases:
b
Parameters¶
| Parameter | Type | Required | Description |
|---|---|---|---|
member |
Member/User | Yes | The member or user ID to ban from the server. |
Flags¶
This command supports the following flags:
| Flag | Type | Default | Description |
|---|---|---|---|
reason |
String | No reason provided | The reason for the ban (positional). |
-purge |
Integer (0-7) | 0 | Number of days of message history to delete. |
-silent |
Boolean | False | If true, Tux will not attempt to DM the user. |
reason¶
The reason for the ban. In the prefix command, this is a positional flag, meaning you can type it after the member mention without a flag name. In slash commands, it is a standard argument.
- Type: String
- Default: "No reason provided"
- Examples:
Spamming,Violation of Rule 1
-purge¶
The number of days of message history to delete for the banned user. Discord allows a maximum of 7 days.
- Type: Integer
- Range: 0 to 7
- Default: 0
- Aliases:
-p
-silent¶
Whether to suppress the DM notification to the banned user.
- Type: Boolean
- Default: False
- Aliases:
-s,-quiet
Permissions¶
Bot Permissions¶
Tux requires the following permissions to execute this command:
- Ban Members - Required to perform the ban action on Discord.
User Permissions¶
Users need appropriate moderation permissions to use this command.
Permission System
Command permissions are configured per-guild using Tux's dynamic permission system. Configure via /config commands or see the Permission Configuration guide.
Usage Examples¶
Basic Usage¶
Banning a user with no specified reason or message purge.
/ban member:@user reason:"Unspecified violation"
With Reason (Slash)¶
/ban member:@user reason:"Repeated harassment"
With Reason (Prefix)¶
$ban @user Repeated harassment after multiple warnings
With Message Purge¶
Banning a user and deleting their last 3 days of messages.
/ban member:@user reason:"Spam bot cleanup" purge:3
Silent Ban¶
Banning a user without sending a DM notification to them.
$ban @user -silent Severe rule breakage
Response¶
When executed successfully, Tux will:
- Attempt to DM the user with the ban reason (unless
-silentis used). - Execute the ban on the Discord server.
- Create a new moderation case in the database.
- Post a confirmation message in the current channel.
- Log the action in the designated moderation log channel.
Error Handling¶
Common Errors¶
Error: Missing Permissions / Higher Role¶
When it occurs: Tux lacks the "Ban Members" permission, or the target user's highest role is equal to or higher than Tux's highest role.
Solution: Ensure Tux has the "Ban Members" permission in its role settings. Move the "Tux" role above the role of the person you are trying to ban in the server hierarchy.
Error: Lacking Permission Rank¶
When it occurs: Your internal Tux permission rank is lower than the rank required to use the ban command in this server.
Solution: Contact a server administrator to check your current rank or adjust the command configurations via /config commands.
Error: User Not Found¶
When it occurs: The provided mention or ID does not resolve to a valid Discord user.
Solution: Double-check the ID (ensure it is a 17-19 digit Snowflake) or mention the user directly.