BasicSc2Bot

Template SC2 Bot for CMPUT 350 at UAlberta.

This bot works with our fork of Sc2LadderServer which will be used to run the tournament at the end of the term. It should help you set up the build process with the correct version of SC2 API so you can focus on creating your bot.

Developer Install / Compile Instructions

Requirements

• CMake
• Starcraft 2 (Windows) (Linux)
• Starcraft 2 Map Packs

Windows

Download and install Visual Studio 2019 if you need it. Building with Visual Studio 2019 not yet supported.

:: Clone the project
$ git clone --recursive https://github.com/solinas/BasicSc2Bot.git
$ cd BasicSc2Bot

:: Create build directory.
$ mkdir build
$ cd build

:: Generate VS solution.
$ cmake ../ -G "Visual Studio 16 2019"

:: Build the project using Visual Studio.
$ start BasicSc2Bot.sln

Mac

Note: Try opening the SC2 game client before installing. If the game crashes before opening, you may need to change your Share name:

• Open System Preferences
• Click on Sharing
• In the Computer Name textfield, change the default 'Macbook Pro' to a single word name (the exact name shouldn't matter, as long as its not the default name)

:: Clone the project
$ git clone --recursive https://github.com/solinas/BasicSc2Bot.git
$ cd BasicSc2Bot

:: Create build directory.
$ mkdir build
$ cd build

:: Generate a Makefile
:: Use 'cmake -DCMAKE_BUILD_TYPE=Debug ../' if debug info is needed
$ cmake ../

:: Build
$ make

Playing against the built-in AI

In addition to competing against other bots using the Sc2LadderServer, this bot can play against the built-in AI by specifying command line argurments.

For example,

/BasicSc2Bot.exe -c -a zerg -d Hard -m CactusValleyLE.SC2Map

will result in the bot playing against the zerg built-in AI on hard difficulty on the map CactusValleyLE.