Version 3.0 of InstructBot comes with a bunch of new features an overview of which is listed below.

Applications

Applications allow you to define settings and profiles used per application. For example you can have different mouse configuration and target windows per application. This allows you to switch between games quickly without needing to re-target InstructBot.

As well as allowing you to define multiple applications InstructBot will try and update the application it targets automatically (if configured to do so), so you don't need to change anything as the active window changes.

To see more about active application targeting, see here.

Commands

Types

There are two new command types: External Command and Text Command.

External Command

Allows you to trigger a third party application with InstructBot passing it the required arguments.

Text Command

Allows you to output text into chat.

Enhancements

In general most commands have been enhanced with the following options.

Cooldowns

The ability to set a global cooldown and / or user cooldown. For more information on cooldown see here.

Help

The ability to configure the help command the command appears within it. You can see more information on the help command in each command type.

Queue

The queue the command is executed within. For more information on queues see here.

Sound Effects

The play sound commands to play at the start or end of the command.

Help Command

The help command replaces the help options from version 2 of InstructBot. It allows you to output text on how commands can be triggered.

Input Command

The renamed action commands have the common improvements to commands, a revised way of updating an absolute mouse movement command and a new repeat action.

Swap Mouse Button Command

The swap mouse button command have the common improvements to commands and a new pulsing effect which will trigger the mouse swap on and off when enabled.

Timeout Command

The timeout commands have been merged into one command from version 2 but allowing multiple duration. It also allows more fine grade control upon whom is timed out.

Console

The console screen shows you chat, activities and users. It will also show when commands are run and any warning which occur as InstructBot runs them.

You can configure it to highlight certain users, or users groups (moderators or VIPs).

Notifications

There have been updates to the notifications InstructBot sends as it runs allowing you more fine control of what InstructBot sends into chat. To see more about configuring the notification see here.

Processing

The processing screen replaces the commands window. You can see the list of commands which are queued, existing or completed. Quickly see whom triggered it, where is came from and if the user paid for it using bits, points, etc...

Rewards

Accumulator

The accumulator screen allows you to reward chat for cheers or donations which don't trigger commands. When a total you decide is reached the accumulator is triggered distributing uses of commands.

To see more about configuring the accumulator see here.

Discounts

The discount screen allows you to set a global and / or tier based discount for command. When discounts are enabled the prices in the help command will be adjusted for the type of user triggering the command.

To see more about configuring the discounts see here.

Subscriptions

The subscriptions screen allows you to reward chat for each subscription which occurs. Depending upon the tier you can gift different commands to the triggering user and / or other users in chat.

To see more about configuring the subscriptions see here.

Profiles

Profiles are used to organise commands into groups, which can be enabled and disable easily or allow you different command sets for different applications. To see more about profiles see here.

Timeline

The timeline screen shows you statistic of the selected period. From average viewer count, active viewer count, to how the commands run relate to the interaction within your stream.

Currently limited in scope, as more data is collected I hope to be able to make suggestions about command costs which will increase interaction based upon anonymous usage statistics of streamer of similar size.

Bug Fixes

Fixed a bug with authentication token expiring unexpectedly.

Fixed a bug with sound device selection in the options window.

Enhancements

Enabled silent re-authentication so only when user interaction is required will browser pages be opened.

Version 3 Ready

Updated client to be ready to upgrade to version 3.

Bug Fixes

Fixed a bug with the StreamElements integration.

Mute sound command

Created a mute sound command that will mute the target application (e.g. the game) for a duration.

Play sound command

Create a play sound command that will play a sound file.

Bug Fixes

Fixed a bug were copying actions wouldn't copy everything.

Fixed a bug were copying commands wouldn't copy everything.

Fixed a bug were commands which have no cost but a trigger (e.g. a free command) wouldn't be queued.

Swap left and right mouse button command

The swap left and right mouse button command has been updated so that uses can be added.

Use Add Command for Viewer

The use add command has been updated so that it functions for viewers.

For a viewer to give themselves a use of a command they must type !use add TriggerOrBitAmount CheerXXX, e.g. they must include the cheer amount in the command (or donation). Note the number of uses will be calculated from the cheer amount, e.g. so they can gift multiple uses to themselves at the same time.

If the viewer wants to give another viewer a use they must include there user name !use add UserName TriggerOrBitAmount CheerXXX e.g. it's the same as the existing use add command, you must just include the correct cheer amount, or be within a donation message.

StreamElements Integration (Beta).

StreamElements integration has been enabled. You can now connect your StreamElements account and respond to donations or use it's points system etc...

Please let me know if you run into any issues with this.

Bug Fixes

Miscellaneous bug fixes.

Absolute mouse movement action created

The absolute mouse movement action let you select a position on screen to place your cursor.

Automatic Updates

The bot now check what version you are running and prompts you to update if a newer version is available.

Execute command updated

The @InstructBot execute ... command can be shortened to !execute.

Note: In future releases the @InstructBot path to the commands will be depreciated, so please update to using the new syntax.

Mouse button down action created

Like the key down action, there is now equivalent mouse button down action.

The mouse button up action presses the specified mouse button.

Mouse button up action created

Like the key up action, there is now equivalent mouse button up action.

The mouse button up action releases the specified mouse button.

Relative mouse movement action created

The relative mouse movement action let you select the number of degrees to move horizontally and vertically.

To enable relative mouse movements you must configure the bot see: Mouse Configuration .

Trigger to command converter updated to enable future enhancement

Updates to how chat commands / bits / donations / points are converted into commands which are executed. There should be no difference for bits / donation / points. For chat commands if you have defined a trigger for you command they can now be used as a short hand. E.g. if you have a command which costs 100 bits and has a unique trigger of dropmag you as the broadcaster, moderators if enabled (and whitelisted if required), or a viewer with uses etc... can now type !dropmag in chat and have the action performed.

When evaluating if a command can execute there is the following priority: Broadcaster => Moderator => Paid => Use => Points.

E.g. is a viewer types !dropmag and has a use of the command, the use will be used, otherwise if points are enabled points will be used.

Viewers could also trigger commands by typing !dropmag Cheer100

Note: this doesn't stop viewers just cheering. It also doesn't stop the need for the trigger to be defined if you have multiple commands with the same bits / donation cost. E.g. you can still dropmag Cheer100 or Cheer100 dropmag.

Use add command updated

The @InstructBot use add ... command can be shortened to !use add.

Note: In future releases the @InstructBot path to the commands will be depreciated, so please update to using the new syntax.

Use info command created

A new command which allows your viewers to see how many uses of commands they have. It can be trigger by typing @InstructBot use info or !use info in chat.

User interface updated

There have been some minor changes to the UI.