A StarCraft Brood War AI designed to follow the modern 1v1 metagame
Switch branches/tags
Nothing to show
Clone or download
Latest commit ca782f6 Dec 15, 2018



Build Status

A Brood War AI designed to follow the modern 1v1 metagame.

Zeal Goon vs Mech


This project seeks to create an AI that provides a unique experience in each game while closely mirroring builds and unit compositions used by humans today.

Muta Harass

This provides a much stronger learning experience for new players compared to the Blizzard AI. Players are encouraged to scout, learn what the AI is doing, and adapt instead of turtling up. The AI tends to avoid all-in strategies in favor of economic builds, but it also includes a number of rushes to make scouting and early defense important.

Large bio attack

The included screenshots are from real AI vs AI games to demonstrate the unit compositions used in different matchups.


You need to overwrite the default scripts that Brood War uses for melee games. This allows you to play in any game mode that supports computer opponents, including multiplayer if you are both properly patched to the same version of BWMetaAI. Here's how to patch Brood War:

  1. If using StarCraft 1.18 or greater, open the Blizzard app and update Brood War before continuing. This step is critical as the updater will replace the file we're about to patch.
  2. Browse to your StarCraft folder and make a backup copy of patch_rt.mpq just in case something goes wrong.
  3. Download the latest patch_rt.mpq from the releases and save it over your current patch_rt.mpq.
  4. Run StarCraft Brood War and play a game with an AI opponent. If the AI is running correctly you will recieve a message from the AI letting you know it is running.

Build Orders

BWMetaAI includes a number of build orders that have been relatively popular in high level play. Once the initial build is completed, one of several common midgame transitions are used to take the AI into a variety of late game pushes.


  • Siege Expand
  • 1 Rax FE
  • 2 Rax FE
  • 2 Rax Pressure
  • BBS
  • 14 CC
  • 2 Factory Vulture
  • 2 Factory Tank/Vulture
  • +1 5 Rax
  • 2 port wraith
  • Fantasy
  • Fake Mech


  • 5 Pool
  • 1 Base Lurker
  • 4 Hatch Lair
  • 4 Hatch before Gas
  • 2 Hatch Muta
  • 3 Hatch Muta
  • 9 Pool Speed into Spire
  • 9 Hatch
  • Overgas


  • Forge Fast Expand
  • 1 Gate Zealot Expand
  • 12 Nexus Expand
  • 2 Gate Range Expand
  • ZcoreZ Expand
  • 10/15 Gate Dragoon Pressure
  • 2 Gate Corsair
  • 9/9 Gate Zealots
  • 10/12 Gate Zealots
  • Fast DT
  • ZcoreZ Reaver

Late game

Once the AI has many bases and all useful tech, it jumps into a loop of common late game unit compositions.


  • Mech
  • Battlecruisers
  • SK in TvZ only


  • Muta-ling
  • Lurker-ling-defiler
  • Ultra-ling-defiler
  • Hydra


  • Zealot Dragoon Arbiter
  • Zealot Archon
  • Carriers


This project doesn't seek to perform especially well against either humans or other AIs. Advanced techniques such as those used in BWAPI are not used. This project only rewrites the internal AI scripts that Brood War uses to decide what to build next and when to attack. This is done primarily to make it very simple to get up and running.

Micro and building placement are still extremely poor. The AI targets most spells poorly, sieges tanks at terrible times, unburrows lurkers to chase things that have gone out of range, wanders around instead of attacking wall-ins, and makes all sorts of other mistakes that good humans would not. Playing against one AI should provide a good learning environment for a newer player. Playing against two or three of these at once can still provide a challenging experience even for decent players.

With all of that in mind, if you find behavior that you think can reasonably be addressed (e.g. you DT rush a computer and it doesn't attempt to build detection), feel free to open an issue.