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

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.

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.

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

You can try out this AI most easily by grabbing one of the UMS maps from the latest release. Remember to select "Use Map Settings" when starting the game. This unfortunately limits you to playing on just one map, you can only play 1v1, and the AI tends to begin performing badly at some point in the midgame due to differences between UMS and melee game modes.

For a more complete experience, you'll want to actually 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.
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.

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

• 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

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.