Blue Tengu Bot

About

Blue Tengu Bot is a simple to configure, GUI-based Twitch bot that makes it easy to add interaction to a Twitch channel. We’ll continue to expand it with features as we receive requests, and as we find need for help with managing our own channel.

  • Twitch viewers can type commands to trigger sound effects.
  • All of the commands are customizable.
  • Twitch login configuration is easy – just launch the program and configure from the menus.
  • More features are coming!

Make requests by contacting us directly or putting them on our Trello board.


History

Blue Tengu Bot was designed in GameMaker using some of the code from our game Project Spaghetti as a base.

Blue Tengu has been developing games live on Twitch for more than a year, and we found that we needed a way for our viewers to alert us when we needed to pull our head out of the coding and into the chat. It was designed in two hours one Saturday morning before the show began by stripping out most of the Project Spaghetti code and tying in the chat commands to sound effects. It debuted in Season Two, Episode Twelve.

The only commands originally available were “!bt horn” for grabbing our attention, “!bt yes” for agreeing, and “!bt no” for disagreeing.

Rather than keep it to ourselves, we wanted to make it available to any of our viewers who wanted to use it in their own streams, so we put it up for free on our site.


Download

Download BlueTengu Bot.


Instructions

  1. Launch the program
  2. Select “Configure Bot” from the Launcher Menu
  3. Click on the tengu icon next to “User Name” and enter your Twitch bot’s user name (ex. bluetengubot)
    We recommend using a different user name from your own so people understand it’s a bot, not you
  4. Click on the tengu icon next to “Oauth Password” and enter your oauth password (ex. oauth:xaxaxaxaxaxaxa)
    If you don’t have one yet, go to www.twitchapps.com/tmi to get one
  5. Click on the tengu icon next to “Twitch Channel” and enter your Twitch channel (ex. bluetengu)
  6. The volume defaults to 0.5 (or 50%) but you can raise and lower it by clicking on the tengu icon next to “Change Volume”
  7. Click on the tengu icon next to “Back” to return to the Launcher Menu
  8. Click on the gray tengu icon next to “Connect” to connect it to Twitch
    If the connection succeeds, the tengu icon will turn blue.

Chat Utilities

The following utilities, accessible from “Chat Utilities” on the Launcher Menu were designed for the stream host.

Randomizer: Set a X in Y chance of Success or Failure (indicated by a voice announcement)

Set Alarm: Set an alarm to say “Time’s Running Out” in HH:MM:SS worth of time. (not the time of day)
If you set an alarm, you can cancel it by clicking on “Cancel Alarm” in the same place.


Customization

To customize the commands Blue Tengu Bot responds to, go to %localappdata%BlueTengu_Bot and edit the network_commands.ini file.

To change the text a viewer has to type to trigger a command, just change the text within the quotes to the right of the trigger, for example:

Twitch No[1]=”!bt no”
can change to:
Twitch No[1]=”!bt non”

You can have up to 10 variations of a command to trigger the same action. To add more variations, just insert a new command on another line, for example:

Twitch No[1] = “!bt no”
Twitch No[2] = “!bt non”
Twitch No[3] = “!bt iie”
Twitch No[4] = “!bt forget it”
Twitch No[5] = “!bt like totally not”

You can also change the command viewers can use to display the help screen, for example:

Command Help=”!bt commands”
can change to:
Command Help=”!pandabitz commands”

And, of course, you can edit the message displayed to help your viewers, for example:

Command Help Message=”Use !bt <key word> to interact with the channel”
can change to:
Command Help Message=”Use !hofklaus <key word>to do stuff here”
or:
Command Help Message=”For a list of commands, visit www.bluetengu.com/bluetengu-bot/”


Default Command List

We will continue to add commands, but currently you can use the following commands:

!bt commands = display a help message for how to use the bot
!bt no = announce “No”
!bt yes = announce “Yes”
!bt horn = announce “Challenge”
!bt sorry = announce “Sorry”
!bt thank you = announce “Thank You”
!bt welcome = announce “Welcome”
!bt you’re welcome = announce “You’re Welcome”
!bt game = announce “Shall We Play a Game”
!bt wait = announce “Please Wait”
!bt meet = announce “Nice to Meet You”
!bt help me = announce “Help”
!bt hello = announce “Hello”
!bt goodbye = announce “Goodbye”
!bt excellent = announce “Excellent”
!bt boolean = announce “Boolean”
!bt brackets = announce “Brackets”
!bt congratulations = announce “Congratulations”
!bt game over = announce “Game Over”
!bt last chance = announce “Last Chance”
!bt failed = announce “Challenge Failed”
!bt time’s up = announce “Time’s Up”
!bt time’s running out = announce “Time’s Running Out”
!bt present = announce “Present”
!bt bonus = announce “Bonus”
!bt challenge = announce “Challenge”
!bt ready = announce “Ready”
!bt set = announce “Set”
!bt draw = announce “Draw”
!bt rain = trigger rain SFX
!bt thunder = trigger thunder SFX
!bt blue tengu = announce “Blue Tengu”
!bt bluetengu bot = announce “BlueTengu Bot”