How to add mods to an Assetto Corsa server

To add mods to an Assetto Corsa server, upload the car or track files into the server's content folder, then declare them in cfg/server_cfg.ini and cfg/entry_list.ini. Every player must have the same mods in their game. This guide shows the method on a server from our Assetto Corsa server hosting plans. The delivered server already contains the 178 official Kunos cars and the 21 official tracks, DLCs included.

The server must be installed and have started at least once. The guide How to host an Assetto Corsa server explains the Steam sign-in and the first start.

---

What to know before adding a mod

Assetto Corsa has no Steam Workshop. Mods are car and track folders published by the community, on sites such as RaceDepartment or Overtake. A mod is installed on both sides, on the server and on every player's PC.

• The server only uses a mod's data files. For a car, that is the data.acd file or the data folder. For a track, those are the data and ai folders, with the surfaces.ini file. 3D models, textures and sounds stay on the players' side.

• The server and every player must have the same version of the mod, in a folder with the same name.

• A player without the mod cannot join the server. Send them the download link with the version.

• Mods are not covered by our support. A badly made mod can prevent the server from starting.

For the official Kunos cars and tracks, nothing to upload. They are already on the server. Just name them in CARS and TRACK, and make sure your players own the matching DLC.

---

Prepare the files with Content Manager

Content Manager, the community launcher for Assetto Corsa, prepares a complete server from your PC. Its full version has a Server tab that writes server_cfg.ini and entry_list.ini, then gathers the data files of the chosen mods. The Lite version does not have this tab.

1. Install the mod in your own game, in content/cars or content/tracks.

2. In Content Manager, open the Server tab and create a preset with your track, your cars and your sessions.

3. Use the Pack function. Content Manager produces an archive with the cfg and content folders ready for a server.

4. Extract the archive on your PC. You are going to upload its folders to the server.

Without Content Manager, copy the mod folder by hand from your game, keeping only the data files listed above.

Content Manager is a community tool, not one from Kunos or OuiHeberg. It does not connect to your server. It prepares files that you then upload yourself.

---

Upload the files to the server

Mods go into content/cars for cars and content/tracks for tracks, next to the official content. A modded track often weighs several hundred MB, sometimes more than a GB. SFTP is then the right method.

1. In the Console, stop the server with Stop.

2. Connect over SFTP with the guide How to connect via SFTP with FileZilla.

3. Upload the car folder into content/cars, or the track folder into content/tracks, without renaming it.

4. If you have a Content Manager archive, also upload its cfg/server_cfg.ini and cfg/entry_list.ini files in place of the server's files.

These two folders ship with the Kunos server, at its root, and already hold the official content. We have not yet verified the loading of a mod on our servers.

For a small file, the OuiPanel File Manager is enough. It accepts 100 MB per file and can extract an archive uploaded to the server.

If you replace server_cfg.ini with the one from Content Manager, OuiPanel will rewrite the name, the passwords and the ports at startup. The rest of the file is applied as is. Check the number of drivers, MAX_CLIENTS, which cannot exceed the number of pit boxes of the track.

---

Declare the mod in server_cfg.ini and entry_list.ini

If you did not replace the settings files, add the mod by hand. The name to write is that of the folder uploaded into content.

1. In the File Manager, open the cfg folder, then click server_cfg.ini.

2. For a track, write its folder name in TRACK. If it has several layouts, write the one you want in CONFIG_TRACK. This is the name of a subfolder of the track.

3. For a car, add its folder name to CARS, separated from the others by ;.

4. Click Save, then open entry_list.ini.

5. Add one [CAR_n] section per slot for the new car, continuing the numbering without gaps, with MODEL= followed by the folder name.

6. Click Save, then start the server from the Console.

[SERVER]
TRACK=shuto_revival_project_beta
CONFIG_TRACK=layout_c1
CARS=ks_toyota_supra_mkiv;bmw_m3_e30

Folder names are case-sensitive. One extra space or capital letter, and the server cannot find the content.

---

Install the same mods on every player's PC

Each player installs the full mod in their game, with the 3D models and the textures.

1. In the Steam library, right-click Assetto Corsa, then choose Manage › Browse local files.

2. Copy the car folder into content/cars, or the track folder into content/tracks.

3. With Content Manager, just drag the mod archive into the launcher window, which installs it in the right place.

Players who use Content Manager see, on the server's card, the content they are missing. They get no automatic download link. Send them your mod list with the links.

---

CSP and Content Manager on the player's side

Custom Shaders Patch, or CSP, is a graphics and network mod installed in each player's game. It is not required to join the Kunos server. A player with CSP and a player without CSP can drive together on your server.

Some recent modded tracks require CSP to display correctly, and features such as dynamic weather or headlight flashing only exist with CSP and a modified server. Our server is the official Kunos server. It offers neither AI traffic, nor dynamic weather, nor plugins.

For managing drivers once on track, read the guide Assetto Corsa admin commands.

---

If a mod does not work

Symptom	Solution
The server no longer starts after adding the mod	Check the folder name in TRACK or CARS, and that every car in CARS has a slot in entry_list.ini
The server says it cannot find the track	The track folder must be in content/tracks, with its data and ai folders. Also check CONFIG_TRACK for a track with several layouts
A player cannot join	They do not have the mod, or not the same version. Compare the folder name and the version with yours
The player sees the server but the car is greyed out	They are missing the car, or all its slots are taken. Add [CAR_n] sections for that car
The SFTP transfer fails halfway	Resume the transfer. A track of more than a GB can take several minutes. Check the remaining disk space of your plan

---

Need help?

Open a ticket from Tickets › Open a Ticket, or from the Contact support tile at the bottom of your server's page in the client area. You can also ask your question on the OuiHeberg Discord.

Open a ticketDiscord