Entity Info
userReacted
$userReacted
The $userReacted function checks if a user has reacted with a specific emoji on a given message.
Syntax
$userReacted[channelID;messageID;userID;emoji]
Parameters
| Parameter | Description |
|---|---|
channelID |
Required. The ID of the channel containing the message. |
messageID |
Required. The ID of the message on which to check the reaction. |
userID |
Required. The ID of the user to check (digits only, greater than 0). Otherwise Invalid user ID. is raised. |
emoji |
Required. The emoji to check: a Unicode emoji, a custom emoji in <:name:ID> / <a:name:ID> form, a custom emoji ID, or a BDFD alias such as :name:. An empty or invalid emoji raises an error. |
All four arguments are required; fewer or more is refused (“Invalid argument count”).
Return Value
- Type: String (boolean)
trueif the user is among the users who reacted with the specified emoji.falseotherwise.
Behavior
- Retrieves the list of users who reacted with the given emoji on the message and looks for
userIDin it. - The channel and message IDs must be valid IDs.
- The message must be accessible to the bot.
Examples
Check a reaction on the current message
$if[$userReacted[$channelID;$messageID;$authorID;✅]==true]
$sendMessage[You reacted with ✅.]
$else
$sendMessage[You have not reacted with ✅.]
$endif
Condition for a giveaway
$if[$userReacted[$channelID;$messageID;$authorID;🎉]==true]
$sendMessage[✅ You are participating in the giveaway!]
$else
$sendMessage[❌ You must react with 🎉 to participate.]
$endif
Notes
- For custom emojis, use the
<:name:ID>(or<a:name:ID>) format, or the emoji ID.
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.