NadekoBot/docs/Custom Reactions.md

##Custom Reactions

Every time you add or remove a custom reaction you will need to restart your bot with either .restart if you are hosting or Nadeko is on VPS, or .die if Nadeko is on Droplet

Important

• .acr, .dcr, and .ecr Require you to be Bot Owner
• Adding multiple commands of the same name will make Nadeko randomly select one of the command's responses

###Commands and Their Use

Command Name	Description	Example
.acr	Adds a Custom Reaction	.acr Hello Hi!
.dcr	Deletes an entire Custom Reaction or a Specified Response Index Number	.dcr "command name" or .dcr "command name" 3
.lcr	Lists a specified page of Custom Commands	.lcr Number i.e .lcr 2
.scr	Shows all responses to a command. Index Number will be in brackets [ ]	.scr Hello
.ecr	Edit a custom reaction, needs: reaction's name, index to change, and new multiword response.	.ecr Hello 3 What's up

Now that we know the commands let's take a look at the arguments and placeholders available for .acr,

.addcustreact (.acr) takes two arguments:

● First, The name of the command; this directly follows the .acr

- If your command name is more than 1 word use quotation marks;
i.e .acr Nice weather sure is > .acr "Nice weather" sure is

- Now everytime someone says "Nice weather" the bot will respond with, "sure is"

● Next, The Response, this follows the name of the command.

- i.e .acr "Nice weather"sure is

###And finally on to the Placeholders

There are currently four placeholders, which we will be looking at, with many more to come in the future.

Placeholder	How the placeholder works	Examples
%mention%	The %mention% placeholder is triggered when you type @botname	.acr "%mention% Hello" Hello! > User input: @botname Hello | Bot Replies: Hello!
%target%	The %target% placeholder is used to make Nadeko Mention another person	.acr "%mention% Hello" %target% Hi! > User inputs: "@botname Hello @somebody" Bot replies: "Hi @somebody"
%user%	The %user% placeholder mentions the person who said the command	.acr "Who am i" You are %user%!
%rng%	The %rng% generates a random number	.acr Random %rng%

Thanks to Nekai for being creative. <3