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)
• zlib
• CMake

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

cmake -B build -S .

This will create a Makefile in the 'build' subfolder.
Finish building the executable:

cmake --build build --parallel

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

Addon

Installation

• For Blender versions ≥ 4.2.0
  • Install through Blender Extensions
• For Blender versions ≥ 3.0.0
  • Download the latest 'Replay Blender Importer' zip file 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 outputted by the parser
• Adjust framerate if necessary
• Assign the Chassis and Wheel slots appropriately (see video guide)

Building

For Blender 4.2.0 and beyond

In the 'Replay Blender Importer' folder, run the following command:

blender --command extension build

This creates a zip file 'acreplay_importer-x.x.x.zip' which can be installed in Blender.

For Blender 3.0.0-4.1.x

See the 0.2.0 Blender 3.0.0 branch