Reference

Command line

Every beamng-assetto command and option.

beamng-assetto [OPTIONS] COMMAND [ARGS]...

The tool has three groups of commands, one per step: kspkg, evo and beamng. beamng-assetto <command> --help prints the same information as this page.

Global options

These options go before the step: beamng-assetto -v evo export ….

-V, --version

Show the version and exit.

-v, --verbose

Show debug messages.

-q, --quiet

Show only errors, and no progress.

-h, --help

Show the help of any command and exit.

Selecting package paths

kspkg list, kspkg extract and kspkg verify share these options:

-i, --include

REGEX

Only paths matching REGEX. Repeatable: a path is kept when any include matches. Paths use /, for example content/tracks/laguna_seca/.

-x, --exclude

REGEX

Leave out paths matching REGEX. Repeatable.

--case-sensitive

Match patterns with letter case. By default case is ignored, as the game does.

`kspkg info`

beamng-assetto kspkg info PACKAGE

A summary of a package, and of anything unusual in its file table.

`kspkg list`

beamng-assetto kspkg list [OPTIONS] PACKAGE

List the entries of a package, sorted by path. The columns are the size, the flags (d directory, x XORed) and the path.

--json

One JSON object per line.

`kspkg extract`

beamng-assetto kspkg extract [OPTIONS] PACKAGE OUTPUT

Extract a package into the folder OUTPUT, exactly as the game reads it. Package paths keep their layout under OUTPUT. Files already extracted from the same package entry are skipped, so a run can be interrupted and started again, and after a game update only changed files are written.

-j, --jobs

INTEGER

Worker threads. Defaults to the number of CPU threads.

--force

Write every selected file, even those up to date.

--prune

Delete files an earlier run extracted that the package no longer has, after a game update.

`kspkg verify`

beamng-assetto kspkg verify [OPTIONS] PACKAGE OUTPUT

Compare the folder OUTPUT with the package, byte for byte. When the whole package is checked, paths in OUTPUT that the package doesn't have are listed too.

-j, --jobs

INTEGER

Worker threads. Defaults to the number of CPU threads.

Shared `evo` options

GAME is content.kspkg, or a folder extracted from it by kspkg extract.

--exe

FILE required

The game's AssettoCorsaEVO.exe, read for its data schemas. Can also be set with the EVO_EXE environment variable.

-o, --out

DIRECTORY

Output folder of step 2. Defaults to work/evo.

`evo tracks`

beamng-assetto evo tracks [OPTIONS] GAME

List the circuits of the game, with their layouts and game modes. Takes --exe and --out.

`evo export`

beamng-assetto evo export [OPTIONS] GAME TRACKS...

Export TRACKS (keys from evo tracks, or all) with every asset they use. Takes --exe and --out.

-p, --part

PART

Only this part. Repeatable; the assets follow what the parts use. One of baking, cameras, containers, decals, instances, layouts, lights, marshals, objects, particles, sound, splines, starts, surfaces, track, zones.

-j, --jobs

INTEGER

Worker processes, 1 to 256. Defaults to every CPU.

--force

Write every asset again, even when up to date.

`evo info`

beamng-assetto evo info [OPTIONS] TRACK

What an export of TRACK holds: parts, layouts, assets, mesh types, problems. Takes --out.

`evo schema`

beamng-assetto evo schema [OPTIONS]

Read the game's data schemas from its executable and cache them. The other evo commands do it when needed. Takes --exe and --out.

Shared `beamng` options

--evo

DIRECTORY

Output folder of step 2 (evo export). Defaults to work/evo.

-o, --out

DIRECTORY

Where the mods are built, one folder per circuit. Defaults to work/beamng.

--user-folder

DIRECTORY

BeamNG.drive's user folder (…/BeamNG.drive/current). Found automatically on Windows and Linux.

`beamng list`

beamng-assetto beamng list [OPTIONS]

The exported circuits, their layouts and the levels they become. Takes --evo.

`beamng build`

beamng-assetto beamng build [OPTIONS] TRACKS...

Build the mods of TRACKS (keys from beamng list, or all for every circuit). Rebuilding only rewrites what changed. Don't rebuild a level while BeamNG has it loaded. Takes --evo, --out and --user-folder.

-l, --layout

TEXT

Only this layout, by EVO's name, in any letter case. Repeatable.

--when

DATE TIME

Local date and time at the start, as YYYY-MM-DD HH:MM or YYYY-MM-DDTHH:MM. Defaults to EVO's race session.

--location

LAT LON UTC_OFFSET

Compute the sun at this place and civil UTC offset (in hours) instead of EVO's.

-j, --jobs

INTEGER

Worker processes, 1 to 256. Defaults to every CPU.

--force

Write every shape and texture again.

--install

Then link the mods into BeamNG.

`beamng install`

beamng-assetto beamng install [OPTIONS] TRACKS...

Link the built mods of TRACKS into BeamNG's mods/unpacked folder. Takes --out and --user-folder.

What isn't converted yet

The parts of an EVO circuit that version 0.0.1 doesn't carry into BeamNG yet, and the values still to check in game.

Python library

Use beamng.assetto's steps from your own Python code.