Bot authors must ensure that their creations are not harming the ladder system in any way, including but not limited to:
For a successful upload the Bot must be packed using zip. (Max 50 MB)
Please make sure that the file the bot is called via (e.g. the executable) is in the root path after extraction (Don't zip the directory).
MyBot.zip - MyBot.exe - data/ - etc
MyBot.zip - MyBot/ - MyBot.exe - data/ - etc
The bots may write to a
./data directory. Any files in the data directory will persist between games.
The data can be downloaded via profile page.
The Ladder supports multiple programming languages. To make sure the bot works on the ladder you must follow the following standards:
Version: Python 3.7
Bot called via run.py
python-sc2: (Recommended for beginners)
Popular interface for scripted and machine learning bots alike.
Video tutorials: https://www.youtube.com/playlist?list=PLkelvgAj0mwzjVuJK4FBo7YR9ukXCzAsy
Deepmind's interface - focussed around machine learning.
A rapid bot development framework. Solid macro and micro right out of the box.
Can be compiled on Windows or Linux
Windows: Bot called via botname.exe
Linux: Bot called via botname
Version: Java 12 (OpenJDK)
Bot called via botname.jar
Bot called via botname
Version: DotNetCore 2.2
Bot called via botname.exe
Example bot: Example C# Bot
Bot called via botname Website: rust-sc2
Bot called via botname.js
It is generally useful to review some existing bots as reference in order to see how certain problems are solved by other authors, or to utilize these bots as a starting point in order to not have to solve these problems at all.
Note that if you choose to copy an existing bot, please make sure you have the bot author's permission and that you make attempts to modify/improve the bot in some way. It's also nice to note the origin of the bot in your new bot's biography on the website.
Alkurbatov also maintains a list of some open source bots: https://github.com/alkurbatov/suvorov-bot/wiki/Open-source-StarCraft2-bots
Download the latest ladder pack from the GitHub Repository. (Password: 'iagreetotheeula')