Description
This extension gives users the option on Twitch to check their current active chatters, which is determined by either chatting or using rewards. It will save the time of the event in a persisted user variable which will then be used in the other two actions. “Get Random Chatter” will try to find a random active chatter, and “Check Active Chatters” is only used to get the amount of active chatters and what kind of chatters there are.
Import File
[pwn]_TwitchChatters_Bundle_1.0.4_by_pwnyy.sb (11.8 KB)
Installation
In Streamer.bot click the Import button in the top menu. Drag the .sb file into the Import String field. You will have 4 Actions and 1 non-blocking Queue.
Configuration
In the Set Chat Activity you can determine by the triggers what is considered an activity. By default, there are Twitch > Chat Message and Twitch > Reward Redemption triggers added to the action, if you don’t want rewards to be considered an activity then you can delete that trigger.
Both the Get Random Chatter and Check Active Chatters actions have the same kind of configuration you can adjust. The configurations are based on the Set Argument subactions, which are explained below.
| Argument Name | Value | Description |
|---|---|---|
| activeThresholdSeconds | non-decimal number | Will determine how long a chatter is considered active. 60 = they would have to have chatted the last 60 seconds |
| includeRedeemer | True/False | Whether user who initiated the action is included |
| includeMods | True/False | Whether mods are included |
| includeVips | True/False | Whether VIPs are included |
| includeSubs | True/False | Whether subscribers are included |
| includeBroadcaster | True/False | Whether the broadcaster is included |
| includeBotAccount | True/False | Whether the bot account is included |
| ignoredGroups | text | Define the user groups that should be excluded. Separated by a comma (,) |
Usage
You can use both the Get Random Chatter and Check Active Chatters action in other action by simply using them with the Core > Actions > Run Action subaction. If you want to have different configurations you can duplicate the action and adjust the argument there and then use it somewhere else.
Generated Arguments
The following arguments are being generated by Get Random Chatter and Check Active Chatters:
| Argument | Value | Description |
|---|---|---|
| totalActiveChatters | long number | How many active chatters there were |
| onlyMods | True/False | Whether it was only mods that were active |
| onlyVips | True/False | Whether only VIPs were active |
| onlySubs | True/False | Whether only Subs were active. |
| includeSubs | True/False | Whether subscribers are included |
| includeBroadcaster | True/False | Whether the broadcaster is included |
| includeBotAccount | True/False | Whether the bot account is included |
Check Active Chatters
The following arguments are only generated by the “Check Active Chatters” action.
| Argument | Value | Description |
|---|---|---|
| activeChattersDict | Dictionary<string,string> | Dictionary of userIds that were active within the threshold. Values of the dictionary are userLogin names |
Get Random Chatter Argument
The following arguments are only generated by the Get Random Chatter action:
# means index starting at 0. So the first user is foundUserName0, the second foundUserName1 etc.
You can adjust the amount of random chatters you get by changing the value of the randomUserAmount argument. Remember that is only the max amount of users that can be found, if there are not enough users to pull from it will only get as many as possible.
| Argument | Value | Description |
|---|---|---|
| foundChatter | True/False | If a random user was able to be found. |
| foundUserName# | string/text | Display name of random chatter |
| foundUserLogin# | string/text | Login name of random chatter |
| foundUserId# | string/text | User id of random chatter |
foundUserName#, foundUserLogin# and foundUserId# are not populated if foundChatter is False.
Get Target Last Activity
This action should be used with the Core > Actions > Run Action subaction after a Twitch > Users > Get User Info for Target subaction. Like as follows:
The action itself requires the targetUserId argument to exist, else no arguments will be generated.
| Argument | Value | Description |
|---|---|---|
| targetLastChatActivitySeconds | long/number | Amount of seconds from last activity til current time |
| targetLastChatActivity | DateTime | DateTime of last chat activity of targeted user |
Testing Phase Log
Version 1
- 3 Actions - Set Chat Activity, Get Random Chatter, Check Active Chatters
Version 2
- Add action “Get Target Last Activity”
Version 3
- Adding activeChattersDict to Check Active Chatters action
Version 4
- Add option to get multiple random chatters via argument