Quotes Commands for v1.0.0+

Creating an action

To create a new action head to the Actions tab and right-click in the actions section. Select Add Action and name it something like "Get Quote". This action will be used to retrieve a random quote or a specific quote by its index.

Adding the "!quote" command trigger

Next step would be adding our trigger for the command. Right-click in the Triggers section and select Core -> Commands -> Command Triggered. If you already have a command like "!quote" and want to use that, you can select it from the dropdown menu. If not, you can create a new command by clicking on the Create Command button below the dropdown.

Give the command a name like "Get Quote" and set the command itself to !quote, or anything you like. Leave the location to Start, this will allow the command to also check an input.

The other settings can be left as is, unless you want to change them. For example, you can set the Cooldown to prevent spamming the command.

Check whether input is empty or not

First we want to check whether the input, in our case the argument input0 is empty or not. If it is empty, we will retrieve a random quote, otherwise we will try to retrieve a specific quote by the input. To do this, we will use an the sub-action Core -> Logic > If/Else.

• In the Input field you would write %input0% to get the value of the input0 argument.
• The Operation would be Is Null or Empty.

After clicking OK, you will see a new If/Else block in your action. In the True group, we will retrieve a random quote, and in the False group we will try to retrieve a specific quote by its index.

Get a random quote and send the message

In the True group of the If/Else block, we will retrieve a random quote. To do this, right-click on the True Result group and add the sub-action Core -> Quotes -> Get Quote. Or you can also click on the True Result group and search for the Get Quote sub-action in the search bar.

In the sub-action itself make sure you select Random as the Type and click OK. This will retrieve a random quote from the quotes.

Next, we want to send the quote as a message. Add the sub-action Twitch -> Chat -> Send Message to Channel to the True Result group, and make sure it's under the Get Random Quote sub-action. In the Message field you can write something like %quoteId% %quote% - %quoteUser% to send the quote ID, the quote itself and the user who added the quote.

Check whether input is a number or not

In the False group of the If/Else block, we will continue down the path to retrieve a specific quote by its index.

However first we want to check whether the input is a number or not, this would still be in the False group.

This can be done the following way:

1. Add another If/Else sub-action to check whether the input0 value is a number or not.
   • Input: %input0%
   • Operation: Regex Match
   • Value: ^\d*$

The regex ^\d*$ is basically checking if the entire value of input0 only consists of digits.

In the True group, we will continue and try to retrieve the specific quote by its index.

In the False group, you can now add another sub-action to send a message to the channel that the input is not a number, or you simply leave it empty.

Get a specific quote and send the message

Since we have already checked that the input is a number, we can now retrieve the specific quote by its index. To do this we want to add the sub-action Core -> Quotes -> Get Quote, and as the Type we will select Specific. The Quote ID field will be set to %input0%, which will retrieve the value of the input0 variable.

The last thing we want to do is check whether or not a quote was able to be retrieved. This can be done by adding yet another If/Else sub-action under the Get Quote sub-action.

We want to check whether the argument quote, or other quote related arguments were even created by the Get Quote sub-action.

• Input: quote
• Operation: Does Not Exist

Why do we not add % around quote? Because we don't want the value of the quote argument, but rather check if the literal name quote exists as an argument.

• In the True group, we can add a sub-action to send a message to the channel that the quote was not found, or you can leave it empty.
• In the False group, we can add the sub-action Twitch -> Chat -> Send Message to Channel to send the quote as a message.
  • For example: #%quoteId%: %quote% - %quoteUser%

Creating an action

To create a new action head to the Actions tab and right-click in the actions section. Select Add Action and name it something like "Add Quote".

Adding the "!quoteadd" command trigger

This step is pretty much the same as the previous one for just adding a !quote command. Just in this case we give it a different name and a different command itself.

• Right-click in the Triggers section and select Core -> Commands -> Command Triggered. If you already have a command like "!quoteadd" and want to use that, you can select it from the dropdown menu. If not, you can create a new command by clicking on the Create Command button below the dropdown.

Give the command a name like "Add Quote" and set the command itself to !quoteadd, or anything you like. Leave the location to Start, this will allow the command to also check an input.

Potentially set the user group for this command to your Moderators only. Meaning select Allow, then put the Moderator group as the only one on the right side. (The import has it set to Moderators since adding the !quotedel command update.)

The other settings can be left as is, unless you want to change them. For example, you can set the Cooldown to prevent spamming the command.

Check if the rawInput of the command is empty or not

First we want to check whether the rawInput that was given is not just empty, so we don't add empty quotes. To do this, we will use the sub-action Core -> Logic -> If/Else.

• Input: %rawInput%
• Operation: Is Null or Empty

In the True group, we can then add a Break sub-action to stop the action from continuing, since the rawInput was empty. We can leave the False group empty and basically just continue after the If/Elseblock.

Adding the quote itself

Next, we want to add the quote itself. To do this, we will use the sub-action Core -> Quotes -> Add Quote.

In the Variable field, we will write %rawInput%, this will get the whole input of the command, so the value of rawInput.

Check if the quote was added successfully

After adding the quote, we want to check whether or not the quote was added successfully. This can be done by adding another If/Else sub-action.

• Input: %success%
• Operation: Equals
• Value: True

In the False group, we can then add a Break sub-action to stop the action from continuing, since the quote was not added successfully.

Below the whole If/Else block, you can also put this in the True group`, we can then add a sub-action to send a message to the channel that the quote was added successfully.

So create a sub-action Twitch -> Chat -> Send Message to Channel and write something like Quote added successfully! ID: %quoteId% - %quote% in the Message field.

Creating an action

To create a new action head to the Actions tab and right-click in the actions section. Select Add Action and name it something like "Delete Quote".

Adding the "!quotedel" command trigger

• Right-click in the Triggers section and select Core -> Commands -> Command Triggered. If you already have a command like "!quotedel" and want to use that, you can select it from the dropdown menu. If not, you can create a new command by clicking on the Create Command button below the dropdown.

Give the command a name like "Delete Quote" and set the command itself to !quotedel, or anything you like. Leave the location to Start, this will allow the command to also check an input.

Potentially set the user group for this command to your Moderators only. Meaning select Allow, then put the Moderator group as the only one on the right side. The other settings can be left as is, unless you want to change them.

Check whether input is empty or not

First we want to check whether the input, in our case the argument input0 is empty or not. If it is empty, we will retrieve a random quote, otherwise we will try to retrieve a specific quote by the input. To do this, we will use an the sub-action Core -> Logic > If/Else.

• In the Input field you would write %input0% to get the value of the input0 argument.
• The Operation would be Is Null or Empty.

After clicking OK, you will see a new If/Else block in your action. In the True group, we send a message that there needs to be an number input.

In the False group we will try to delete a specific quote by its index.

Delete Quote

In the False group of the If/Else block, we will try and delete the quote by the value of input0.

Add the sub-action Core -> Quotes > Delete Quote and write %input0% in the field. We don't need to check whether the value of input0 is a number or not as the Delete Quote just checks if the input is an existing id and if not it will not be able to delete the id.

You can add a check like in the Get Quote action if you want but not directly necessary.

Check whether the quote was actually deleted by the input

Now we want to check whether a quote was successfully deleted or not.

This can be done the following way:

1. Add another If/Else sub-action to check whether the success value is True.
   • Input: %success%
   • Operation: Equals
   • Value: True

In the True group, we can then write a message like Quote with the id %quoteId% was deleted.

In the False group, we can send a message for when the %input0% was not an existing quote id.