Upstart Grief Bot is a community made bot, that integrates into Twitch chat and Dota Underlords.

At launch, the application connects to a Twitch chat and starts listening for incoming chat messages.

At the same time, the application connects Source 2's netcon component, that existed since Left 4 Dead and Left 4 Dead 2, and initiates a Telnet connection.

Once a command on twitch has been invoked often enough / above a specified threshold, a Source 2 console command is programmatically triggered and a message will show in-game.

By using a couple of internal, debug commands, even the executed command is printed on the screen.

Currently supported commands are:

• !toggle
• !dps
• !spray
• !benchUnit
• !sell
• !enemiesDown
• !away
• !disconnect
• !quit
• !enemiesUp
• !home
• !opponent
• !levelup
• !reroll
• !lock
• !cameraDown
• !cameraUp
• !buy <slot number>
• !fakeDown

Disclaimer: All of these commands might disappear in a future Underlords update.

Duplicate the .env.example file and rename the duplicate to .env.

Then fill in the required values in the .env file.

Head over to Underlords on Steam and set the following game launch options: -netconport 27015 +developer 1

On Windows please set the following launch options -netconport 2121 +developer 1 and add this line to the .env file:

TELNET_ADDRESS=127.0.0.1:2121

After successfully setting the launch options, start Underlords before proceeding with one of the two following steps:

Prior to using the bot inside of a container install docker (or an alternative container runtime) and docker-compose.

In order to start the bot, run: docker-compose up.

In order to stop it, either ctrl+c out of the previous terminal session or run docker-compose down.

As this project is written in Go, a local installation of the Go compiler is required in order to build the source. The Go compiler can be found at: https://golang.org/.

Furthermore it's recommended to install make. (part of build-essential for apt-get users and part of the Xcode developer tools for macos users.)

• Building from source: make

  The above command will then compile the source and output the binary in ./bin/UpstartGriefBot.

  This binary can be immediately invoked and will try connecting to a running Underlords instance. If a connection is not possible, it will fail on startup.

• Run from source: make run

  This should start the bot immediately.

Generally speaking, this bot can be adapted for most Valve games to receive a live stream of the Source 2 console and in response run console commands. This might have future uses for e.g. automated camera movement in Dota 2 (in conjunction with Dota's game state integration and additional console debug prints of Source 2)

This project is not affiliated with Valve or Steam.

Valve, the Valve logo, Steam, the Steam logo, Source, the Source logo, Dota, the Dota 2 logo, Defense of the Ancients, Dota Underlords and the Dota Underlords logo are trademarks and/or registered trademarks of Valve Corporation.

TWITCH, the TWITCH Logo, the Glitch Logo, and/or TWITCHTV are trademarks of Twitch Interactive, Inc. or its affiliates.