acreplay-parser

This software consists of two parts: a parser for Assetto Corsa replay (.acreplay) files, and an addon to import the parsed data into Blender. A video guide is available here.

Parser

Usage

• Download and extract a 'ReplayParser' file from the Releases page
• Open an .acreplay file with the acrp executable and it will output data for each driver as .json files.
• Import the .json files into Blender with the addon.

For more advanced options use the command line:

acrp [OPTIONS] [INPUT FILE(S)] with options:
-o, --output PATH
    Output path with optional file name.
    Default is "<input-filename>.json" in the directory of the executable.
    <driver-name> is concatenated to the end if all cars are to be parsed.

--driver-name NAME
    Name of driver whose vehicle is to be parsed.
    Parses all cars if unspecified.

Building

Requirements:

• A compiler supporting C++23 extended floating-point types (GCC recommended)
• CMake

In the 'Replay Parser' folder, run the following command:

mkdir build && cd build && cmake ..

This will create a Makefile in the 'build' subfolder.
Use a compiler of choice to finish building the executable. For example:

make

The executable will be located in the 'build' subfolder.

Addon

Installation

• Download Replay.Blender.Importer.zip from the Releases page
• In Blender go to Edit > Preferences and click 'Install', navigate to the downloaded file
• Enable the addon

Usage

• Open the sidebar by going to View > Sidebar, or by pressing the N key
• Go to the Animation tab and locate the 'AC Replay Importer' dropdown
• Click 'Import .json' and navigate to the .json file(s) outputted by the parser
• Adjust framerate if necessary
• Assign the Chassis and Wheel slots appropriately (see video guide)

Building

Simply zip up the folder to get a file structure like:

Replay.Blender.Importer.zip
└── Replay Blender Importer
    ├── __init__.py
    └── ...