Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
May 15, 2023 13:27
January 28, 2016 14:44
December 16, 2018 23:28
December 26, 2012 12:47
May 15, 2023 13:29
August 29, 2021 07:32


build DOI

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:

StarCraft Remastered Samase Method (version 1.18+)

  1. Get Samase
  2. Get aiscript.bin from BWMetaAI's releases
  3. Make the directory layout like this:
    • StarCraft\x86\StarCraft.exe
    • StarCraft\x86\sesame.exe
    • StarCraft\x86\custom\scripts\aiscript.bin
  4. Make a shortcut to sasame.exe and add custom as a command line parameter.
  5. Run StarCraft using this shortcut

Version 1.16.1 and lower

  1. Browse to your StarCraft folder and make a backup copy of patch_rt.mpq so you can revert to the standard AI.
  2. Download the latest patch_rt.mpq from the releases and save it over your current patch_rt.mpq.
  3. Run StarCraft Brood War and play a non-custom game with an AI opponent. If the AI is running correctly you will receive 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.


Terran vs Terran

  • BBS
  • 14 CC
  • Siege Expand
  • 2 Factory Tank/Vulture
  • 2 Factory Vulture

Terran vs Zerg

Terran vs Protoss

  • BBS
  • 14 CC
  • Siege Expand
  • 2 Factory Tank/Vulture
  • 2 port wraith


Zerg vs Terran

  • 5 Pool
  • 1 Base Lurker
  • 2 Hatch Muta
  • 3 Hatch Muta

Zerg vs Protoss

  • 5 Pool
  • 1 Base Lurker
  • 3 Hatch Muta
  • 4 Hatch before Gas
  • 4 Hatch Lair

Zerg vs Zerg

  • 5 Pool
  • 9 Pool Speed into Spire
  • 9 Hatch
  • Overgas


Protoss vs Terran

  • 2 Base Carrier
  • 2 Gate Range Expand
  • 10/15 Gate Dragoon Pressure
  • 1 Gate Zealot Dragoon Pressure
  • 12 Nexus

Protoss vs Zerg

  • Forge Fast Expand
  • 10/12 Gate Zealots
  • 1 Gate Zealot Expand
  • 2 Gate Corsair
  • 9/9 Gate Zealots
  • 2 Gate Dark Templar

Protoss vs Protoss

  • 12 Nexus
  • ZcoreZ Expand
  • ZcoreZ Reaver
  • 10/12 Gate Zealots
  • 9/9 Gate Zealots
  • 2 Gate Dark Templar

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.