DriversRecommendedOutdated drivers can make a good PC feel brokenScan driver issues before chasing fixes manually.Scan NowOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan Now×
Skip to content
VGSources
Blog

StarCraft II Bot Frameworks Compared: Which One Should You Use?

For Python scripted bots, BurnySc2 is a practical starting point; C++ developers should consider Blizzard’s reference API, while learning research may suit PySC2.
Length5 min Posted Quest giverVGSources Team
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

For a conventional scripted bot in Python, start with BurnySc2’s python-sc2 package, distributed as burnysc2. It offers high-level game objects alongside lower-level access and includes quick-start examples. Choose Blizzard’s s2client-api if you want to build in C++ against the reference client library; consider PySC2 when your work is centered on learning-environment or reinforcement-learning research. There is no published, comparable benchmark here that establishes one framework as universally fastest or best.

How the frameworks differ

These options serve overlapping but distinct goals: writing a bot that issues game commands, working close to the Blizzard API, or building a research workflow around the StarCraft II Learning Environment. The comparison below is based on documented interfaces and setup, not a controlled performance test.

As an Amazon Associate I earn from qualifying purchases.

Framework Best fit Language and approach Setup and cautions
BurnySc2 python-sc2 / burnysc2 Scripted bots, especially for Python users who want examples and convenient game objects Python 3; higher- and lower-level abstractions, including BotAI and asynchronous on_step examples Requires Python 3.9 or newer, a StarCraft II client and maps. The project describes support for the raw scripted interface, not graphics-based interfaces. Its fork may diverge from Dentosal’s version, so older tutorials may no longer work. BurnySc2 project README; BurnySc2 documentation
Blizzard s2client-api C++ scripted bots, API-level control, or projects that want Blizzard’s reference client library C++; wraps the protobuf protocol and exposes interfaces such as Agent, ObservationInterface and ActionInterface Build the API client first; examples also need the StarCraft II executable path. Official API documentation was generated several years ago, so check repository instructions for current build details. Blizzard API documentation and repository; Blizzard protocol repository
PySC2 Learning-environment and reinforcement-learning research Python environment wrapper for the StarCraft II Learning Environment Blizzard’s protocol project lists it as a community tool. Foundational SC2LE research describes the research interface, but current installation and compatibility details are not established by the sources cited here. Blizzard protocol repository; SC2LE research paper
CommandCenter A possible alternative bot-development architecture Not stated in the cited source The Blizzard protocol repository lists it as a community architecture, but the cited material does not establish its language, setup requirements or current maintenance. Blizzard protocol repository

Which framework should you use?

Choose BurnySc2 for a conventional Python bot

BurnySc2 is the clearest starting point if you want to write direct game logic in Python: observe the current state, decide what to do, and issue commands. Its project describes itself as “An easy-to-use library for writing AI Bots for StarCraft II in Python 3.” The project README and documentation provide examples, including a BotAI subclass with an asynchronous on_step method. Use it when its higher-level convenience is useful, while retaining the option to work at a lower level.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

BurnySc2’s project says its fork can diverge from Dentosal’s version. That matters when following older tutorials: check that a guide’s code matches the package and documentation version you install rather than assuming the examples remain interchangeable.

#1 Best Overall
StarCraft II: Wings of Liberty
  • Fast-paced, hard-hitting, tightly balanced competitive real-time strategy gameplay that recaptures and improves on the original game
  • Three completely distinct races: Protoss, Terran, and Zerg
  • Units and gameplay mechanics distinguish each race
  • 3D-graphics engine with support for visual effects and massive unit and army sizes
  • Full multiplayer support, with competitive features and matchmaking utilities available through Battle.net

Choose Blizzard’s s2client-api for C++ and reference-level interfaces

If C++ is your preferred language, or you want to work directly with Blizzard’s reference client library, s2client-api is the natural candidate. Its ObservationInterface exposes a snapshot of game state and visible units; its ActionInterface is used to issue commands such as moving, attacking or building. The trade-off is a more explicit setup path: the client library must be built, and examples need the StarCraft II executable path.

Consider PySC2 for learning-environment research

