Entity Info
userID
$userID
The $userID function returns the Discord ID of the user of the current execution (the user who ran the command or interaction).
Syntax
$userID[(Username)]
Parameters
| Parameter | Description |
|---|---|
Username |
Optional. A username, or name#discriminator (the discriminator is checked; #0 or #0000 for an account without one). The match is case-insensitive and searches the members of the current server. If omitted or empty ($userID, $userID[]), the user of the context is used. |
Return Value
- Type: String (the Discord ID, digits only)
- Without a name: the value of the context variable
user.id; if that variable is not set, the value ofauthor.id; if neither is set, an empty string. - With a name: the ID of the first member found, or an empty string if nobody matches (no error).
Behavior
- Without a name, reads
user.idfirst and falls back toauthor.id; it does not call Discord. - With a name, lists the members of the server through Discord, which can be slow on large servers.
Examples
Display the user ID
$title[Your User ID]
$description[**ID:** `$userID`]
$color[#5865F2]
Use the ID in a condition
$if[$userID==123456789012345678]
$sendMessage[Hello administrator!]
$else
$sendMessage[Hello user!]
$endif
Find a member by name
$sendMessage[ID: $userID[$message[1]]]
Difference with $authorID
$userIDreadsuser.id, thenauthor.id.$authorIDreadsauthor.id, thenuser.id.
Both return the same value whenever only one of the two variables is set or when both hold the same user.
Notes
- Use
$userIDin comparisons with$if[]to create commands reserved for specific users.
Try it
Paste an example into the playground to preview its message (functions that act on Discord are not run), or build the same thing with blocks.