Getting started

The game's files

BeamSetto needs the game's content.kspkg extracted into a folder. It doesn't do that part, and this documentation doesn't explain how; here is what the folder must hold, and why.
In short. BeamSetto needs Assetto Corsa EVO's content.kspkgextracted into a folder. BeamSetto doesn't extract it, this documentation doesn't explain how, and the project can't help with it: here is why.

Your own copy, your responsibility

You must own Assetto Corsa EVO. BeamSetto is made for people who bought the game: it converts the files of your own installation, and nothing else. Never use it with game files that don't come from your own copy, and never download them from anyone.
Buy Assetto Corsa EVO on Steam

Extracting content.kspkg from your copy is your responsibility, and so is what you then do with the game's files: they are Kunos Simulazioni's work, under the game's licence.

What BeamSetto needs

BeamSetto needs two things from your installation of the game:

  1. content.kspkg, extracted into a folder. The game keeps almost all of its content in this one package: about 69 GB holding some 117,000 files, from the circuits and the cars to the menus and the game's tables. BeamSetto reads those files from a folder, never from the package itself.
  2. AssettoCorsaEVO.exe, where the game describes how its data is laid out. BeamSetto reads it as it is.

Both are in the game's installation folder (in Steam: right-click the game, then Manage → Browse local files).

What the extracted folder must hold

Every file at the path it has inside the package, unchanged, exactly as the game reads it:

game/
├── content/        the circuits (content/tracks/<circuit>/…) and the assets they share
├── editor/         the game's default materials
├── system/         the game's tables
└── uiresources/    the menu's pictures and maps of each layout
  • These four folders, whole. Step 1 reads each circuit's own folder, but also the assets circuits share, the game's tables and the menu's pictures, wherever they are in these folders. The package's other folders (cfg/, serverconfig/) aren't used: the folder may hold them or not.
  • Anywhere, under any name. The folder can be on any disk; game/ is only the name these pages use. Letter case doesn't matter, as in the game.
  • About 70 GB for the whole package.

Check the folder

Once the folder is ready, and EVO_EXE set, list the game's circuits from it:

Terminal
beamsetto evo tracks game/

If the folder is right, this prints the game's 18 circuits and their layouts. Later, if step 1 reports game files it can't find, the folder lacks those files or holds them under other paths: see Troubleshooting.

Extracting content.kspkg

BeamSetto doesn't do this, and this documentation doesn't explain how.

content.kspkg is an encoded package. BeamSetto never reads it, and the project:

  • includes no code that reads or extracts it;
  • doesn't describe its format;
  • doesn't link to, or recommend, any tool that extracts it;
  • doesn't answer questions about it: issues asking how are closed.

Why

The law protects the technical measures that guard copyrighted content, and it forbids providing a way around them, not only using one. In France, it's article L335-3-1 of the Code de la propriété intellectuelle, from the European Union's copyright directive (2001/29/EC, article 6); other countries have similar rules, such as section 1201 of the US DMCA. Whether the encoding of content.kspkg counts as such a measure has never been decided, and this project doesn't take that risk. So BeamSetto does only what it is for: converting the game's files into BeamNG levels.

Extracting your own copy of the game is up to you, by your own means, and your responsibility. Assetto Corsa EVO's licence has its own terms about the game's software and art: read them.

Keep them to yourself. The game's files, and the levels built from them, are made of Kunos Simulazioni's work: never share or publish them.

Support the people who made it

Assetto Corsa EVO is a superb driving simulator, built with obvious passion by the team at Kunos Simulazioni. Every circuit BeamSetto converts is their work, made from laser scans of the real tracks with care you can feel on every kerb. BeamSetto doesn't replace the game: it lets you enjoy what you already own in another sandbox. If you love these circuits, the credit is theirs. Get Assetto Corsa EVO on Steam, play it, and support its development.

BeamSetto 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.