Update AI Arena maps link and improve map download instructions and formatting.
@@ -30,10 +30,21 @@ pip install --upgrade --force-reinstall https://github.com/BurnySc2/python-sc2/a
```
Both commands will use the `sc2` library folder, so you will not be able to have Dentosal's and this fork installed at the same time, unless you use virtual environments or pipenv.
+### StarCraft II
You'll need an StarCraft II executable. If you are running Windows or macOS, just install the normal SC2 from blizzard app. [The free starter edition works too.](https://us.battle.net/account/sc2/starter-edition/). Linux users get the best experience by installing the Windows version of StarCraft II with [Wine](https://www.winehq.org). Linux user can also use the [Linux binary](https://github.com/Blizzard/s2client-proto#downloads), but it's headless so you cannot actually see the game.
-You probably want some maps too. Official map downloads are available from [Blizzard/s2client-proto](https://github.com/Blizzard/s2client-proto#downloads). Notice: the map files are to be extracted into *subdirectories* of the `install-dir/Maps` directory.
-Maps that are run on the [SC2 AI Ladder](http://sc2ai.net/) and [SC2 AI Arena](https://ai-arena.net/) can be downloaded [from the sc2ai wiki](http://wiki.sc2ai.net/Ladder_Maps) and [the ai-arena wiki](https://ai-arena.net/wiki/getting-started/#wiki-toc-maps).
+### Maps
+You probably want some maps too.
+
+#### Official maps
+Official Blizzard map downloads are available from [Blizzard/s2client-proto](https://github.com/Blizzard/s2client-proto#downloads).
+Extract these maps into their respective *subdirectories* in the SC2 maps directory.
+e.g. `install-dir/Maps/Ladder2017Season1/`
+
+#### Bot ladder maps
+Maps that are run on the [SC2 AI Ladder](http://sc2ai.net/) and [SC2 AI Arena](https://ai-arena.net/) can be downloaded [from the sc2ai wiki](http://wiki.sc2ai.net/Ladder_Maps) and [the ai-arena wiki](https://ai-arena.net/wiki/bot-development/getting-started/#wiki-toc-maps).
+**Extract these maps into the *root* of the SC2 maps directory** (otherwise ladder replays won't work).
+e.g. `install-dir/Maps/AcropolisLE.SC2Map`
### Running
