[TOC] # Terms Of Usage Please see the [Terms Of Usage](https://aiarena.net/wiki/rules/) Page # Bot Development ### Bot Types The Ladder supports multiple programming languages and are listed as follows: #### **Python** * **[python-sc2](https://github.com/BurnySc2/python-sc2):** (Recommended for beginners): Most popular/supported interface for scripted and machine learning bots alike. * [StarCraft 2 Bot: Python Setup Guide](https://youtu.be/MnZkimzoaLA) * [How to create an AI BOT • STARCRAFT 2](https://youtu.be/qpxdB67wJIk) * **[sharpy-sc2](https://github.com/DrInfy/sharpy-sc2)**: A rapid bot development framework. Solid macro and micro right out of the box. Starter kit: [Sharpy starter bot](https://github.com/DrInfy/sharpy-starter-bot) - **[pysc2](https://github.com/deepmind/pysc2)** Deepmind's interface - focused around machine learning. #### **C++** Can be compiled on Windows or Linux Windows: Bot called via botname.exe Linux: Bot called via botname **cpp-sc2** Base C++ API for sc2. Website: [cpp-sc2](https://github.com/cpp-sc2/cpp-sc2/) **CommandCenter** A feature-rich starting bot for C++. Website: [CommandCenter](https://github.com/cpp-sc2/commandcenter) #### **Java** Version: Java 12 (OpenJDK) Bot called via botname.jar Website: [ocraft-s2client](https://ocraft.github.io/ocraft-s2client/) #### **.NET Core** - **Tyr** -- [Bare wrapper bot](https://github.com/SimonPrins/ExampleBot) -- [Tyr Bot](https://github.com/SimonPrins/TyrSc2) - **Schmidt** -- [NydusNetwork API Wrapper](https://adequatesource.com/nydusnetwork/) -- [Hello Marine tutorial for Abathur Framework](https://adequatesource.com/hello-marine/) - **[Sharky Framework](https://github.com/sharknice/Sharky)** #### **GoLang** Bot called via botname Website: [go-sc2ai](https://github.com/chippydip/go-sc2ai) #### **Rust** Bot called via botname Website: [rust-sc2](https://github.com/UltraMachine/rust-sc2) #### **NodeJS** Version: 12 Bot called via botname.js Website: [node-sc2/core](https://github.com/node-sc2/core) # Using existing bots as a reference or starting point 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. Some bots on the bot ladders are open source and can either be downloaded or provide links to their source. Browse the list of AI Arena <https://aiarena.net/bots/> or SC2AI <http://sc2ai.net> bots. 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> # Maps Download the latest ladder pack from the [GitHub Repository](http://blzdistsc2-a.akamaihd.net/MapPacks/Ladder2019Season3.zip). (Password: 'iagreetotheeula') # Bot Zip To make sure the bot works on the ladder you must follow the following standards: 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**). **Right:** ``` MyBot.zip - MyBot.exe - data/ - etc ``` **Wrong:** ``` MyBot.zip - MyBot/ - MyBot.exe - data/ - etc ``` ### Data 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.