rattletrap
Parse and generate Rocket League replays.
https://github.com/tfausak/rattletrap#readme
| Version on this page: | 2.2.0 |
| LTS Haskell 23.14: | 14.1.1 |
| Stackage Nightly 2025-03-16: | 14.1.1 |
| Latest on Hackage: | 14.1.1 |
rattletrap-2.2.0@sha256:ff994b8b41d56d56963f375a683ba8571ae307cfa4e1f535fdc679f783d79ac5,7413Module documentation for 2.2.0
- Rattletrap
- Rattletrap.ActorMap
- Rattletrap.Attribute
- Rattletrap.Attribute.AppliedDamage
- Rattletrap.Attribute.Boolean
- Rattletrap.Attribute.Byte
- Rattletrap.Attribute.CamSettings
- Rattletrap.Attribute.ClubColors
- Rattletrap.Attribute.DamageState
- Rattletrap.Attribute.Demolish
- Rattletrap.Attribute.Enum
- Rattletrap.Attribute.Explosion
- Rattletrap.Attribute.FlaggedInt
- Rattletrap.Attribute.Float
- Rattletrap.Attribute.GameMode
- Rattletrap.Attribute.Int
- Rattletrap.Attribute.Loadout
- Rattletrap.Attribute.LoadoutOnline
- Rattletrap.Attribute.Loadouts
- Rattletrap.Attribute.LoadoutsOnline
- Rattletrap.Attribute.Location
- Rattletrap.Attribute.MusicStinger
- Rattletrap.Attribute.PartyLeader
- Rattletrap.Attribute.Pickup
- Rattletrap.Attribute.PrivateMatchSettings
- Rattletrap.Attribute.QWord
- Rattletrap.Attribute.Reservation
- Rattletrap.Attribute.RigidBodyState
- Rattletrap.Attribute.String
- Rattletrap.Attribute.TeamPaint
- Rattletrap.Attribute.UniqueId
- Rattletrap.Attribute.WeldedInfo
- Rattletrap.AttributeMapping
- Rattletrap.AttributeType
- Rattletrap.AttributeValue
- Rattletrap.Cache
- Rattletrap.ClassAttributeMap
- Rattletrap.ClassMapping
- Rattletrap.Content
- Rattletrap.Crc
- Rattletrap.Data
- Rattletrap.Frame
- Rattletrap.Header
- Rattletrap.Helper
- Rattletrap.Initialization
- Rattletrap.Json
- Rattletrap.KeyFrame
- Rattletrap.Main
- Rattletrap.Mark
- Rattletrap.Message
- Rattletrap.Primitive
- Rattletrap.Primitive.CompressedWord
- Rattletrap.Primitive.CompressedWordVector
- Rattletrap.Primitive.Dictionary
- Rattletrap.Primitive.Float32
- Rattletrap.Primitive.Int32
- Rattletrap.Primitive.Int8
- Rattletrap.Primitive.Int8Vector
- Rattletrap.Primitive.List
- Rattletrap.Primitive.Section
- Rattletrap.Primitive.Text
- Rattletrap.Primitive.Vector
- Rattletrap.Primitive.Word32
- Rattletrap.Primitive.Word64
- Rattletrap.Primitive.Word8
- Rattletrap.Property
- Rattletrap.PropertyValue
- Rattletrap.RemoteId
- Rattletrap.Replay
- Rattletrap.Replication
- Rattletrap.ReplicationValue
- Rattletrap.Utility
- Rattletrap.Version
Rattletrap
Rattletrap parses and generates Rocket League replays.
If you only want to parse replays, consider using Octane instead. It uses Rattletrap behind the scenes but provides a nicer interface.
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 - macOS:
$HOME/Library/Application Support/Rocket League/TAGame/Demos - Linux:
$HOME/.local/share/Rocket League/TAGame/Demos
Parse
Rattletrap can parse (decode) Rocket League replays and output them as JSON.
> rattletrap decode input.replay output.json
# or
> rattletrap decode input.replay > output.json
# or
> rattletrap.decode < input.replay > output.json
The resulting JSON is minified, but extremely large. The output can be up to 50 times larger than the input.
Generate
Rattletrap can also generate (encode) Rocket League replays from JSON files.
> rattletrap encode input.json output.replay
# or
> rattletrap encode input.json > output.replay
# or
> rattletrap.encode < input.json > output.replay
If the JSON was generated by Rattletrap, the resulting replay should be identical to the original.
Modify
By inserting another program between parsing and generating, Rattletrap can be used to modify replays.
> rattletrap decode < original.replay |
modify-replay-json |
rattletrap encode > modified.replay