Custom Reactions

The Custom Reactions module enables users to set up custom bot reactions and build pseudo-commands in a server.

!togglecustreact

Command Syntax

!tcr

Command Description

Toggles the custom reactions module on the whole Discord server.


!addcustreact

Command Syntax

!acr (--in {trigger text}) (--out {response text}) [--anywhere] [--dm] [--delete] [--global]

Command Description

Adds a new custom reaction for the current server.

Optional Parameters:

  • anywhere: Triggers the reaction based on a text that appears anywhere in a message, instead of starting with the trigger text. Default: off.

  • dm: Sends the response text via DM instead of using the current channel. Default: off.

  • delete: Deletes the original message after a reaction is triggered. Default: off.

  • global: Bot Owner. Makes the custom reaction global, hence triggering in any server the bot is. Default: off.

You can use one (or more) of these placeholders in your response message:

  • %user%: This will be replaced with a mention of the user.

  • %username%: This will be replaced with the username of the user, without the discriminator (e.g. cycloptux).

  • %fullusername%: This will be replaced with the username of the user, including the discriminator (e.g. cycloptux#1543).

  • %bot%: This will be replaced with a mention of the bot.

  • %botname%: This will be replaced with the username of the bot, without the discriminator.

  • %fullbotname%: This will be replaced with the username of the bot, including the discriminator.

  • %server%: This will be replaced with the server name.

  • %channel%: This will be replaced with the channel name.

  • %now%: This will be replaced with the current time, with format YYYY-MM-DD HH:mm:ss (UTC).

  • %server_time%: This will be replaced with the current time, with format HH:mm UTC.

  • %target%: This will be replaced with anything the user wrote after the trigger.

You can use embed json from https://eb.nadeko.bot/ instead of a regular text in the response parameter, if you want the message to be embedded.

Examples

!acr --in what time is it --out Hello %user%! The current time is %now%. --anywhere

!editcustreact

Command Syntax

!ecr (reaction id) [--in {trigger text}] [--out {response text}] [--anywhere] [--dm] [--delete] [--global]

Command Description

Edits an existing custom reaction for the current server. Global custom reactions can only be edited by the bot owner.

The presence of an optional parameter will toggle the option to the opposite of what it was before the edit. --global, on the other hand, will need to be added or removed accordingly, depending on the scope of the reaction.

Examples

!ecr 1 --out Hello %user%! The current time is %server_time%.  --delete

!showcustreact

Command Syntax

!scr (reaction id)

Command Description

Prints the current configuration for a specific custom reaction. It will also preview how the reaction is printed when triggered in a server (placeholders will not be replaced in this preview).

Examples

!scr 3

!listcustreact

Command Syntax

!lcr [--global] [--in {text}]

Command Description

Lists all available custom reactions in the current server. Using the --global argument will show the list of global reactions.

Using the --in parameter will filter on reactions that are triggered by the text used within that argument.


!delcustreact

Command Syntax

!dcr (reaction id)

Command Description

Deletes a specific custom reaction. Global custom reactions can only be deleted by the bot owner.

Examples

!dcr 3

!crclear

Command Description

Deletes all server specific custom reactions. Global custom reactions can only be deleted by the bot owner.