Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dotabuff/manta
Dotabuff's Dota 2 Source 2 Replay Parser in Go
https://github.com/dotabuff/manta
Last synced: about 2 months ago
JSON representation
Dotabuff's Dota 2 Source 2 Replay Parser in Go
- Host: GitHub
- URL: https://github.com/dotabuff/manta
- Owner: dotabuff
- License: mit
- Created: 2015-01-27T19:05:36.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-07-30T18:11:40.000Z (about 2 months ago)
- Last Synced: 2024-07-31T16:45:46.381Z (about 2 months ago)
- Language: Go
- Homepage:
- Size: 838 MB
- Stars: 606
- Watchers: 48
- Forks: 100
- Open Issues: 44
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome - dotabuff/manta - Dotabuff's Dota 2 Source 2 Replay Parser in Go (Go)
README
# Manta
[](https://github.com/dotabuff/manta/actions/workflows/ci.yml)
Manta is a fully functional Dota 2 replay parser written in [Go](https://golang.org), targeting the Source 2 (Dota 2 Reborn) game engine.
## Getting Started
Manta is a low-level replay parser, meaning that it will provide you access to the raw data in the replay, but doesn't provide any opinion on how that data should be structured for your use case. You'll need to create callback functions, inspect the raw data, and decide how you're going to use it.
## Usage
Get the code:
go get github.com/dotabuff/manta
Use it to parse a replay:
```go
import (
"log"
"os"
"github.com/dotabuff/manta"
"github.com/dotabuff/manta/dota"
)
func main() {
// Create a new parser instance from a file. Alternatively see NewParser([]byte)
f, err := os.Open("my_replay.dem")
if err != nil {
log.Fatalf("unable to open file: %s", err)
}
defer f.Close()
p, err := manta.NewStreamParser(f)
if err != nil {
log.Fatalf("unable to create parser: %s", err)
}
// Register a callback, this time for the OnCUserMessageSayText2 event.
p.Callbacks.OnCUserMessageSayText2(func(m *dota.CUserMessageSayText2) error {
log.Printf("%s said: %s\n", m.GetParam1(), m.GetParam2())
return nil
})
// Start parsing the replay!
p.Start()
log.Printf("Parse Complete!\n")
}
```
## Developing
To run `make update` you will need a few things installed:
```sh
# Install subversion. On OS X:
brew install subversion
# Install protoc. On OS X:
brew install protobuf
# Install gnu-sed. Not needed on Linux. On OS X:
brew install gnu-sed
# Install protoc-gen-go:
go install github.com/golang/protobuf/[email protected]
```
## License
Manta is distributed under the [MIT license](https://github.com/dotabuff/manta/blob/master/LICENSE).
## Code of Conduct
Manta has adopted the [Contributor Covenant Code of Conduct](https://github.com/dotabuff/manta/blob/master/CONDUCT.md).
## Getting Help
The best place to ask questions about Dota 2 replay parsing is the #dota2replay channel on QuakeNet, where we're happy to answer any questions you may have. Please only open Github issues for actual bugs in manta, not questions about usage.
Looking to parse Source 1 (original Dota 2) replays? Take a look at [Yasha](https://github.com/dotabuff/yasha).
## Authors and Acknowledgements
Manta is maintained and development is sponsored by [Dotabuff](http://www.dotabuff.com), a leading Dota 2 community website with an emphasis on statistics. Manta wouldn't exist without the efforts of a number of people:
- [Michael Fellinger](https://github.com/manveru) built Dotabuff's Source 1 parser [yasha](https://github.com/dotabuff/yasha).
- [Robin Dietrich](https://github.com/invokr) built the C++ parser [Alice](https://github.com/AliceStats/Alice).
- [Martin Schrodt](https://github.com/spheenik) built the Java parser [clarity](https://github.com/skadistats/clarity).
- [Drew Schleck](https://github.com/dschleck), built an original C++ parser [edith](https://github.com/dschleck/edith).