diff --git a/streamerbot/1.get-started/1.installation.md b/streamerbot/1.get-started/1.installation.md index 52651c0b..ef17918d 100644 --- a/streamerbot/1.get-started/1.installation.md +++ b/streamerbot/1.get-started/1.installation.md @@ -68,7 +68,7 @@ Once you have connected to the website, you can change your update release chann **Beta** updates are available to **everyone**, by joining the Discord and linking with Streamer.bot :: ::callout{icon=i-simple-icons-patreon} - **Alpha** updates are only available to **Silver Tier** subscribers on [Patreon](https://patreon.com/nate1280){target=_blank} + **Alpha** updates are only available to **Bronze Tier** subscribers on [Patreon](https://patreon.com/nate1280){target=_blank} :: diff --git a/streamerbot/1.get-started/5.examples/assets/quote-check-command-input.png b/streamerbot/1.get-started/5.examples/assets/quote-check-command-input.png index 3acdc15e..38a84001 100644 Binary files a/streamerbot/1.get-started/5.examples/assets/quote-check-command-input.png and b/streamerbot/1.get-started/5.examples/assets/quote-check-command-input.png differ diff --git a/streamerbot/1.get-started/5.examples/assets/quote-del-finished-action.png b/streamerbot/1.get-started/5.examples/assets/quote-del-finished-action.png new file mode 100644 index 00000000..e0cf7307 Binary files /dev/null and b/streamerbot/1.get-started/5.examples/assets/quote-del-finished-action.png differ diff --git a/streamerbot/1.get-started/5.examples/assets/quote-get-finished-action.png b/streamerbot/1.get-started/5.examples/assets/quote-get-finished-action.png index 5dcbd895..2441a82b 100644 Binary files a/streamerbot/1.get-started/5.examples/assets/quote-get-finished-action.png and b/streamerbot/1.get-started/5.examples/assets/quote-get-finished-action.png differ diff --git a/streamerbot/1.get-started/5.examples/quotes-commands.md b/streamerbot/1.get-started/5.examples/quotes-commands.md index c84ce253..a574be55 100644 --- a/streamerbot/1.get-started/5.examples/quotes-commands.md +++ b/streamerbot/1.get-started/5.examples/quotes-commands.md @@ -12,11 +12,16 @@ This is only for Streamer.bot v1.0.0 and above! :: In Streamer.bot v1.0.0+, the built-in quote command "!quote" has been removed. This allows for more customization and flexibility in how quotes are retrieved and displayed. With that the "Show Quote" trigger will also not work anymore. -The following example shows how to create your own "!quote" command to either retrieve a random quote or a specific quote by its index. +The following example shows how to: -An import is provided at the end of the instructions, which includes a "!quote" and "!quoteadd" command. +- Create your own "!quote" command to either retrieve a random quote or a specific quote by its index. +- Create a "!quoteadd" command to add a quote by the input of a command. +- Create a "!quotedel" command to delete a quote by a quote index. -The instructions below will guide you through the process of creating a quote command that can retrieve quotes, and add new quotes. +An import is provided at the end of the instructions, which includes a "!quote","!quoteadd" and "!quotedel" command. +Additionally the import also includes an example of how one can add a quote by directly replying to a message on Twitch and using the message you replied to as the quote itself and also the user will be linked to the quote. + +The instructions below will guide you through the process of creating a quote command that can retrieve quotes, add new quotes and delete quotes. Keep in mind this is just an example, and you can customize the sub-actions to your liking. The following sub-actions will be used to retrieve a random quote or a specific quote by its index. It will also be checked whether or not a command input is a number or not via inline math. ## Instructions (Get Quote) @@ -37,7 +42,7 @@ Keep in mind this is just an example, and you can customize the sub-actions to y ![Add Quote Command](assets/quote-command-get-quote.png) -3. Check whether input is empty or not +3. 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`. @@ -45,7 +50,9 @@ Keep in mind this is just an example, and you can customize the sub-actions to y - 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. + ![Check if empty](assets/quote-if-empty.png) + 4. Get a random quote and send the message In the `True` group of the If/Else block, we will retrieve a random quote. @@ -64,28 +71,24 @@ Keep in mind this is just an example, and you can customize the sub-actions to y 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 a sub-action Core -> Arguments -> Set Argument. - - Variable Name: `quoteNum` - - Value: `$math( floor( %input0% ) )$` - The math function will round down the input to the nearest whole number. If the value of `input0` is not a number, the value of `quoteNum` will be `NaN` which we can check with another `if/else`. - :read-more{to="/guide/variables#math"} - - 2. Add another `If/Else` sub-action to check whether the `quoteNum` value is a number or not. - - Input: `%quoteNum%` - - Operation: `Equals` - - Value: `NaN` + 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, 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. + In the `True` group, we will continue and try to retrieve the specific quote by its index. - In the `False` 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. ![Counter Message](assets/quote-check-command-input.png) 6. 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 `%quoteNum%`, which will retrieve the value of the `quoteNum` variable we set earlier. + 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. :read-more{to="/api/sub-actions/core/quotes/get-quote"} @@ -123,9 +126,21 @@ Keep in mind this is just an example, and you can customize the sub-actions to y 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. -3. Adding the quote itself +3. 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/Else`block. + +4. 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`. @@ -133,7 +148,7 @@ Keep in mind this is just an example, and you can customize the sub-actions to y ![Add Quote Sub-Action](assets/quote-add-quote-sub-action.png) -4. Check if the quote was added successfully +5. 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%` @@ -146,12 +161,68 @@ Keep in mind this is just an example, and you can customize the sub-actions to y 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. -## Import +## Instructions (Delete Quote) + Deleting a quote is similiar to `Get Quote` as we again check if the input is a number and then try to delete by that index/number. -As mentioned at the start here is the import for Streamer.bot v1.0.0 and above. This includes the `!quote` and `!quoteadd` commands, and the needed actions. +1. Creating an action -```bash [streamerbot-import] -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 + 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". + +2. 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. + +3. 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. + + ![Check if empty](assets/quote-if-empty.png) -``` +4. 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. + + +5. 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. + + ![Counter Message](assets/quote-del-finished-action.png) + +## Import + +As mentioned at the start here is the import for Streamer.bot v1.0.0 and above. This includes the `!quote`, `!quoteadd` and `!quotedel` commands, and the needed actions. Additionaly an example how to use a Twitch Reply to add a quote, which is not linked to any trigger as it's just an example. + +```bash [streamerbot-import] +U0JBRR+LCAAAAAAABADtXelzGzey/75V+z9wtS/1rsDBfeSbrSSylMRZS7LkVeRXhVNizCs8dGQr//vrGZIjUsPhZVKH11Mul0g0MEB3A/3rRgP811//UqvtNGPf7nxb+1f2AT62bDPCx51f3w7a/dj7UNuL/W9ehvDNd7ER+7Fma3nBztcjejvoX7a7WY2jfjdC5e4L1+7XUK1z3bq9LciuYrdXb7cyOvICvyBFQYg93613+qNCeFuta1uh3ay1u7VeJ/p6qvva79k7v67ZEKAD+YcaENXCsE/DLxJUmOpD9iL8v5M9bR8OWi/96F2tQaMxLmvWW/XmoHlS9DIrzMr+zCl2gp1iks3b6ME3vw6/qY2L8uJ6yMfpsUg0JmRkCIhjHJGWTiDOTWIkcBK1H3cur/b7IA5y3uPRg2b8N36masaWdY2YvbXfHcSpkhvfGIT4Q7fdfF3v9dvdWyBKttGrovpHbIV662IWVUk1XubimNKHnPCi2x50MsohYe3oVe0qF8YUlW1c29seSGTWu4Y6UMiqVO7bLT/odmOrP6u0361fXIAsJwV0T0ijVppNeNF+Li/JJbPScaSx54jHYJBVRiBDgjEEyjDWkwOYEDUPwmDrMWJaY8Q95shKTVAkjBqaUtLWlqr2bzsZOzkm90sqxXknrN5Y/z5Mlv559+HDJD96A/eyrLKzOHJlG0Md/BXVdi+j/1irp1r/MsKkvN5vdQb9Wk5Rq/dqsdnp336dld+CjEG3OjnhcG7k37faNZBTv96CCuhDiQG+3RiuHBVcBRZizxRByhKHuCQK6eAIItzFyKXg0cZS1etYv7jMlALUrYLjBGNzv6hjM13KFWFiXVhSIvVWiDfZK6dk8fU8PtczXmaD/GrM2K9KQ2l3YteOJkCpw2NBzeptttIdD8c6q7vV2jCjp3mN4WycMdOWbLOi3SEnclkrq7RXmCFCPAFZK4qMdhpFHpKSSWrOwn0GFU3MkXlBM5Y95VUUEyqwQ21ghCSDWMQUcUoxMsZTFLUigVFhZ0zooqG5ynI37llKM37+LH/5YRbb65/U20WMGzPNGFNapO6zbIYeLseMakb8WaLehG7O4aPnGNYXkhCs3QlxgQ0yApgZNVNJU8aJ8Z/KR7p1PpISH6e/uM+A0eAlk1Z4YpDX3iOeqEaOKoWoUNjIFK1Vcq3VlpZKNrLYTg1z/mKb48MT261n7S5YdIfMSE4TJjUYHGZgOcIA4MCy20wTDNXGa7A965keprbCDbqO6ekNvI+93nzLUxpKARGOoT+lqo9ue+bMb05lcjIClggWELnTHDkdIrJJKJOEtox8WSfXt+GWRKdx8ICCBaDgZDCyAlC0DCIGawBc84e04SFElkKSyHMHIqfgellCBCKR0JCos4KZp2PD1+3tZ2F7AnaGGxpgJmoGDnKUSFMKEzNKYVNy0Qv3lGwPW361nXSoXnYvBk14e+/bYcjiuN6MXw//3A+jP971Ynfiz/3SjFnoNknrFFGSIUlSBBQTAA3KKBBVnqqQOBOWPim3ia/BzZxB/2jYfmp3myN+7dmCneu4m0ZiJZg1KFLHMhMBM9BQj6IFzyR5oznFT4pvYnm+9eNNvwjIZGG0GL6tfZWzqmz9B734qt2veDlYj4az/mNV34as9I7JPPTlFGBJrR1gSVBBy4kzWnm7tgpuhZFyipF3H6ZiKKA+DdvpxbCXRbemYy93zC+HAbEnzlvikQkYnAppLLJKOaQSBp0iWieRnncYMIvZfi5BQOq854oxpJQCDEOlBheAJoSZCZoJFkMUFesH88ZxpTjyXigwYh4cKMYzV1wyBUuysK68mD/JIOCdh5D/hbcTmpqFQ59YbKowN/upNmRFEfisRI6Fmfk7JmZXfVdJONIaGY21YHW0sOBphuSRE8EinFLyTEiBDd8IaC5boYJkKvKlqAyAFJClloOPxDQynIC3xLj2SVHKFNkqap5Zq0pAQxg1HGElB0YAqxrgDns1Ak/ES2ZBCNpKxI23CHx9D/NfJh6cJYpUD381cVSSPJI4Stg9e1YTxxhm/P2rEc+/GoOMGhr9lYHa0npSNDAPehRE8yHI3biGroV1ID8RUGJcgPmVChmsAyIiBCU4SSSlzQj0iYmTzhTnSj7pur39Ei+pbnfUtQUGtqCcNLSsiqgwU/93fh7+5z8qG1tgfFcY2JzB5S0sZN6K71rwvrylSVswS6vKxMM5uUgGRZ0RnrdJGMUoYizbzPdGIk0EwHtCknaK6hRLcfJSU0ssLAXtYotRkE6FvwTDBuOAKMt21BihyBEJNk3Z4LB3QbmSO1tqcKklp6Cea9jHz2yLMn4WCbmYOb/fdzhmkk9OH7mIeA5uLdEuOZUK+uXVPHsWcCFvcekptmYfluxH3vLY7r9pF7k4g1bIM3JynRjZ/jeD5sJZVrS5DBQoVVoOGpSqDWe2jlo5AzPGOgcOnHRg7sD5Q1QElSRgiJhKUcjKJleY4UWdRVCiVGFyvvsAjqt0EpmIGeKW+SzdCCPiosgCPhJXR99LDa8074taS83/8TN/HRg/y2rgpKfWv4zdPEOlNVbH63r/Er62/Vp9eR4s68iVKo63EJN0VkhEjAHIJFhEWlODiMUBCxy5cpVQr9TkJ2lTpeNXqvJE9WmmZ3L/mQFt7z+zoG75pRsd/aqSWwSNS/SLoXKpysrCWH5iL57Uz820TS4so8XE9ob27aFWEoy1o8RaAJs+iyAr0EqrBFKJBuY0/F9OTKxs8hFWEhaiZzIQpFPI7KpnSHutssRKjXWSjMvP2DKVYyLfrhYUKbX48MhICG6VlRhJnsCDwCLLihUYKVikooIvLX0gW/bM9e8RLNmmRv8plmxW4kGJ/kEt2UJBLBDCIgGMYYTg3jDuEA0Glm7NDNIRa5S00pZzhxVdyPy1ggWlxIcS5ROJFcwVxBwhzBPAOPT7iaNalvHLYrYVNHx5Zi42bdXm7KlF8GZst2Vgq9Xu1yxwrOlid6EWroq1xod1nGMsZGoiMgsnwGXThBOkdBKOpECTqNyGK5paL6q3CFNNzdQUPLZUc0Spgs4mq5G24Jc4JpQMgWql2POL6t3FjzJJgxrUwwhs5y//Zij7vy0c2CrIaEVEND6nQHyUxuJsV9BkfiEgIYstAt7r6GIQnm1JT56JlmxxPf/UUa2zns9DLttdzysZWcHEKgaOF7jArCSJIhZjhkRgbbOeAISPJBEWBY6h0hiulpy71EZolNxRDJhIE+NgHmXbssR4FAyXXBoTDancRdnIvnb5yzkboev29vNIzg0kYWINUj7ZLK3bIRMDRUR77iJ3sPyVMpMfMzl3+hTe3YeNZPPFzGkKSSOajEDcxIic4ga5kHByWnAqpjIbn18238Sh3tpV3dYOY6dxW/uv4+t631/+99NN8dvAgdfjy3pvdH412z6wrVq8sc1OI9baqXbZvq7121NH0N1trZtxB1ibF9WGTKo1Y69nL9ZKQobVmNPEFZKaw2SzHLx1DSaPcJYCIQBR6dNK3l7hzOskq9+0a8dD4eWczhKSM3aGmOygASCwV6v3/7NX+23Q60/KYQ2OKkKygxQS0eg1zFiXp8NLRIRTwGvtNC0f635Mjq5wsG0ij6SXz9PP6yjXLMO9MFUTlOv0Mrbys+ij1N5cxYZTdThPxxMU/IXhtuC9iV1Ws+I9lepWUIyPtEgbg6QoGooR51IjQ4VASnhNBNcy8Mqg/TbyOkHXGafBAuALWS4XIcgIK7Lz1kFL4SQR1fjvwfM6R1ZpXr7m9MUh8yi7MUVghI9zAxQ7u9+en5/CGNrXvfPzn+u+2+61U//Fm++Pz89/6EKHrtvdj5Kfn19xsHEMM2LOz5s93+426u5FaDR2VgTm7rYfd9sh19rw/k3HNf3FO9b4I+yd9H+5xj9+97ZzHU4Pevb054t/0ptLz36+eEte7R+dCvhONKBcffe2feBfn9TdXuO3/b2DK0evLw7fXzb+yU7w2dFFJyuP0Nbu28Z3776/GJy8PhCH9AS/fX/Q+nH34Pbs/atePBLE05Pbo9O39Z/2DAm7r/4Irw/y/vjmybV73TgZlXd+WbKt4z3Tsqd8bnvHzR/6Z0cf8zHsvnvz9mhXvPOtxuuz94evfNO391sHDb93I35qnfxx9v7gl3+eksZ+/eYqvH974dnhLfCgtf96SHPy/k3D15doq0n+OMMHV2evP5b79v7kKuy96wx5D+2cAn7afQVlh424+9Lsf5+3++ps7/AwnBp89u7syjcOmX1/+JvdvRyO/yTv68HZ7s1NTnN0g33rpPHjce/N7sXHg0x+PzXeNML3P9yesZP+2akAhh6MaPd7k30Y8/ndiMcBxu9ab2EsPxDHDhtDeTUGZ3snfKn2877t13+q5tnxkF+BuNMTGPtFfdifkwl5QR/ny3BuG3mfJ9//sfFx2Pd8vMDDQ+Kb/AJkQs7y7xsG9Lz6oGanG2GV79QbC7MaQ2zY26O+7c6CklOUPXsVD2MPgMhxe+LY+MI6U9RL5Jpr4blhEjEdAesxJZEFNxxhFrRyUgbrK/ONVjERJnuemI3YYLL51Jm2X4td1g/FLivgykfKPQc5cqcTwvlhIhccstRYFFwEFJAUZdUJZZvPPX9A6W4g93zd3n7JPa9uN69ZAspvfjku0PEQEMfCDwPPfQvYWHsnozcaXNuQbcdJjqzC4JwFoZxmyjNdGcjdypmnZLGxJqCgDfSHSIIcdxJJJj12wkir1NPBxivcZnL3+uH9F8ZTrxRDLAgKPglLMKdAAlgTGrzU4Atv6CxM6ZaTguSR+P5vYW9M5DCPHEykSBjiImKwNzILelDrPFUANqqB1ObPOj2cdDdx1mnN3n4WIX5wJ2hQjiEvGaiLUDB4kRiiXhtHWbBKlAb/mCH+6duO7j5sJMSvpA4i+QgsIIA8CGBzmDcWySSi0lFL+dxD/KOrXD+XM/vSgl3jFKMAoDDbFwaYbZhCQYlAmabU2xKcGMvaUMIYpSDh7M4PajzSFAC7sjZIGyWRpnzc/8uZ/enyJxoI3t6ZfcyTJ1E7hEMW22XJIkeyW5u0tcRgUEWyIRy1HH4NGEvPsqtqEqPZTcMWaRxjdtkIpiYRH9MTiu0WyT4xhsy5gGHEbrbJU88/wr8wvmo6R1EvHhBB4aSU0SIgwhTNcJMHhKw4cpJSKyMFgPCAp8UfUK4bSJJYt7eb9Nh3nEvCJkpQlJxkaS4MaRk0ssFrLqkmhMzcdnnePv0Kp5nH+8ycR5td76kSWEouqEWWYYWI896Ab05S2tA9F6zq3O2U3AiATEYVTDeXXZ4DQkSZU4pc9NnVd445Xdr3Lhp68CVs8RWaBem8/deCaO4+bEE1fz+2IHuep/fvHeAc2wB4wSghI8sEtrURv7eVBsxpyO7K87D0Z46QZwk55ROKVHtwBK3g1Stu0dRDpAEDZgXHLCEcs8OlTuQ5WQR5ogXMIsmSf4aH+6cjLKNDuzHDBXf3yWRqMNSNUAkMiga3nw9MqBCECY6Y99lPOwiBHIYVDPwRYoITWJVvriw1tf184MdTl23mA3/iqLZ5vmNHU4UDIBFkYOkAz9JbZGx2KacnsCKlRHWceZd40di//QmQ0QGAUJwBWerQ7borP4gkZsdsQV4O5BWNQg7EjUCPFHbKROK3da3LSiu/UyzppCXyCTSfKxuR9jahgBXolwlWlBMESw0+p5V/hGenteApLP2gHkkkkUFoCcsPwRFZ7jCiMjIRfDLSV8a3i6a2vvQ/or5scen/1FFt8yjIYyz9Gz4s8ikj2MJhkQd0DjcQB1m3t5vcSXqIOMiae03r9Ox5HycZ/jGmH24XTR1ZGG9nVP6gXCd2m/U+uDzZjnL5tENRfPf2yU7v/NwOWRCiDVUr+j9KSFvxF9CW/0W4O1aXtnzqrXwPa1ZRc5gci6c5nbMqe+vfcoRowxQm3OnGi3jz/U2nUff1/q7t9AfdmY032n5WXGanftFqdzPs8NJ7gBozIMSIZD+LW7dsYwZBrz3oDtONyT059eq9/m7WbOzO6tSIIhPzHCpve/Eotnr1fv1q5tguGm1nG7vtdiO0r0sjHOStzy67twN4b3fQtvrjy3YL7f56Mwo7Qx1XvYt72ZvJt6iMXzTx+WviekvninvQK2zKb1FdQ2x80dhH1Nh7yOA6ul7bf4z9o9i9uqetd4W7jXr2GzJThf16c0yffTP61dq7H92lw7uDd+JNp90FuWcZIzlWvfst3vJv4OalGNlG59IC1V//8uf/A19/VxwyeAAA +``` \ No newline at end of file diff --git a/streamerbot/1.get-started/_faq/11.if-else-subaction.md b/streamerbot/1.get-started/_faq/11.if-else-subaction.md index 4be1f5fb..09b748d3 100644 --- a/streamerbot/1.get-started/_faq/11.if-else-subaction.md +++ b/streamerbot/1.get-started/_faq/11.if-else-subaction.md @@ -1,7 +1,15 @@ --- description: How do If/Else sub-actions work? --- +Since version 1.0.0 of Streamer.bot the if/else sub-action has changed to be more flexible and also allow you to run singular sub-actions in a True or False Result Group. -Here is a flowchart overview: +### Input Field +Pre-1.0.0 this field was called "Variable" as you'd directly write the variable name itself in it, like `userName`. +Now it's a general input field, so to check the value of `userName` we would write `%userName%` as using %% will give us the value of the action variable. +You can now also use Inline Functions and ~globalVar~ to check the value of a global persisted variable directly. -![If-Else flowchart](../assets/if-else-flowchart.png) \ No newline at end of file +### Operation +This is the same as in pre-1.0.0, so basically the operation of how you want to check the value of the `Input` field, and the value of the `Value` field. + +### Auto Type, Operation & Value Field +More infos found [here](https://docs.streamer.bot/api/sub-actions/core/logic/if-else#parameters) \ No newline at end of file diff --git a/streamerbot/3.api/2.triggers/twitch/subscriptions/gift-bomb.md b/streamerbot/3.api/2.triggers/twitch/subscriptions/gift-bomb.md index a029f6f3..baa75ea6 100644 --- a/streamerbot/3.api/2.triggers/twitch/subscriptions/gift-bomb.md +++ b/streamerbot/3.api/2.triggers/twitch/subscriptions/gift-bomb.md @@ -25,10 +25,6 @@ variables: type: number description: The total number of subscriptions gifted by the user. value: 42 - - name: gift.cumulativeMonths# - type: number - description: Cumulative months the user has been subscribed for.
# is a number starting at 0 til totalGifts - 1 - value: 1 - name: gift.recipientUser# type: string description: Display name of the gifted user
# is a number starting at 0 til totalGifts - 1 @@ -54,7 +50,7 @@ variables: version: 0.2.5 description: The system message that was put into Twitch Chat. value: Here's another gifted sub for your channel! - - name: totalSubsGiftedShared + - name: totalGiftsShared type: boolean version: 0.2.5 description: A boolean value if the user gifting the sub(s) shares there total gift count. @@ -67,4 +63,4 @@ variables: commonVariables: - TwitchBroadcaster - TwitchUser ---- +--- \ No newline at end of file