Skip to content

Assetto Corsa Evo: Server Configuration

Learn how to set the track, cars, weather, time, and session duration for your Assetto Corsa Evo game server in server_launcher.json → Learn more

10 November 20265 min read0 Views0 helpful

Introduction

With the right configuration, you can turn your Assetto Corsa Evo game server into exactly the racing experience you have in mind: your own name, password, track, car selection, weather, and session duration. In this guide, we'll show you which settings are available, where to find them in ZapX, and what to keep in mind when editing them.

How the configuration works

Your server reads all settings from the server_launcher.json file in your server's main directory. You can open the file in the Configuration tab by selecting Edit directly, or in the Files tab. The first time it starts, ZapX creates the file with sensible default values: practice at Brands Hatch GP, all cars enabled, and clear weather.

Some values don't need to be changed in the file. You can find them in the Configuration tab under Startup parameters:

Startup parameterMeaning
Server nameYour server's name in the server browser. Default: ZapX Assetto Corsa Evo Server
Server passwordPassword required to join. Leave blank for a public server.
Admin passwordPassword for you as the server operator. Generated automatically when the server is created.

Every time it starts, ZapX writes these values, as well as the ports and the number of slots you've purchased, to the Server section of server_launcher.json. Everything else, such as the track and cars, stays as you configured it in the file.

Important

Never change the server name, passwords, ports, or player count directly in the file. Your server overwrites the values ServerName, DriverPassword, AdminPassword, TcpPort, UdpPort, HttpPort, and MaxPlayers at every start with the values from ZapX.

After you save, ZapX will prompt you to restart the server. Your changes won't take effect until the server has restarted.

Warning

server_launcher.json must remain valid JSON. If the file is empty or invalid when the server starts—for example, because a comma or bracket is missing—the server recreates it with the default values, and your track and car selections will be lost. Before making major changes, download a copy of the file from the Files tab.

Session, time, and weather

Your server runs in Practice mode (GameModeType_PRACTICE) on ZapX. Session settings are in the Sessions section under PracticeSession:

FieldMeaning
LengthSession duration in seconds. Default: 300 (5 minutes)
Hour / MinuteTime on the track when the session starts. Default: 4:00 PM
TimeMultiplierHow quickly time passes on the track. 1 is real time.
MaxWaitToBoxHow long inactive (AFK) drivers can remain before being removed from the server
OvertimeWaitingNextSessionWait time before the next session

If IsCycleEnabled in the Server section is set to true (the default), the session automatically starts over when it ends.

Important

Keep SelectedSessionTypeValue in the Event section set to GameModeType_PRACTICE. Race weekends with qualifying and a race are not currently supported on ZapX and may prevent your server from starting.

You can also set the weather and track conditions in the Event section:

FieldPossible values
SelectedWeatherTypeValueGameModeSelectionWeatherType_CLEAR (default), ..._SCATTERED_CLOUDS, ..._BROKEN_CLOUDS, ..._OVERCAST, ..._DRIZZLE, ..._RAIN, ..._HEAVY_RAIN
SelectedWeatherBehaviorValueGameModeSelectionWeatherBehaviour_STATIC (weather stays the same, default) or GameModeSelectionWeatherBehaviour_DYNAMIC (weather changes)
SelectedInitialGripValueInitialGrip_GREEN (fresh, slippery track, default), InitialGrip_FAST, or InitialGrip_OPTIMUM

Always enter the full values, for example GameModeSelectionWeatherType_RAIN. The ... in the table only indicates the shared beginning of the values.

More settings in the Server section

FieldMeaning
SelectedServerTypeValueMultiplayerServerListSessionType_RANKED (default) or MultiplayerServerListSessionType_UNRANKED
IsCycleEnabledtrue makes the session start over when it ends
SpectatorPasswordPassword for spectators. This value is not overwritten at startup.

FAQ

Frequently asked questions

In the Event section of server_launcher.json, set the SelectedTrackValue field—for example, Monza|GP|GP Time Attack|5793. Copy the value exactly as shown in the track list in the guide.
In server_launcher.json, under Event > Cars, set IsSelected and is_selected to false for the car you want to remove. Don't delete the entry itself.
ZapX writes the server name, passwords, ports, and player count from your startup parameters to the file every time the server starts. Change these settings in the Configuration tab under Startup parameters.

Feedback

Was this article helpful?

Your feedback helps us prioritize and improve content.

0 of 0 Users found this article helpful.

Personal support

Need more help than the guide provides?

Our ZAP support team knows your product — briefly describe your issue and we'll help you personally.

Zappy knows this guide and answers you right in the chat.