Syntax

[the] (emoji|emote|reaction)[s] %texts% [(in|from) [the] [guild] %types.guild%]

Description

An emoji from its name, its unicode character or the id of a custom one (an emote). Several texts give several emojis. Each text is resolved in this order: a custom emoji id or its '<:name:id>' / '<a:name:id>' form, a unicode emoji ('😂'), then a name. With a guild, a name first looks for a custom emoji of that guild (case-insensitive), then for a Discord shortcode ('joy' or ':joy:', skin tones as 'thumbsup_tone2'). Without a guild, the shortcode comes first, then the custom emojis every loaded bot can see. It reads the cache. With 'await', an id or a name missing from the cache is also looked up on Discord: in the guild when one is given, else among the bot's application emojis. A text that matches nothing is a readable error and is skipped. Name the guild when two guilds may hold a custom emoji with the same name.

Examples

react to event-message with emoji "joy"
set {_reactions::*} to reactions (":sparkles:" and "thumbsup_tone2")
react to event-message with {_reactions::*}
set {_emote} to emote "disky" in event-guild
await set {_app} to emoji "123456789012345678"