Skip to content

Kick

The kick command allows server moderators to remove a member from the server. Unlike a ban, a kicked user is free to rejoin immediately if they have a valid invite. This command is typically used for less severe rule violations or as a firm warning to a user whose behavior needs to change.

Syntax

The kick command can be used in two ways:

Slash Command:

Text Only
/kick member:@user [reason:STRING] [silent:true/false]

Prefix Command:

Text Only
$kick @user [reason] [-silent]

Aliases:

  • k

Parameters

Parameter Type Required Description
member Member Yes The member to kick from the server.

Flags

This command supports the following flags:

Flag Type Default Description
reason String No reason provided The reason for the kick (positional).
-silent Boolean False If true, Tux will not attempt to DM the user.

reason

The reason for the kick. In the prefix command, this is a positional flag. In slash commands, it is a standard argument.

  • Type: String
  • Default: "No reason provided"
  • Examples: Inappropriate nickname, Disrupting the conversation

-silent

Whether to suppress the DM notification to the kicked user.

  • Type: Boolean
  • Default: False
  • Aliases: -s, -quiet

Permissions

Bot Permissions

Tux requires the following permissions:

  • Kick Members - Required to remove the member from the server.

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 Kick

Kicking a user with no specified reason.

Text Only
/kick member:@user

With Reason (Slash)

Text Only
/kick member:@user reason:"Disruptive behavior"

With Reason (Prefix)

Text Only
$kick @user Refusal to change inappropriate avatar

Silent Kick

Kicking a user without sending a DM notification.

Text Only
/kick member:@user reason:"Automated cleanup" silent:true

Response

When executed successfully, Tux will:

  1. Attempt to DM the user with the kick reason (unless -silent is used).
  2. Execute the kick on the Discord server.
  3. Create a new moderation case in the database.
  4. Post a confirmation message in the current channel.
  5. Log the action in the designated moderation log channel.

Error Handling

Common Errors

Error: Missing Permissions / Higher Role

When it occurs: Tux lacks the "Kick Members" permission, or the target user's highest role is equal to or higher than Tux's highest role.

Solution: Ensure Tux has the "Kick Members" permission. Move the "Tux" role above the target's role in the server hierarchy.

Error: Lacking Permission Rank

When it occurs: Your internal Tux permission rank is lower than the rank required to use this command in this server.

Solution: Contact a server administrator to check your current rank.

Error: Member Not Found

When it occurs: The provided mention or ID is invalid or they already left.

Solution: Ensure you are mentioning a valid member currently in the guild.

  • /ban - Permanently remove a member from the server.
  • /warn - Issue a formal warning without removing the user.
  • /timeout - Temporarily restrict communication.