Sprocket RL Parser

1.2.110 verified Fri May 01 auth: no python

A Python library for parsing Rocket League replay files (.replay) and analyzing match data. Current version 1.2.110, with frequent updates. Requires Python >=3.7.

pip install sprocket-rl-parser

Common errors

error ModuleNotFoundError: No module named 'sprocket_rl_parser' ↓

cause Package not installed or installed under a different name (e.g., sprocket-rl-parser with hyphens).

fix

Install the correct package: pip install sprocket-rl-parser. Import using underscores: from sprocket_rl_parser import ...

error AttributeError: 'SprocketRLParser' object has no attribute 'parse' ↓

cause Calling parse() on a newer version where method is renamed.

fix

Use .parse() as of version 1.0.0. If using older version, check docs for parse_replay() method.

Warnings

breaking In version 1.0.0, the parse() method signature changed from parse(file_path) to parse(). File path is now passed to the constructor. ↓

fix Instantiate SprocketRLParser(file_path) then call parse() with no arguments.

gotcha The replay file must be in the official .replay format; other extensions or corrupted files cause silent parsing failures. ↓

fix Ensure the file is a valid Rocket League replay (check file header b'CARP').

Imports

SprocketRLParser

wrong

from sprocket_rl_parser import Parser

correct

from sprocket_rl_parser import SprocketRLParser

Parser class is not exported directly; use SprocketRLParser.

Quickstart

Parse a Rocket League replay file and access basic match info.

from sprocket_rl_parser import SprocketRLParser

parser = SprocketRLParser('path/to/replay.replay')
parsed = parser.parse()
print(parsed.match_id)
print(parsed.teams[0].name)
print(parsed.players[0].name)