• Log InLog In
  • Register
Liquid`
Team Liquid Liquipedia
EST 19:14
CET 01:14
KST 09:14
  • Home
  • Forum
  • Calendar
  • Streams
  • Liquipedia
  • Features
  • Store
  • EPT
  • TL+
  • StarCraft 2
  • Brood War
  • Smash
  • Heroes
  • Counter-Strike
  • Overwatch
  • Liquibet
  • Fantasy StarCraft
  • TLPD
  • StarCraft 2
  • Brood War
  • Blogs
Forum Sidebar
Events/Features
News
Featured News
RSL Revival - 2025 Season Finals Preview8RSL Season 3 - Playoffs Preview0RSL Season 3 - RO16 Groups C & D Preview0RSL Season 3 - RO16 Groups A & B Preview2TL.net Map Contest #21: Winners12
Community News
ComeBackTV's documentary on Byun's Career !6Weekly Cups (Dec 8-14): MaxPax, Clem, Cure win4Weekly Cups (Dec 1-7): Clem doubles, Solar gets over the hump1Weekly Cups (Nov 24-30): MaxPax, Clem, herO win2BGE Stara Zagora 2026 announced15
StarCraft 2
General
ComeBackTV's documentary on Byun's Career ! When will we find out if there are more tournament Weekly Cups (Dec 8-14): MaxPax, Clem, Cure win Did they add GM to 2v2? RSL Revival - 2025 Season Finals Preview
Tourneys
RSL Offline Finals Info - Dec 13 and 14! Master Swan Open (Global Bronze-Master 2) Winter Warp Gate Amateur Showdown #1: Sparkling Tuna Cup - Weekly Open Tournament $5,000+ WardiTV 2025 Championship
Strategy
Custom Maps
Map Editor closed ?
External Content
Mutation # 504 Retribution Mutation # 503 Fowl Play Mutation # 502 Negative Reinforcement Mutation # 501 Price of Progress
Brood War
General
FlaSh on: Biggest Problem With SnOw's Playstyle How Rain Became ProGamer in Just 3 Months BGH Auto Balance -> http://bghmmr.eu/ [BSL21] RO8 Bracket & Prediction Contest BW General Discussion
Tourneys
Small VOD Thread 2.0 [Megathread] Daily Proleagues [BSL21] WB SEMIFINALS - Saturday 21:00 CET [BSL21] RO8 - Day 2 - Sunday 21:00 CET
Strategy
Game Theory for Starcraft Current Meta Simple Questions, Simple Answers Fighting Spirit mining rates
Other Games
General Games
Stormgate/Frost Giant Megathread Path of Exile Nintendo Switch Thread General RTS Discussion Thread Dawn of War IV
Dota 2
Official 'what is Dota anymore' discussion
League of Legends
Heroes of the Storm
Simple Questions, Simple Answers Heroes of the Storm 2.0
Hearthstone
Deck construction bug Heroes of StarCraft mini-set
TL Mafia
Mafia Game Mode Feedback/Ideas Survivor II: The Amazon Sengoku Mafia TL Mafia Community Thread
Community
General
US Politics Mega-thread Things Aren’t Peaceful in Palestine The Games Industry And ATVI Russo-Ukrainian War Thread YouTube Thread
Fan Clubs
White-Ra Fan Club
Media & Entertainment
Anime Discussion Thread [Manga] One Piece Movie Discussion!
Sports
2024 - 2026 Football Thread Formula 1 Discussion
World Cup 2022
Tech Support
Computer Build, Upgrade & Buying Resource Thread
TL Community
TL+ Announced Where to ask questions and add stream?
Blogs
The (Hidden) Drug Problem in…
TrAiDoS
I decided to write a webnov…
DjKniteX
James Bond movies ranking - pa…
Topin
Thanks for the RSL
Hildegard
Customize Sidebar...

Website Feedback

Closed Threads



Active: 1554 users

Using BWAPI to take spectating to the next level!

Forum Index > BW General
Post a Reply
1 2 3 4 5 14 15 16 Next All
AssuredVacancy
Profile Blog Joined September 2008
United States1167 Posts
Last Edited: 2010-02-09 15:41:32
February 06 2010 04:42 GMT
#1
Feedback/suggestions strongly encouraged(esp. a good formula for a macro rating)

There was a bug with buildorder generation, please download the new version as the bug is fairly serious.

New Features(Latest update: customizable layout/more worker stats/display):
+ Show Spoiler +

A new worker stat is added: Total number of idle worker seconds as well as the total amount of minerals that could've been harvested by the idle workers.



The idle worker seconds work like this: if there are 4 idling workers idling for 1 second each, that's 4 worker seconds, it's the same if there's one worker idling for 4 seconds.
The number of minerals "missed" from idling is calculated by this:
if the worker is idling for that frame(1/24th of a second), the number of minerals missed is equaled to the instantaneous mining rate per frame of that player's workers divided by the number of workers.
E.g. If the player is on one base with 50 workers mining 8 patches, an idling worker will not increase the "amount of minerals missed" as much if the player is on one base with 4 workers mining 8 patches, simply because one added worker in the oversaturated mineral field is not going to be that big of a deal where as one added worker in an undersaturated mineral field makes a bigger impact.
This is a fairly accurate measurement of the amount of minerals missed from idling workers. This will help you refine your builds as you can see how much more minerals you could've gotten if you had better mechanics.

[image loading]


This was fairly late into the game, but you can see that the amount of minerals missed by both players is a pretty big amount. You can also see that the ratio of minerals:minutes is not the same. This is because the mining rates of each player is different when their workers are idling.

Units making in production facilities, research/upgrades, unfinished buildings are all labeled as you can't tell what they are unless you click on them. This just saves a bit of time:

[image loading]


The option to turn them off is in the settings file under the field "showHiddenNames".

The bug of not reading options correctly is also fixed.

The layout is now customizeable. As well as 5 new commands:

/hide <1 or 2>

Hide the info from player 1 or 2.

[image loading]




/unhide <1 or 2>

unhide the player info.


/load <layout scheme filename>

Loads a file containing a set of layout options. I included 2 basic files (basicinfo.ini, buildorder.ini)



/load basicinfo

[image loading]




/load buildorder

[image loading]




In the beginning of the replay the plugin will automatically load replaypp.ini. So just edit that file to your liking. The default file scheme is:
+ Show Spoiler +


showrally: 1
showworkerstats: 1
showmacrostats: 1
showorder: 1
showbuildorder: 1
showhp: 1
supplycount: 50
***************macrosettings:
Xcoordinate: 10
Ycoordinate: 10
productionFacCount: 1
queuedCount: 1
averageQueuedCount: 1
currentlyBuildingCount: 1
idleBuildingOrLarvaCount: 1
macroRating: 1
********************Workersettings:
xcoordinate: 300
ycoordinate: 10
workerCount: 1
miningMineralCount: 1
miningGasCount: 1
idleWorkerCount: 1
******************buildOrderSettings:
xcoordinate: 305
ycoordinate: 130
notify: 1



You can decide which info is displayed from changing to 1 or 0.
Notify is the option to turn off the notification everytime the buildorder list increases.




/default

loads replaypp.ini(the default file)




/notify

Toggles the notification of build orders.



Old:
The timing of RESEARCH/UPGRADES is now tracked throughout the whole game.

Throughout the game(even after the supply count limit), the timing of important tech structures, and the first instance of units is tracked.
E.g. If you want to practise a build that focuses on a midgame push with guardians, the timing/supply count of the FIRST guardian will be recorded regardless of what your supply is.

Throughout the whole game, the timing of EXPANSIONS will be recorded as well. This is not equivalent to a cc/hatch/nexus, as ONLY cc/hatch/nexus that serve as a mining base is recorded. E.g. you build a second hatch next to your first hatch, it's not counted as an expansion.


[image loading]

Poll: Should the info display in a window outside of BW?
(Vote): Definitely yes.
(Vote): Definitely no.
(Vote): Depends.. (state your condition)
(Vote): Fix your bugs before you do this!


Bug fixes:
Fixed the bug where you can't follow lurkers. You can follow lurkers all you want.
Fixed the bug where the game crashes if you type /highlight or /find or /follow with no parameters.
Fixed the bug where it can't recognize when lair/hive tech is.

Does this make you squeal in joy? If it does, you may donate to help the hungry college kid writing code here!




To update you just need to change the replaypp.dll, and replaypp.ini with the new one. No need to replace everything.

Instead of using bwapi to make an AI that does things for you, I made something that makes watching a replay/obsing a game on iccup, or even practising. This is replay++: it makes watching a replay as exciting as watching the TSL.


Features

Detailed Macro stats:

In addition to knowing only the resources/supply of each player, you now know many more useful stats that can help you analyse your own replays to become a better player.
[image loading]


This is taken from the infernal vs mondragon replay found in the replays section.

From the top to bottom:
First row: shows minerals, increase in minerals per minute, gas, increase in gas per minute, and supply.
Second row: # of production facilities built(in white), and currently building(in grey). If you're a zerg this shows the number of hatcheries.
Third row: # of units queued and how much minerals/gas is wasted in queueing. Zergs don't have this because they laugh at nubs queueing.
Fourth row: Average number of units queueing at any given time, and the corresponding resources. (Infernal's being a champ and has a super low queueing average)
Fifth row: Number of units building. Self explanatory. Zergs have the number of units morphing.
Sixth row: Number of production facilities not building stuff. This includes everything so it's normal to have 3-4 from robo bays, scouting raxes, etc. Zerg's equivalent to this is the number of idle larva at the time, as well as average.
Seventh row: Overall macro rating is something random formula that incorporates everything that I made up. It is by no means perfectly accurate or even useful. I just did it for kicks. But it's working here as you can see how mondi's rating's quite low as he is supply blocked, with 10 idle larvae.


Detailed worker stats:

[image loading]


This is pretty self explanatory. The number of patches currently being mined means the number of patches that are physically being mined, aka if a worker is returning cargo, the number of patches being mined is 0.


Real time build order generation:

[image loading]


This list is generated as the game is played. You can change up to how many supply the build order is being tracked. The default is 50, you can change it in the .ini file. A timestamp is provided here so you can compare your own times for each build order execution as you practise.
It also outputs the build order to a text file with the players names in the bwapi-data folder. Do not open the text file while the game is going or it will crash. It's safer for you to rename the text file to a unique name because the name is based on the 2 players. It's possible that it will be overridden by another game with the same players.

Chat commands

/count <unit name>

Entering this will make the AI count all the units with the specified name. The entered name has to be contained in the actual name of the unit.

[image loading]


/follow <unit name>

This will make your screen constantly follow the biggest group of the unit entered. You lose control of the screen until you type /unfollow. This is pretty entertaining for watching muta harass.
E.g
Entering /follow muta when there's a group of 7 mutas will make your screen constantly follow that group until a bigger group of mutas appear somewhere else or /unfollow

/unfollow

explained above.



/find <unit name>

Moves your screen to the the biggest group of the specified unit in the game currently.
[image loading]





/highlight <unit name>

Covers all the units with the specified name with a bright retina burning cyan. The command /hon must be typed before this can be used.

[image loading]





/unhighlight

Turns off highlighting.




/hon

Turns on highlighting




/hoff

Turns off highlighting, but the next time /hon is called, the previously highlighted unit will still be highlighted, where as /unhighlight doesn't remember the previously highlighted unit




/clear

Turns off everything.



/all

Turns on everything.



/macro or /ma

Toggles macro info.



/rally

Shows the rally point of all the buildings. Buildings without a rally point set yet is shown to have a rallypoint to the top left corner(usually. Unless they want to hide carriers there.)
[image loading]





/workers

Toggles worker info.



/order

Shows the exact orders of each unit and the exact coordinate the game interpretes that command. This means it's not necessarily what the player clicked, but rather what the game interpreted that click as.
[image loading]


Different colors mean different orders:
Black = Hold position. The command that Bisu forgets to do in important games.
Grey = Patrol. The micro button.
White = Nothing. It's doing it on its on free will
Green = Move.
Red = 1a2a3a.



/bo

Toggles build order info.



/hp

Toggles HP bars.

/hide <1 or 2>

Hide the info from player 1 or 2.

[image loading]




/unhide <1 or 2>

unhide the player info.


/load <layout scheme filename>

Loads a file containing a set of layout options. I included 2 basic files (basicinfo.ini, buildorder.ini)



/load basicinfo

[image loading]




/load buildorder

[image loading]




In the beginning of the replay the plugin will automatically load replaypp.ini. So just edit that file to your liking. The default file scheme is:
+ Show Spoiler +


showrally: 1
showworkerstats: 1
showmacrostats: 1
showorder: 1
showbuildorder: 1
showhp: 1
supplycount: 50
***************macrosettings:
Xcoordinate: 10
Ycoordinate: 10
productionFacCount: 1
queuedCount: 1
averageQueuedCount: 1
currentlyBuildingCount: 1
idleBuildingOrLarvaCount: 1
macroRating: 1
********************Workersettings:
xcoordinate: 300
ycoordinate: 10
workerCount: 1
miningMineralCount: 1
miningGasCount: 1
idleWorkerCount: 1
******************buildOrderSettings:
xcoordinate: 305
ycoordinate: 130
notify: 1



You can decide which info is displayed from changing to 1 or 0.
Notify is the option to turn off the notification everytime the buildorder list increases.




/default

loads replaypp.ini(the default file)




/notify

Toggles the notification of build orders.


Misc Features:


Mouse Guided Unit Counting:

This makes counting how many mutas are in a stack. All you have to do is draw a selection box, and all the units in the selection box is counted and displayed.

[image loading]


Showing hp bars

Size appropriate HP bars are shown above units.
[image loading]


Changing game speed:

You can only change the game speed with the +/- on the numpad.


How the fuck can I use this sexy shit?
Download this file:
http://replaypp.googlecode.com/svn/trunk/replayPP.zip

Upon extraction, you will see 3 folders. Copy the folder inside Starcraft into your starcraft folder. Copy the files inside WINDOWS into your WINDOWS folder. Copy the files inside Chaoslauncher into your Chaoslauncher folder.

Inside the bwapi-data folder(Starcraft/bwapi-data) there is a file called replaypp.ini. Open it. Edit it to your liking. 0 is no, 1 is yes.

Start chaoslauncher tick BWAPI injector, and you might want to untick apm alert because the text overlaps with the text generated by my plugin.

Happy replay watching!

If you're crashing:
On February 06 2010 14:27 R1CH wrote:
Show nested quote +
On February 06 2010 13:59 Garnet wrote:
I followed your instruction precisely and this happened:
[image loading]

Install Visual C++ runtimes, in the order linked.

http://www.microsoft.com/downloads/details.aspx?familyid=32BC1BEE-A3F9-4C13-9C99-220B62A191EE&displaylang=en
http://www.microsoft.com/downloads/details.aspx?familyid=200B2FD9-AE1A-4A14-984D-389C36F85647&displaylang=en
http://www.microsoft.com/downloads/details.aspx?FamilyID=9b2da534-3e03-4391-8a4d-074b9f2bc1bf&displaylang=en
http://www.microsoft.com/downloads/details.aspx?familyid=A5C84275-3B97-4AB7-A40D-3802B2AF5FC2&displaylang=en


Thanks R1CH!

EDIT: A video of it working is up. BUT TRY IT YOURSELF.
We spend our youth attaining wealth, and our wealth attaining youth.
jalstar
Profile Blog Joined September 2009
United States8198 Posts
February 06 2010 04:45 GMT
#2
HOLY FUCKING FUCK MY DICK IS ROCK SOLID
JohnColtrane
Profile Blog Joined July 2008
Australia4813 Posts
February 06 2010 04:48 GMT
#3
wow this looks awesome, ill give it a dl
HEY MEYT
dhe95
Profile Blog Joined December 2008
United States1213 Posts
February 06 2010 04:48 GMT
#4
this is going to be amazing
zulu_nation8
Profile Blog Joined May 2005
China26351 Posts
February 06 2010 04:48 GMT
#5
Very nice
ShaLLoW[baY]
Profile Blog Joined January 2007
Canada12499 Posts
February 06 2010 04:48 GMT
#6
DHASOIFHSOIFSHDOIFHSO HOH WHAT THE FUCK THIS IS FUCKING EPIC
ALEXISONFIRE ARE FUCKING BACK (sAviOr for life)
bLueSkY)
Profile Joined November 2006
New Zealand88 Posts
February 06 2010 04:48 GMT
#7
dude you are a genius!
that BO thing is so awesome and saves time (i usually have to go write down the BO and miss little things sometimes)
cheers!
Tazan_0
Profile Joined May 2009
United States63 Posts
February 06 2010 04:50 GMT
#8
I think I just ejaculated.
pwnd?
Garnet
Profile Blog Joined February 2006
Vietnam9033 Posts
February 06 2010 04:50 GMT
#9
O_O brb testing.
JWD
Profile Blog Joined October 2007
United States12607 Posts
February 06 2010 04:51 GMT
#10
SICKKKK
✌
etch
Profile Blog Joined July 2009
Canada176 Posts
February 06 2010 04:51 GMT
#11
jesus fucking christ this is incredible.
Signet
Profile Joined March 2007
United States1718 Posts
February 06 2010 04:53 GMT
#12
Holy crap that's an awesome plugin.
sob3k
Profile Blog Joined August 2009
United States7572 Posts
February 06 2010 04:53 GMT
#13
Can we get a video of this in action?
In Hungry Hungry Hippos there are no such constraints—one can constantly attempt to collect marbles with one’s hippo, limited only by one’s hippo-levering capabilities.
Kuri
Profile Blog Joined October 2009
Canada88 Posts
February 06 2010 04:55 GMT
#14
Well done! Now start practicing for csl!
Megalisk
Profile Blog Joined October 2008
United States6095 Posts
February 06 2010 04:57 GMT
#15
[image loading]
Tear stained american saints and dirty guitar dreams across a universe of desert and blue sky , gas station coffee love letters and two dollar pistol kisses from thirty five dollar hotel room stationary .
Spazer
Profile Blog Joined March 2009
Canada8033 Posts
February 06 2010 04:57 GMT
#16
Holy shit. I've always thought BWAPI was amazing stuff, but I never thought it could be used for something like this. It does make a lot of sense in hindsight though.

Amazing work!
Liquipedia
kitaman27 *
Profile Blog Joined April 2009
United States9245 Posts
February 06 2010 04:57 GMT
#17
whoa looks awesome
I'm better than dirt. Well, most kinds of dirt. I mean not that fancy store bought dirt. That stuffs loaded with nutrients. I... I can't compete with that stuff.
Garnet
Profile Blog Joined February 2006
Vietnam9033 Posts
February 06 2010 04:59 GMT
#18
I followed your instruction precisely and this happened:
[image loading]
JWD
Profile Blog Joined October 2007
United States12607 Posts
February 06 2010 05:00 GMT
#19
this tool was made for casting replays.
✌
Marine50
Profile Joined September 2007
Australia1764 Posts
February 06 2010 05:03 GMT
#20
wow. Amazing tools
IRIS FIGHTING!!!
1 2 3 4 5 14 15 16 Next All
Please log in or register to reply.
Live Events Refresh
Next event in 10h 46m
[ Submit Event ]
Live Streams
Refresh
StarCraft 2
PiGStarcraft449
ProTech60
CosmosSc2 54
StarCraft: Brood War
Artosis 552
NaDa 23
Mong 4
Dota 2
syndereN839
Counter-Strike
Foxcn150
adren_tv86
Super Smash Bros
PPMD67
Liquid`Ken24
Other Games
summit1g7175
Day[9].tv284
C9.Mang0181
RotterdaM122
ViBE109
Maynarde83
Trikslyr54
Mew2King34
nookyyy 29
Organizations
Other Games
BasetradeTV50
StarCraft 2
Blizzard YouTube
StarCraft: Brood War
BSLTrovo
sctven
[ Show 19 non-featured ]
StarCraft 2
• Hupsaiya 101
• RyuSc2 38
• davetesta18
• Kozan
• LaughNgamezSOOP
• sooper7s
• AfreecaTV YouTube
• intothetv
• Migwel
• IndyKCrew
StarCraft: Brood War
• Pr0nogo 2
• STPLYoutube
• ZZZeroYoutube
• BSLYoutube
Dota 2
• masondota22666
League of Legends
• Doublelift3691
Other Games
• imaqtpie2124
• Scarra752
• Day9tv284
Upcoming Events
WardiTV 2025
10h 46m
ByuN vs Creator
Clem vs Rogue
Scarlett vs Spirit
ShoWTimE vs Cure
OSC
13h 46m
Big Brain Bouts
16h 46m
YoungYakov vs Jumy
TriGGeR vs Spirit
CranKy Ducklings
1d 9h
WardiTV 2025
1d 10h
Reynor vs MaxPax
SHIN vs TBD
Solar vs herO
Classic vs TBD
SC Evo League
1d 12h
Ladder Legends
1d 18h
BSL 21
1d 19h
Sziky vs Dewalt
eOnzErG vs Cross
Sparkling Tuna Cup
2 days
Ladder Legends
2 days
[ Show More ]
BSL 21
2 days
StRyKeR vs TBD
Bonyth vs TBD
Replay Cast
3 days
Wardi Open
3 days
Monday Night Weeklies
3 days
WardiTV Invitational
5 days
Replay Cast
6 days
WardiTV Invitational
6 days
ByuN vs Solar
Clem vs Classic
Cure vs herO
Reynor vs MaxPax
Liquipedia Results

