Creating a Custom Action

In this new version, creating a custom action is much more streamlined and far easier to do. To start off, you need to create a new Action in streamer bot. This can be achieved by Right Clicking anywhere in the Actions panel and clicking Add, from there you can Give it a name and customise it to your liking. This no longer needs to be queued in the PiShock Queue

1. Click on the newly Created Action and then navigate to the Sub-Actions panel and Right Click
   • [Core > Arguments > Set Argument] (refer to Custom Arguments)
   • Add an intensity as the argument
2. Right Click the Sub-Actions panel again and Right Click
   • [Core > Actions > Run Action]
   • Make sure "Run Action Immediately" is OFF
3. Navigate to the Triggers panel and add a trigger of your choice (or trigger it externally with another program)

Custom Arguments

If a [REQUIRED] argument is missing from a request, it will not work, make sure you set the required. Everything else falls back on your the Config you set

Name	Value	Description
intensity	1-100	[REQUIRED] Sets the intensity for the current operation
duration	1-15	Sets the duration for the current operation
op	0-2	Sets the operation (0 = Shock, 1 = Vibrate, 2 = Beep)
mode	0-3	Sets the multi-shock mode (0 = None, 1 = Round Robin, 2 = Random, 3 = All)
shocker	0-n	n being your total number of shockers, used to determine which shocker is used if no mode is set
log	string	Used to set your log name on the PiShock website.

Operations

Name	Description
PiShock Operate	Will trigger an operation based on supplied arguments or default to whatever you set in your config
PiShock OperateShock	Will trigger a shock operation and use any additional supplied arguments
PiShock OperateVibrate	Will trigger a vibrate operation and use any additional supplied arguments
PiShock OperateBeep	Will trigger a beep operation and use any additional supplied arguments (Does not need intensity)

Config Settings

Name	Value	Description
Max Intensity	1-100	When a request comes in, if the value is over this value, it will be set to this value
Max Duration	1-15	When a request comes in, if the value is over this value, it will be set to this value
Default Operation	Select Box	If a request comes in without an op argument, it will default to this options
Default Shocker	0-n	n = max number of shockers, if a request comes in and no mode is set, it will use this shocker as the default option.
Multi Shock Mode	Select Box	Sets the default mode for shock requests, None = default shocker, RoundRobin, Random, All
Operate Message	string	(blank = disabled) This message will be sent to your Twitch Chat when a request is sent. You can use {intensity} {duration} and {op}
PiShock Log	string	The log which shows up on the PiShock Control Page
Post Delay	0-60	(0 = disbaled) How long the plugin waits between shocks, if you just got shocked, the plugin will wait X seconds before shocking you again
Send Chat Messages	checkbox	All potential error messages will be logged in your Twitch chat to make it easier to diagnose issues
Bypass Queue	checkbox	Will bypass the queue system I have in place, everytime a shock request is sent, it waits until the last one is finished before doing the next one. This completely bypasses that behaviour. This could result in some unexpected behaviour but it should be fine for the most part.