Simulation Configuration

Configuration Options For Assetto Corsa

Simulation Configuration

Modifying Assetto Corsa’s settings via ACI can be done be providing additional configuration dictionaries as part of the Interface Configuration. The key of the configuration should match the Assetto Corsa configuration file you want to override and contain a nested structure of keys that match that files layout. At present this is supported for assists.ini, controls.ini, gameplay.ini, race.ini, camera_manager.ini and video.ini files. As an example, to configure Assetto Corsa to load the Silverstone circuit instead of the default Monza you would add:

aci_configuration["race.ini"] = {
  "RACE":{
    "TRACK": "ks_silverstone",
    "CONFIG_TRACK": "gp",
  }
}

This layout is due to Assetto Corsa maintaining these settings in a file named race.ini which has the following structure:

[RACE]
TRACK="ks_silverston"
CONFIG_TRACK="gp"

Here we provide some of the common settings used to configure the simulation but it is by no means an exhaustive list. You can find our more options and what different setting do by checking the effects of in-game options on Assetto Corsa’s own configuration files to inform how to layout the override in ACI’s configuration.

Scenario Configuration

DICT

race.ini

Configuration dictionary format for overriding common Assetto Corsa scenario settings

KEY

TRACK -

dict

Configuration of circuit and layout

KEY

CAR_0 -

dict

Configuration of agent controlled vehicle

KEY

SESSION_0 -

dict

Configuration of race type and spawn location

KEY

GHOST_CAR -

dict

Configuration of best lap ghost car

KEY

LIGHTING -

dict

Configuration of sun position

KEY

TEMPERATURE -

dict

Configuration of track and ambient temperature

KEY

WEATHER -

dict

Configuration of weather conditions

Graphics Configuration

DICT

video.ini

Configuration of Assetto Corsa's graphics, see details bellow

KEY

VIDEO -

dict

Traditional graphics settings such as resolution, full screen mode, ect.

KEY

CAMERA -

dict

Rendering camera settings

KEY

CUBEMAP -

dict

Scene complexity settings such as farplane, faces per frame, ect.

Camera Configuration

DICT

camera_manager.ini

Configuration of in-game cameras, see details bellow

KEY

LAST_CAMERA -

dict

Configuration of default rendering camera

Circuit Layout Configuration

DICT

TRACK

Configuration of circuit and layout

KEY

TRACK -

str

Identifier of the desired race track location

KEY

CONFIG_TRACK -

str

Identifier of the specific track layout if there are multiple

KEY

MODEL -

str

Identifier of vehicle to by used

Vehicle Configuration

DICT

CAR_0

Configuration of agent controlled vehicle

KEY

SKIN -

str

Identifier for the desired vehicle livery

Race Session Configuration

DICT

SESSION_0

Configuration of race type and spawn location

KEY

NAME -

str

Name of the session that will appear in-game

KEY

TYPE -

int

Enum integer of the session type

KEY

DURATION_MINUTES -

int

How long the current session will run for (0 is infinite)

KEY

SPAWN_SET -

str

Identifier of the desired start point of the vehicle

Ghost Car Configuration

DICT

GHOST_CAR

Configuration of best lap ghost car

KEY

RECORDING -

int

Ghost car data is recorder (1) or not (0)

KEY

PLAYING -

int

Recorded ghost car will be rendered (1) or not (0)

Time of Day Configuration

DICT

LIGHTING

Configuration of sun position

KEY

SUN_ANGLE -

int

Initial sun location

KEY

TIME_MULT -

float

Sun movement speed

KEY

CLOUD_SPEED -

float

Cloud movement speed

Temperature Configuration

DICT

TEMPERATURE

Configuration of track and ambient temperature

KEY

AMBIENT -

int

Air temperature in degree celsius

KEY

ROAD -

int

Road surface temperature in degrees celsius

Weather Configuration

DICT

WEATHER

Configuration of weather conditions

KEY

NAME -

str

Identifier for prescribed list of weather conditions in Assetto Corsa

