BlackCompany

BlackCompany

BlackCompany is a StarCraft II bot written in Go.

Dependencies

This bot is developed on Linux.

StarCraft II

1. Install Steam
2. Download Battle.net-Setup.exe
3. Add Battle.net-Setup.exe as a non-Steam game
4. In Steam, right click on Battle.net-Setup.exe, Properties... and set Launch options to WINE_SIMULATE_WRITECOPY=1 %command%
5. Go to Compatibility and check Force the use of a specific Steam Play compatibility tool
6. Launch Battle.net-Setup.exe via Steam and install it at the default location
7. Go back to Battle.net-Setup.exe's properties and change the Target to its installed location, like $HOME/.steam/debian-installation/steamapps/compatdata/3430940832/pfx/drive_c/Program Files (x86)/Battle.net/Battle.net Launcher.exe

You can now launch Battle.net as a non-Steam game and play StarCraft II.

Environment variables

When PROTON_PATH is set, the bot will use Proton to launch the game. Otherwise, it will fallback to sl2's defaults.

Fill in the .env.local file. Here's an example:

PROTON_PATH="$HOME/.steam/root/steamapps/common/Proton - Experimental/proton"
SC2PATH="$HOME/.steam/debian-installation/steamapps/compatdata/3430940832/pfx/drive_c/Program Files (x86)/StarCraft II"
STEAM_COMPAT_CLIENT_INSTALL_PATH="$HOME/.steam/debian-installation"
STEAM_COMPAT_DATA_PATH="$HOME/.steam/debian-installation/steamapps/compatdata/3430940832"

Maps

Go to Map Packs, download all the maps and extract them in $SC2PATH/Maps using the password iagreetotheeula.

Run

There's a Makefile to help you run the bot.

# Runs the game in real-time
make slow

# Runs the game as fast as possible
make fast

Resources

These resources massively helped me kickstart bot development.

• Install and play StarCraft II using Steam on Linux
• Guide to StarCraft II Proto API
• VeTerran
• s2l
• liquipedia
• StarCraft Wiki