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.
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 parameter | Meaning |
|---|---|
| Server name | Your server's name in the server browser. Default: ZapX Assetto Corsa Evo Server |
| Server password | Password required to join. Leave blank for a public server. |
| Admin password | Password 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.
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.
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.
Your server runs in Practice mode (GameModeType_PRACTICE) on ZapX. Session settings are in the Sessions section under PracticeSession:
| Field | Meaning |
|---|---|
Length | Session duration in seconds. Default: 300 (5 minutes) |
Hour / Minute | Time on the track when the session starts. Default: 4:00 PM |
TimeMultiplier | How quickly time passes on the track. 1 is real time. |
MaxWaitToBox | How long inactive (AFK) drivers can remain before being removed from the server |
OvertimeWaitingNextSession | Wait 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.
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:
| Field | Possible values |
|---|---|
SelectedWeatherTypeValue | GameModeSelectionWeatherType_CLEAR (default), ..._SCATTERED_CLOUDS, ..._BROKEN_CLOUDS, ..._OVERCAST, ..._DRIZZLE, ..._RAIN, ..._HEAVY_RAIN |
SelectedWeatherBehaviorValue | GameModeSelectionWeatherBehaviour_STATIC (weather stays the same, default) or GameModeSelectionWeatherBehaviour_DYNAMIC (weather changes) |
SelectedInitialGripValue | InitialGrip_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.
| Field | Meaning |
|---|---|
SelectedServerTypeValue | MultiplayerServerListSessionType_RANKED (default) or MultiplayerServerListSessionType_UNRANKED |
IsCycleEnabled | true makes the session start over when it ends |
SpectatorPassword | Password for spectators. This value is not overwritten at startup. |
