sim-racing-tools 2021.6.2

A collection of tools to make sim-racing more fun

sim-racing-tools

A collection of python tools to make sim-racing more fun. All a work in-progress based on things I've been playing around with. Feel free to contribute with any ideas or suggestions and let me know if you find any bugs.

Installation

Pre-requisites

• A Windows computer (I plan to support Linux in future)
• The Git version control system needs to be installed
• python3 needs to be installed
• Either Content Manager or QuickBMS needs to be downloaded and you will need to know the folder it is in. We will need to use one of these to unpack data.acd files.
• If using QuickBMS the .acd extractor plugin for QuickBMS needs to be downloaded and placed inside the folder containing quickbms.exe
• A willingness to hack around with a bit of python programming

Optional first step:

I would recommend creating a python virtual environment to install the tools into. This will allow you to use the tools in an isolated environment without installing anything system-wide.

Creating a virtual environment

To setup a virtual environment first decide where you would like this to live, change into that directory and open a command-prompt within it. Inside the command prompt run the command:

py -m venv sim-racing-tool-venv

That will have created a folder called sim-racing-tool-venv inside the directory you are in.

Entering the virtual environment

This newly created folder contains a self-contained python environment that you can enter at anytime by opening a command prompt inside the sim-racing-tool-venv folder and running:

.\Scripts\activate.bat

this command prompt window will now be running in the virtual environment and anything you install will only be installed into it - rather than on the whole system

Exiting the virtual environment

You can exit a virtual environment at any time by typing deactivate into the console

Downloading and installing sim-racing-tools

To download and install first make sure that you have entered the virtual environment (if you set one up) and run the following command inside it:

py -m pip install git+https://github.com/zephyrj/sim-racing-tools@main

The tools will now be installed and available from a inside your virtual environment.

Things you can do

• Clone existing AC car
• Transfer an engine made in Automation into a car in AC
• Check that an engine created in Automation matches some criteria