PySC2 is better considered as an environment-oriented interface than as a direct substitute for a beginner-friendly scripted-bot library. It is relevant when the project is built around learning workflows or reinforcement learning. The foundational SC2LE paper explains the research environment, but the cited sources do not establish PySC2’s present-day maintenance status or provide a current end-to-end setup guide; verify compatibility with your intended StarCraft II installation before committing.

Treat CommandCenter as an option to investigate, not a documented head-to-head choice

Blizzard’s protocol repository lists CommandCenter among community architectures. The available source material does not provide enough current primary documentation to compare its language, setup or maintenance fairly with the other options.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #2
Starcraft II: Legacy of the Void - Standard Edition
  • This is a standalone product. It does not require any other version of StarCraft II to play
  • Internet Connection Required
  • Battle.net registration and Battle.net Desktop Application required
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

What to check before setting up

BurnySc2

The documented prerequisites are Python 3.9 or newer, a StarCraft II installation in the expected location, and maps. The repository gives this installation command:

pip install --upgrade burnysc2

On Linux or WSL, consult the project’s configuration guidance rather than assuming a default desktop installation path will work. A basic bot subclasses BotAI, implements async def on_step(...), and is launched with run_game. The documentation also describes options such as game step and distance-calculation method; treat them as configuration controls, not guaranteed performance boosts. Repository and installation details; Usage documentation.

Blizzard’s C++ API

Start from the API repository and build its sc2api-client before following getting-started examples. Those examples require a path to the StarCraft II executable. Use the protocol repository for the protocol definitions and related resources, and check the repository’s current build instructions because the generated API documentation is several years old.

Rank #3
Starcraft II PC
  • Videogame Software

PySC2 and other community architectures

The protocol repository identifies PySC2 and CommandCenter as community tools or architectures, but that listing alone is not a current compatibility or maintenance guarantee. For either, confirm the project’s own installation instructions against the client build, operating system and maps you intend to use.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

How to make the decision

  • Language: Python points toward BurnySc2 for scripted bots or PySC2 for learning-environment work; C++ points toward Blizzard’s reference API.
  • Agent style: Choose a scripted-bot interface when you want to implement game rules and command logic directly. Choose an environment interface when the project centers on research or learning workflows.
  • Setup: Plan for a compatible StarCraft II client and suitable maps or runtime setup whichever route you take. The C++ reference path additionally requires building the API client.
  • Abstraction: BurnySc2 offers higher-level game objects as well as lower-level access. Blizzard’s API presents observations and actions through explicit interfaces.

Do not choose on an assumed speed advantage: the cited project materials do not provide a common benchmark. A valid speed comparison would need to hold constant the StarCraft II version, map, machine and bot workload.

What the Blizzard protocol supports

Blizzard describes the protocol as supporting scripted bots, machine-learning bots, replay analysis and tool-assisted play. Its protocol project brings together official definitions, a reference C++ implementation, Linux packages, maps and replay resources, and links to community tools including PySC2. Blizzard’s protocol repository.

Quick Recap

Bestseller No. 1
StarCraft II: Wings of Liberty
StarCraft II: Wings of Liberty
Three completely distinct races: Protoss, Terran, and Zerg; Units and gameplay mechanics distinguish each race
$7.59
Bestseller No. 2
Starcraft II: Legacy of the Void - Standard Edition
Starcraft II: Legacy of the Void - Standard Edition
Internet Connection Required; Battle.net registration and Battle.net Desktop Application required
$42.94
Bestseller No. 3
Starcraft II PC
Starcraft II PC
Videogame Software
$21.45

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More quests from Patch Notes

  1. How to Set Up a RedM (RDR2) Server in 2026: License Key, txAdmin and server.cfg, Step by StepBlog11min
  2. Best RedM (RDR2) Server Hosting in 2026: Comparing Four Hosts on Slots, Memory and PriceBlog10min
  3. How to Host a Mindustry Server in 2026: server-release.jar, Port 6567 and the Commands That MatterBlog7min
Recommended PC Tool
Recommended PC Tool
Windows Errors? Fix Them Before They SpreadFree repair scan
Outdated Drivers Are Slowing You DownFree scan - exact matches

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.