StarCraft Brood War Data Mining

If you want to do some data mining or machine learning on StarCraft Brood War, don't reinvent the wheel. This is a compendium of all the work done. Just remember to notify me (albertouri[at]drexel[dot]edu) if you do something to keep this web updated.

Replay websites

First of all you need some replays (game log files) to do your data mining. There are some websites where you can find replays from professional gamers (a.k.a. gosu). It's important to notice that if you want to analyze the replays using BWAPI, you would need replays played in the last version of StarCraft Brood War (1.16.1).

• [W1] GosuGamers. Since 04-14-2013 they aren't adding new replays. 7,930 replays.
• [W2] ICCup. Still active professional game server with regular tournaments.
• [W3] TeamLiquid. Professional community with regular tournaments.
• [W4] RepDepot. Replay repository with more than 56,600 replays (gosu and user). Currently OFFLINE
• [W5] Reps.Ru
• [W6] yaoyuan.com
• [W7] ygosu.com
• [W8] defiler.ru
• [W9] bwreplays.com. Compilation of all the previous sites

Replay crawler

Downloading all the replays by hand it's a really time consuming task, you should use a crawler to automatize this process. Keep in mind that the same replay can be stored in different websites, so it's a good practice to check the hash of the replay to look for duplicates. Some replays could be corrupted.

• Broodwar Replay Scrappers. Developed by Gabriel Synnaeve in Python. It downloads replays from [W1], [W2] and [W3].
• Tutorial how to create your own crawler.

Replay packages

Once you gather a nice amount of replays, it's nice to offer your replay package to the research community to be able to reproduce your results and compare it with new approaches. The map of the replay is included inside each replay file.

ID	Link	Size	# Replays	Sources	Author	Notes
[R1]	Download	1.2 GB	5493	[W1][W2][W3]	Ben Webber	Contain replays from previous versions of StarCraft not compatible with BWAPI
[R2]	Download	359 MB	6000	?	Fobbah	Only Zerg replays (versus Zerg, Protoss and Terran)
[R3]	Download	644 MB	7649	[W1][W2][W3]	Gabriel Synnaeve	No duplicates
[R4]	Download	54 MB	1029	[W2]	Gabriel Synnaeve	Users replays (not professional players)
[R5]	Download	63 MB	509	[W2]	Tom Dietterich	Only Protoss vs Terran

Replay analyzers

Now is time to parser the replays. For this we have two options, parser the replay file or parser the BWAPI events/states. The first one we don't need to play the replay on StarCraft, but we only have the click commands of the players and we need to decode the binary replay files. Using BWAPI we can record all game events and all states of the units, even simulate the fog of war, but we need to play each replay in StarCraft.

ID	Name	Language	Type	Based on	Notes
[A1]	LordMartin Replay Browser	-	File Parser		Source code not available
[A2]	BWChart	C++	File Parser
[A3]	RepASsiMilator	C++ (PHP)	File Parser	[A2]	PHP extension
[A4]	bwhf	Java	File Parser
[A5]	bwrepanalysis	Java, C++	File Parser + BWAPI events	[A4]	BWAPI events recorded: economy 25 frames, tech 1 frame, vision 12 frames, orders 1 frame, unit location 100 frames or new order
[A6]	bwrepdump	C++	BWAPI events	[A5]	BWAPI events recorded: economy 25 frames, tech 1 frame, vision 12 frames, orders 1 frame, unit location 100 frames or new order, 1 frame during attacks
[A7]	ScExtractor	Java	File Parser + BWAPI events	[A4]	BWAPI events recorded: 24 frames OR user action frames OR 24 frames, 7 frames during attacks
[A8]	bwrepdump2	C++	BWAPI events	[A6]	Updated version and extended to extract combat records

Datasets

After parsing the replays you will have a clean dataset ready to apply machine learning techniques. Each dataset has been created with some data mining in mind, so maybe they don't capture the information that you want or with the granularity you need. So feel free to create your own dataset using a replay analyzer.

ID	Link	Size	Sources	Notes
[D1]	Download	1.7 MB	[R1]	ARFF files to use with Weka. Script used to label each player actions with a build order (early game strategy), i.e. supervised learning.
[D2]	Download	870 MB	[R2][A5]	For each replay it provides 3 plain text files: RGD (Replay Game Data), RLD (Replay Location Data) and ROD (Replay Order Data).
[D3]	Download	2.1 GB	[R3][A6]	For each replay it provides 3 plain text files: RGD (Replay Game Data), RLD (Replay Location Data) and ROD (Replay Order Data). Warning: not up-to-date with last version of A6.
[D4]	Download	19.6 GB	[R3]1[A7]	Provides SQL files to populate a Data Base with the following structure. Recorded state changes (all unit attributes) each 24 frames.
[D5]	Download	63.3 MB	[R5]	Contains the opening build choices of the Protoss player in the first 7 minutes of the game, as well as information about what the Terran player could see during this time. The objective is to predict the Protoss player's choices using the information available to the Terran player.

¹ Uses a subset of [R3] after detecting some replays with errors.

Papers

Some research publications that used a dataset (or a replay analyzer) from the previous section.

• [A1] (2008) Building a Player Strategy Model by Analyzing Replays of Real-Time Strategy Games. Ji-Lung Hsieh, and Chuen-Tsai Sun
• [D1] (2009) A Data Mining Approach to Strategy Prediction. Ben Weber and Michael Mateas
• [A2] (2010) Cooperative Learning by Replay Files in Real-Time Strategy Game. Jaekwang Kim, Kwang Ho Yoon, Taebok Yoon, and Jee-Hyong Lee
• [W2,A4] (2011) A Corpus Analysis of Strategy Video Game Play in Starcraft: Brood War. Joshua M. Lewis, Patrick Trinh and David Kirsh
• [D3] (2012) A Dataset for StarCraft AI & an Example of Armies Clustering. Gabriel Synnaeve and Pierre Bessière
• [D5] (2012) Inferring Strategies from Limited Reconnaissance in Real-time Strategy Games. Jesse Hostetler, Ethan W. Dereszynski, Thomas G. Dietterich, Alan Fern
• [D4] (2014) An Improved Dataset and Extraction Process for Starcraft AI. Glen Robertson and Ian Watson
• [A8] (2015) Automatic Learning of Combat Models for RTS Games. Alberto Uriarte and Santiago Ontañón