rattletrap: Parse and generate Rocket League replays.

[ game, library, mit, program ] [ Propose Tags ]

Rattletrap parses and generates Rocket League replays.


[Skip to Readme]
Versions 0.1.0, 0.1.1, 0.1.2, 0.1.3, 0.1.4, 0.1.5, 0.1.6, 0.1.7, 0.2.0, 0.3.0, 0.4.0, 0.4.1, 1.0.0, 2.0.0, 2.1.0, 2.1.1, 2.1.2, 2.1.3, 2.1.4, 2.1.5, 2.2.0, 2.2.1, 2.2.2, 2.2.3, 2.2.4, 2.3.0, 2.3.1, 2.4.0, 2.5.0, 2.5.1, 2.5.2, 3.0.0, 3.1.0, 3.1.1, 3.1.2, 4.0.0, 4.0.1, 4.0.2, 4.0.3, 4.0.4, 4.0.5, 4.0.6, 4.0.7, 4.0.8, 4.0.9, 4.1.0, 4.1.1, 4.1.2
Change log CHANGELOG.markdown
Dependencies aeson (>=1.2.4 && <1.5), aeson-pretty (>=0.8.5 && <0.9), base (>=4.10.1 && <4.12), binary (>=0.8.5 && <0.9), binary-bits (==0.5.*), bytestring (>=0.10.8 && <0.11), containers (>=0.5.10 && <0.6), filepath (>=1.4.1 && <1.5), http-client (>=0.5.10 && <0.6), http-client-tls (>=0.3.5 && <0.4), rattletrap, template-haskell (>=2.12.0 && <2.14), text (>=1.2.3 && <1.3), transformers (>=0.5.2 && <0.6) [details]
License MIT
Author
Maintainer Taylor Fausak
Category Game
Home page https://github.com/tfausak/rattletrap#readme
Bug tracker https://github.com/tfausak/rattletrap/issues
Source repo head: git clone https://github.com/tfausak/rattletrap
Uploaded by fozworth at Sat Jul 14 21:03:46 UTC 2018
Distributions NixOS:4.1.2, Stackage:4.1.2
Executables rattletrap
Downloads 7024 total (745 in the last 30 days)
Rating (no votes yet) [estimated by rule of succession]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2018-07-14 [all 1 reports]
Hackage Matrix CI

Modules

[Index]

Flags

NameDescriptionDefaultType
staticDisabledManual

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

Downloads

Maintainer's Corner

For package maintainers and hackage trustees


Readme for rattletrap-4.1.2

[back to package description]

Rattletrap

Version badge Windows build badge Build badge

Rattletrap parses and generates Rocket League replays.

Install

Get Rattletrap by downloading and unpacking the latest release for your platform.

To build Rattletrap from source, install Stack. Then run stack --resolver nightly install rattletrap.

Replays

Rocket League saves your replays in a folder that depends on your operating system.

  • Windows:
    • %UserProfile%/Documents/My Games/Rocket League/TAGame/Demos
    • For example: C:/Users/Taylor/Documents/My Games/Rocket League/TAGame/Demos
  • macOS:
    • $HOME/Library/Application Support/Rocket League/TAGame/Demos
    • For example: /Users/taylor/Library/Application Support/Rocket League/TAGame/Demos
  • Linux:
    • $HOME/.local/share/Rocket League/TAGame/Demos
    • For example: /home/taylor/.local/share/Rocket League/TAGame/Demos

Interface

Rattletrap is a command line application.

> rattletrap --help
rattletrap version 4.0.0
  -c             --compact                minify JSON output
  -h             --help                   show the help
  -i FILE|URL    --input=FILE|URL         input file or URL
  -m MODE        --mode=MODE              decode or encode
  -o FILE        --output=FILE            output file
  -v             --version                show the version

By default Rattletrap will try to determine the appropriate mode (either decode or encode) based on the file extensions of the input or output. You can override this behavior by passing --mode (or -m) with either decode or encode.

Input extension | Output extension | Mode --- | --- | --- .replay | anything | decode (parse) .json | anything | encode (generate) anything | .replay | encode (generate) anything | .json | decode (parse) anything | anything | decode (parse)

Parse

Rattletrap can parse (decode) Rocket League replays and output them as JSON.

> rattletrap --input http://example.com/input.replay --output output.json
# or
> rattletrap -i input.replay > output.json
# or
> rattletrap < input.replay > output.json

The input argument can either be a local path or a URL.

By default the JSON is pretty-printed. To minify the JSON, pass --compact (or -c) to Rattletrap. Even when the JSON is minified, it's extremely large. The output can be up to 100 times larger than the input. For example, a 1.5 MB replay turns into 31 MB of minified JSON or 159 MB of pretty-printed JSON.

Generate

Rattletrap can also generate (encode) Rocket League replays from JSON files.

> rattletrap --input http://example.com/input.json --output output.replay
# or
> rattletrap -i input.json > output.replay
# or
> rattletrap --mode encode < input.json > output.replay

The input argument can either be a local path or a URL.

If the JSON was generated by Rattletrap, the output replay will be bit-for-bit identical to the input replay.

Modify

By inserting another program between parsing and generating, Rattletrap can be used to modify replays.

> rattletrap -i input.replay |
  modify-replay-json |
  rattletrap -o output.replay