Completed

Acropolis #4 - TS3
RSL Offline Finals
Kuram Kup

Ongoing

C-Race Season 1
IPSL Winter 2025-26
KCM Race Survival 2025 Season 4
YSL S2
BSL Season 21
Slon Tour Season 2
CSL Season 19: Qualifier 1
WardiTV 2025
META Madness #9
eXTREMESLAND 2025
SL Budapest Major 2025
ESL Impact League Season 8
BLAST Rivals Fall 2025
IEM Chengdu 2025
PGL Masters Bucharest 2025
Thunderpick World Champ.
CS Asia Championships 2025
ESL Pro League S22

Upcoming

CSL Season 19: Qualifier 2
CSL 2025 WINTER (S19)
BSL 21 Non-Korean Championship
Acropolis #4
IPSL Spring 2026
Bellum Gens Elite Stara Zagora 2026
HSC XXVIII
Big Gabe Cup #3
OSC Championship Season 13
ESL Pro League Season 23
PGL Cluj-Napoca 2026
IEM Kraków 2026
BLAST Bounty Winter 2026
BLAST Bounty Winter Qual
TLPD

1. ByuN
2. TY
3. Dark
4. Solar
5. Stats
6. Nerchio
7. sOs
8. soO
9. INnoVation
10. Elazer
1. Rain
2. Flash
3. EffOrt
4. Last
5. Bisu
6. Soulkey
7. Mini
8. Sharp
Sidebar Settings...

Advertising | Privacy Policy | Terms Of Use | Contact Us

Original banner artwork: Jim Warren
The contents of this webpage are copyright © 2025 TLnet. All Rights Reserved.