The script is meant to be used in LINUX distributions.
The installation script uses pipenv to handle python virtual environments. If you don't have pipenv
installed in your system you can use pip install pipenv
to install it.
Once pipenv
is installed, run this command inside the directory to install all required dependencies: pipenv install
. For more information regarding pipenv
, run pipenv
(the commands without argument).
The installation follows these steps:
- Checks if StarcraftII is already installed. It downloads it and installs it otherwise.
- Downloads all available maps listed in the map section here.
- Downloads all available replays found in the replays section here.
Firstly, be a smart cookie. This script has worked on various machines, any installation error will most likely be due to some dependency missing on your system. Try to see what dependency it is and install it.
box2d-kengz
depends on swig. Swig can be installed on the command line via sudo apt-get install swig
$SC2PATH
environmental variable may be present, it contains the path to the Starcraft2 directory.
$SC2PATH/Maps
directory containing all available maps.
$SC2PATH/Replays
directory containing all available replays.
StarCraftII directory structure:
StarCraft II/
Battle.net/
Maps/
Replays/
SC2Data/
Versions/
If Py2SC was downloaded using this script, the Py2SC source code resides in:
~/.local/share/virtualenvs/sc2l_setup-{ENV-ID}/lib/python3.6/site-packages/pysc2
Where {Env-ID}
is randomly generated via pipenv.
List of all maps: python -m pysc2.bin.map_list
List of all available actions' python -m pysc2.bin.valid_actions
Watch a replay: python -m pysc2.bin.play --replay <path-to-replay>
Play as a human: python -m pysc2.bin.play --map <map-name>
In case you are not familiar with the -m
flag (module-name flag), an extract from the man python
documention:
-m module-name
Searches sys.path for the named module and runs the corresponding .py file as a script.
Ladder maps are maps played by human players on Battle.net. A few are active at a time. Every fewmonths a new season brings a new set of maps.
Melee maps are made specifically for machine learning. The Flat maps have no special features on the terrain, encouraging easy attacking. The number specifies the map size.
The Simple maps are more normal with expansions, ramps, and lanes of attack, but are smaller than normal ladder maps. The number specifies the map size.
PySC2 environment documentation
PySC2 Mini-Games documentation
PySC2 Maps documentation
PySC2 repository
Blizzard Starcraft II client repository
DeepMind StarCraft II Paper
Extra mini-games