HeroProtocol 1.2.62833

hots.Academy.HeroProtocol

HeroProtocol is a c# conversion of Blizzard's Python HeroProtocol.

It is a standalone tool(library) to decode Heroes of the Storm replay files into usable data structures.

Currently HeroProtocol can decode these structures and events:

• Replay Header
• Game Details
• Init Data
• Attribute Events
• Game Events
• Message Events
• Tracker Events
• BattleTags

Note: This library is designed to reflect Blizzard's HeroProtocol and does not include any built in functions for analysis.

Key Features

• Parse multiple data sources
  • String: Local Files using file path
  • Stream: Data from memory stream (Useful for cloud storage)
  • Byte[]: Sometimes you just need to read arrays
• Memory Management
  • Filter what data structures you want to parse (Some data structures consume a lot of resources you may not want to process)
• No temp files required
  • Read and parse everything in memory fore better performance and less access requirements
• Futre Release Support (experimental)
  • Replays can be parsed even if its a future patch not supported yet.
  • Major changes may break a speccific data structure or event but won't prevent the remainder from parsing

How To Use

First you'll need to download and import the HeroProtocol Reference.

# Package Manager
PM> Install-Package HeroProtocol

# .NET CLI
> dotnet add package HeroProtocol

Once you have your pacakge installed you simply need to access your replay files and parse them.

Sample Code:

var heroesAccountsFolder = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments), @"Heroes of the Storm\Accounts");
var files = Directory.GetFiles(heroesAccountsFolder, "*.StormReplay", SearchOption.AllDirectories).Take(200);
foreach (var file in files)
{
	var exclusionList = new List<Replay.ReplayFiles>();
	//exclusionList.Add(HeroProtocol.Replay.ReplayFiles.MessageEvents);
	//exclusionList.Add(HeroProtocol.Replay.ReplayFiles.GameEvents);
	var ReplayData = new Replay(file,  exclusionList);
}

Credits

This software uses code from other packages.

• Nmpq A fully-managed C# parser for Blizzard MPQ Archives
• HeroProtocol Blizzard's heroprotocol is a reference Python library and standalone tool to decode Heroes of the Storm replay files into Python data structures.