Display Configuration

DICT

VIDEO

Display settings such as resolution, full screen mode, ect.

KEY

FULLSCREEN -

int

Render in fullscreen (1) or windowed (0) mode

KEY

FPS_CAP_MS -

int

Frame rate limit

KEY

WIDTH -

int

Render resolution's width

KEY

HEIGHT -

int

Render resolution's height

Rendering Camera Configuration

DICT

CAMERA

Rendering camera settings

KEY

MODE -

str

Rendering Complexity Configuration

DICT

CUBEMAP

Scene complexity settings such as farplane, faces per frame, ect.

KEY

SIZE -

int

KEY

FACES_PER_FRAME -

int

KEY

FARPLANE -

int

Agent View Configuration

DICT

LAST_CAMERA

Configuration of default rendering camera

KEY

MODE -

int

KEY

DRIVABLE_MODE -

int

Realism Configuration

DICT

assists.ini

Configuration of Assetto Corsa's assistive settings, see details bellow

KEY

ASSISTS -

dict

Configure the assistive features of Assetto Corsa

Assistive Features Configuration

DICT

ASSISTS

Configure the assistive features of Assetto Corsa

KEY

IDEAL_LINE -

int

Controls whether a suggested racing line is rendered in the simulation. Default 0

KEY

AUTO_BLIP -

int

When downshifting the engine's revs will be increased to match the new gears speed automatically. Default 0

KEY

STABILITY_CONTROL -

int

Enables Electronic Stability Control interventions. Default 0

KEY

AUTO_BRAKE -

int

Enables simulation to apply brakes automatically. Default 0

KEY

AUTO_SHIFTER -

int

Automatic or manual transmission. Default 1

KEY

ABS -

int

Level of Anti-Lock Braking System to use. Default 1

KEY

TRACTION_CONTROL -

int

Level of Traction Control to use. Default 1

KEY

AUTO_CLUTCH -

int

Automatic clutch when shifting gears. Default 0

KEY

VISUALDAMAGE -

int

Default 100

KEY

DAMAGE -

int

Level of simulated damage to vehicles. Default 100

KEY

FUEL_RATE -

int

Rate at which fuel is used. Default 1

KEY

TYRE_WEAR -

int

Rate of simulated tyre degradation. Default 1

KEY

TYRE_BLANKETS -

int

Whether tyres will start the session at an operational temperature. Default 0

KEY

SLIPSTREAM -

int

Default 1

Control Configuration

DICT

controls.ini

Configuration of Assetto Corsa's input controls settings, see details bellow

KEY

HEADER -

dict

Configure which controller is used

KEY

X360 -

dict

Specific controller settings

Input Device Selection

DICT

HEADER

Configure which controller is used

KEY

INPUT_METHOD -

str

Which controller the simulation will be controlled by

Input Device Configuration

DICT

X360

Configure specific controller settings

KEY

STEER_THUMB -

str

Which joystick will control steering input. Default "LEFT"

KEY

STEER_GAMMA -

float

Sets the steering response based on joystick position. 1 is linear above one gives more resolution near central positions and less at extremes. Default 1

KEY

STEER_FILTER -

float

Filtering of small changes in steering input. Default 0

KEY

SPEED_SENSITIVITY -

float

Controls maximum steering lock relative to current vehicle speed. Default 1

KEY

STEER_DEADZONE -

float

Amount of joystick movement permitted before steering input will be registered. Default 0

KEY

STEER_SPEED -

float

Speed at which the simulated steering wheel is turned in response to joystick movement. Default 1

KEY

RUMBLE_INTENSITY -

float

Controller vibration intensity. Default 0

UI Configuration

DICT

gameplay.ini

Configuration of Assetto Corsa's UI

KEY

DAMAGE_DISPLAYER -

dict

Configure on scene damage indicator

Damage Display Configuration

DICT

DAMAGE_DISPLAYER

Configuration of Damage Display Indicator

KEY

IS_ACTIVE -

int

Enable or disable the damage display indicator. Default 0