Getting started

Introduction

What beamng.assetto does, what you get in BeamNG.drive, and what you need to start.

beamng.assetto is a free command-line tool that turns the circuits of Assetto Corsa EVO into BeamNG.drive levels. It works on your own copy of the game: it reads EVO's files on your disk and builds one BeamNG mod per circuit, with one level per layout.

What you get

Every level is made from what EVO itself draws and drives on, using BeamNG's own systems for each job: its terrain, its ground cover, its forest, its AI.

The circuit, 1:1

EVO's own meshes, materials and textures for every driving surface and object, with collision where EVO has it and the grip of each surface.

Its landscape

A BeamNG terrain shaped like EVO's ground, EVO's grass swaying in the wind, its trees, crowds and props.

Places to start

A spawn point at every garage, pit box, pit lane slot and grid slot, and EVO's TV cameras.

Races

A quick race and time trial on EVO's timing lines, and an AI race on EVO's grid.

What you need

  • Assetto Corsa EVO, installed. beamng.assetto reads two of its files: content.kspkg, where the game keeps its content, and AssettoCorsaEVO.exe, where it keeps the layout of its data. Version 0.9.1 is tested.
  • BeamNG.drive to play the levels. Version 0.40 is tested.
  • uv to install the tool. It brings its own Python (3.11 or newer) if you don't have one. Docker works too.
  • Disk space: about 70 GB if you extract the whole game. You can skip that step and read the package directly, then count about 17 GB for every circuit's assets read by step 2, and 1.5 GB for Laguna Seca's mod.
The levels are made of the game's own models and textures. Keep what beamng.assetto extracts and builds to yourself: don't publish or share it. The project contains no game data; anyone who owns the game can build the same levels.

How it works, in short

beamng.assetto works in three steps, one command each. Each step writes files that the next one reads:

  1. Extract the game's content.kspkg into a folder (optional: step 2 can read the package directly).
  2. Read a circuit, part by part, in EVO's own terms.
  3. Build the BeamNG levels, and link them into BeamNG.

Quick start

From the game's files to a lap of Laguna Seca.

How it works

The three steps, and how an EVO track becomes a BeamNG level.
beamng.assetto is an independent project, not affiliated with Kunos Simulazioni or BeamNG GmbH.

beamng.assetto is free software under the GNU AGPL v3.

Not affiliated with Kunos Simulazioni or BeamNG GmbH. Assetto Corsa EVO and BeamNG.drive are trademarks of their owners.