Syntax

$kick[userID;(reason)]

userID is the target’s Discord ID; reason is optional (an empty reason sends no audit-log reason; a reason longer than 512 characters raises an error). The argument-free form $kick targets the command author. An explicitly empty target does not target the author: it fails with Missing or invalid user ID..

Examples

Prefix command example

Configure a prefix command named kick. For !kick @member, $mentioned[1;no] selects the first mentioned user. A raw ID typed without a mention is not a mention.

$nomention
$onlyPerms[kickmembers;You need Kick Members permission.]
$onlyBotPerms[kickmembers;The bot needs Kick Members permission.]
$var[target;$mentioned[1;no]]
$onlyIf[$var[target]!=;Usage: !kick @member]
$onlyIf[$var[target]!=$authorID;You cannot kick yourself.]
$onlyIf[$var[target]!=$serverOwner;The server owner cannot be kicked.]
$kick[$var[target];Rules violation]
Member kicked successfully.

Replace the fixed reason with a value chosen by your command. For a slash command, use its configured user option instead of $mentioned[1;no].

Explicit ID

Replace the sample ID with a real member ID before running this example.

$onlyPerms[kickmembers;You need Kick Members permission.]
$kick[123456789012345678;Rules violation]
Member kicked successfully.

The function returns no text. An invalid target ID raises Missing or invalid user ID.. The bot is refused (error) when it lacks Kick Members, when the target is the server owner, or when the target’s highest role is equal to or above the bot’s.

In a slash command, $message[member] (a user option) is the member’s ID and can be passed directly: $kick[$message[member];$message[reason]]. See $message. An empty ID is never replaced by the author or by another argument; it fails with Missing or invalid user ID..