Home

A Gentle Introduction

Carball is an open-source project that decompiles Rocket League replays and then analyses them. The raw replay files from the Rocket League client (.replay) are first processed using boxcars which returns a JSON file. Carball then organises the data into two main formats: the Protobuffer and the DataFrame, which are easier to work with and are used for the vast majority of all analysis.

Contributing

We always welcome new contributors! The best place to get answers to questions is the calculated discord, which is available at the calculated.gg website. Please take time to explore the repository and understand it's workings before asking any questions. If you find that there is a lack of documentation or an opportunity to optimise, either suggest it in the discord (if you're unsure) or throw a pull request.

If you are looking to make any kind of change, you should ask whether it's needed - some areas are planned to be rewritten.