Downloads (Co-op Assistant and Replay Parsing Script)
Sections on this Page
Co-op Assistant
This is a Windows application that provides two pieces of functionality which can be turned on/off as required:
- It detects the map you're playing on, and if you are playing on a map with a fast expand, will prompt you for a commander. If there is a fast expand available for the commander, it will create a small overlay, with an image from this site to remind you how to fast expand
- If you have an account on this site, your replays will be automatically uploaded to your account
Download Links
Usage Notes
- You will to have the .NET Framework 4.7.2. You can get it from here.
- An internet connection will be required for the program to function.
- If there is an update to the program, you will be notified when you launch it. Updates should be few and far between, and usually only if a new commander gets added with a Fast Expand strategy.
- The program will need write access to its current running folder to save your settings. It is best to save this program in its own folder on your Desktop or other directory where write permissions exist.
Configuring the Program
For Automatic Uploading of Replays to your starcraft2coop.com Account
- Generate a Secret Key from the Account Settings tab in the Account Page.
- In the Settings section of the Co-op Assistant, upload the settings under the "Upload Configuration" section. Make sure you select the correct account folder. Its path should be similar to:
C:\Users\[Your PC Username]\Documents\Starcraft II\Accounts\[Numbers]
- Press "Save" to save the Settings
For Fast Expand Assistance
- In the Settings section of the Co-op Assistant, input your replay username (IGN) into the text box.
- If you are playing the game in English
- You are done
- If you are playing the game in another language
- You will need to collect identifying player names from the Starcraft II Client as follows:
- In Starcraft II, navigate to a map in the Replays tab and click on it. Do not open the Replay.
- Note the unique name that identifies the mission (not the player names, and not "Amon's Forces").
- In the Settings section of the Co-op Assistant, input that unique name into Language Localization section.
- You will need to collect identifying player names from the Starcraft II Client as follows:
For Twitch Extension Integration
- Install starcraft2coop.com's Twitch Extension from here.
- Make sure you have a valid Username and Secret Key assigned in your starcraft2coop.com account.
- Link your Twitch account in the Account Page Settings tab.
- You will be asked to Authorize the application. Once accepted, you will be redirected back to the Account Page.
- If you can see your Twitch username after "Authenticated Twitch User", the extension will now receive your end-of-game replay stats and display it.
Note: If you would like to disable the Twitch Integration, click "Clear Token" to stop data being sent.
For Mutator Identification
- Make sure you have a valid Username and Secret Key assigned in your starcraft2coop.com account.
- Download both, the OpenCV library and the Mutator Finder Plugin (links below).
- Place them in the same directory as the Co-op Assistant.
- If Twitch Integration is enabled, Mutator data will be sent when the Co-op Assistant is running.
Note: If a mutator present does not get automatically identified, you may select the unidentified mutator and click "Add Mutator". This will take a screenshot of the mutator and save it in an "Extra Icons" folder to help with future identification.
Download Links
Co-op Replay Data Summarizer
This is a Python script which takes a Replays folder and generates a delimited text file summarizing the replay data for co-op games, which can be imported for further data analysis. Below is an example of the output:
Date Played Map Commander Level Ally Commander Ally Level Game Type Result Game Length
2019-02-18 Chain of Ascension Horner 0 Stukov 34 Standard Lose 1552
2019-02-15 Cradle of Death Karax 0 Abathur 25 Standard Win 1359
2019-02-15 Cradle of Death Vorazun 0 Zeratul 0 Standard Win 1538
2019-02-27 Temple of the Past Horner 71 Karax 1000 Mutators Win 1591
2019-02-24 The Vermillion Problem Dehaka 57 Raynor 0 Standard Lose 1536
2019-02-17 Void Launch Swann 0 Fenix 73 Standard Win 1465
Download Links
Usage Notes
- You will require Python 2, as S2Protocol has been written under that version of Python. You can download Python from here. Make sure to select the appropriate installer for your system.
- You will need to have Python's S2Protocol installed in order for this script to work. You can get it from here. If you have Pip, you may use "pip install s2protocol" to install S2Protocol.
- Make sure you specify your replay folder path and player name correctly. An incorrect player name may cause issues in determining which commander you are playing.
- On completion of the script, a file named "output.txt" will be created in the folder the script was run with the summarized data.
- Replay parsing should not take more than a second, as only the simple data is being read.
- You may modify the script to parse Ladder game information as well. However, this script is only provided as-is, and support is only available for Co-op games. Support for advanced parsing of Co-op game data will not be provided.
Updates
- Whenever a new version of Starcraft gets released (major or minor patch), you may need to update S2Protocol. You may do so by copying any newly-added protocol files from the Github to the Versions folder of S2Protocol, or if you used Pip, you can use "pip install s2protocol --upgrade".
- Sometimes, S2Protocol may not be updated, which means you can use the last protocol version for the latest build. Simply copy and rename the last protocol file as the last build ID and the parser should work fine. This is because the Protocols are very rarely updated and most are copies of the older versions. The advantage to this is that it is possible that older Protocol versions can work with newer replay files.
- The above issue has occurred before and may occur for older replay files. If you notice that you are missing a protocol version, you may use the steps above to solve the problem.
Other Notes
- Map names will be affected by language localization. That is, the map names will be displayed in the language the game was played in when the replay was created.
