Troubleshooting

A command asks for --exe

Step 2 needs AssettoCorsaEVO.exe, which describes how EVO lays out its data. Pass --exe with its path, or set the EVO_EXE environment variable: see Point to the game's executable.

The extraction stops for lack of space

The extraction checks the free space before it writes anything, and stops if the disk is too small. Free some space, extract to another disk, or extract only what you need. You can also skip extraction: step 2 reads content.kspkg directly.

The level doesn't show up in BeamNG

• Check that the mod is linked: mods/unpacked/evo_<circuit> in BeamNG's user folder should point to work/beamng/evo_<circuit>. Run beamng-assetto beamng install <circuit> to link it.
• If BeamNG's user folder isn't in the usual place, pass it with --user-folder.
• On Windows, the link needs Developer Mode or an administrator terminal. Or copy the mod folder into mods/unpacked/ yourself.
• Restart BeamNG if it was running during the install.

The AI race is missing

BeamNG only looks for missions when it starts: restart it after installing a circuit. Layouts without a race grid in EVO have no AI race.

The level takes minutes to load

The first load after a build is slow: BeamNG converts the circuit's models and textures into its own cache. The next loads are faster.

Something looks wrong after a rebuild

Don't rebuild a level while BeamNG has it loaded. Quit to the menu or close BeamNG, rebuild, and load the level again.

Get more detail

• beamng-assetto -v … shows debug messages; -q shows only errors. Both go before the step: beamng-assetto -v beamng build laguna_seca.
• BeamNG writes its own log, beamng.log, in its user folder.

Report a problem

If something is still wrong, open an issue on GitLab with:

• the command you ran and its output with -v;
• your versions of beamng.assetto (beamng-assetto --version), Assetto Corsa EVO and BeamNG.drive;
• for a problem in game, a screenshot and the circuit, layout and place.