Main Page
From Starcraft 2 AI
Welcome to the SC2 AI Wiki! Signup on this wiki is disabled due to spam. If you want an account please message Crypt on our Discord
Contents
Latest Updates[edit]
Getting started[edit]
To get started with bot development, the following resources might be helpful:
- C++
- C++ Library - by alkurbatov
- Official C++ SC2 library by Blizzard. **This is no longer functional**
- Example bots:
- - Empty bot ready for the ladder
- - Modified, ladder-ready CommandCenter based on...
- - Original CommandCenter, a bot capable of using configurable strategies. Often used as a foundation for other bots and a good starting point to see how to use the C++ library.
- Python
- Python-sc2, an easy-to-use library for writing StarCraft II AI Bots in Python 3.
- Example bots:
- sharpy-sc2, a Python framework for rapid development of Starcraft II AI bots. Built on top of python-sc2.
- PySC2, a Starcraft II machine learning environment by DeepMind in Python.
- Example bots:
- - How To: PySC2
- - StartCraft II Reinforcement Learning Examples
- - Starter notebook for StarCraft II Machine Learning on Google Colab.
- - PySC2 bots can play on the ladder through this interface.
- How to make exe from python scripts using Pyinstaller
- C#
- A C# Starterkit - a simple and fully self-contained example of a C# StarCraft 2 bot (ladder ready).
- Abathur - Early version of a modular framework for .NET Core written in C#
- NydusNetwork - StarCraft II Client API for .NET Core written in C#
- Example bots:
- - AbathurBot - Clone n' Play repository for launching the Abathur framework.
- - Tyr - Source code for the bot Tyr. It plays all three races.
- A blank example bot written in C#, ready to play on the ladder (WIP)
- StarCraft II Client API for .NET written in F# (out of date)..
- Sharky - An easy to use and extensive open source C# .NET 5 framework for creating bots with any race. It contains a ready to run example bot and is used by sharkbot and whalemean. Create your first bot with a video tutorial
- Java
- Ocraft S2Client - StarCraft II Client - Java library supported on Windows, Linux and Mac designed for building scripted bots and research using the SC2API.
- Documentation and tutorial with example bot:
- - Guide on how to set up a bot with Ocraft
- Clojure
- cljsc2 lets you use the StarCraft II AI API from Clojure.
- JavaScript (Node.js)
- @node-sc2/core, a lightweight, modular framework for writing Starcraft 2 bots in JavaScript.
- Example bots:
- Testing
- If you want to test your bots locally against other bots try this.
- Other resources
- The Protobuf protocol definition of the SC2 API.
- Daily replay packs of the most recent SC2 version.
- Docker image for building and running the SC2API on Linux.
- SC2API Documentation.
- Analyze StarCraft II replays with Jupyter Notebooks.
- Train your agent on mini-games.
- Overseer - Library for analyzing Starcraft 2 maps by region decomposition.
- TechLab, a C++ library inspired by CommandCenter that aims to make it easier to write bots.
- JavaScript definitions
- Miscellaneous
- On your local machine: /Documents/StarCraft II/stableid.json. Units, abilities, buffs etc. are identified by IDs. This gives you a list of ALL! IDs.
- You can export all balance data from all three expansions as XML. Galaxy Editor --> File > Export Balance Data.
Tutorials[edit]
- Steven Brown's (@skjb) PySC2 tutorial series:
- Chris' StarCraft II RL Tutorial (PySC2):
- sentdex python-sc2 tutorial series:
- Bits of Code Series:
- Sharky C# .NET:
Wiki[edit]
Improve this Wiki by visiting Under Construction and updating with your own ideas and content!
You can always add descriptions of new bots or tournaments, if you know some that are not listed here yet.
FAQ[edit]
- Q: How many times game updates per second? How many logical frames there are in a single second?
- A: At normal game speed there are 16 logical frames, i.e. game updates 16 times per second, while at faster game speed there are 22.4 frames per second or 7/5 of normal speed or 40% more than normal speed.
Bots[edit]
Please help growing this Wiki by adding your own bot!
| Bot | Author | |||
|---|---|---|---|---|
| 4raxBot | 
|
ImpulseCloud (Michael Holtan) | ||
| 5minBot |
|
Archiatrus | ||
| Aladdin |
|
Mengjia,Chris,Sandy,Seven | ||
| B.R.A.D | Tyler McNamara (The Whopper) | usa | ||
| BlinkerBot | 
|
IarfMoose | ||
| BotWithAPlan |
|
Cephei (Daniel deLamare) | ||
| ByunJR |
|
Ian Gallacher (TheDoctor) | ||
| CCZergBot | 
|
Cryptious | ||
| CannonLover |
|
Hannessa | ||
| CreepyBot |
|
BurnySc2 | ||
| CryptBot |
|
Cryptious | ||
| Dub |
|
Dub(heikki) | ||
| HjaxAI |
|
Hjax | ||
| M1ndb0t |
|
M1ndgames | ||
| MicroMachine |
|
Raphael Royer-Rivard | ||
| MozzarellaBot |
|
Pikachu | ||
| NaughtyBot |
|
NikEy | ||
| QBot |
|
Qriz (Kristoffer Smed) | ||
| SeeBot |
|
AiSee | ||
| SwarmBot |
|
Swarm | ru | |
| Tyr | 
|
Simon Prins | ||
| YoBot |
|
YannTM |
Tournaments & Ladders
- The sc2ai.net Ladder offers an ELO-based continuous ranking system via a network-based API. The current season is Season 8. See here for details on the upcoming Season 8 Tournament. Ladder Maps
- Probots Is a regular tournament run by ESChamp
- AIArena Is a Linux based SC2 ladder
- StarcraftGym Provides leaderboards of minigame learning agents
Community[edit]
- Discord is the main way of communication at the moment. If you don't have an account yet, but are interested in SC2 AI development, you should definitely consider creating one.
- Youtube channel of sc2ai.net
- Twitter of sc2ai.net
- /r/sc2ai Subreddit
- Facebook Group
- List of community members
- German AI Discord server for general AI discussion in native language
Development/AI Livestreams[edit]
You can subscribe to the following channels and get notified when a stream goes live:
- StarCraft2 AI: 24/7 Sc2 AI ladder games
- Steven Brown: pysc2 AI development and tutorial
- TheDoctor: AI development with the C++ API
- Cryptious: Development and tournaments
- randomizer: AI development
- turingsego: AI development
Conferences / Research whitepapers[edit]
- Announcement of the StarCraft II AI research environment.
Strategy[edit]
Random / Culture[edit]
Interviews or shows about bot devolpment for StarCraft:
- A History of AI Research in StarCraft AI and Games.
- Inside the Champ - StarCraft II AI Report 1, 2, 3.
- ProBots Maker Moments - RaphRR & Unusual
Fun stuff about Starcraft and Deep Learning / AI:
