Difference between revisions of "Server Configuration"

From ACC Wiki (Unofficial)
Jump to navigation Jump to search
Line 754: Line 754:
 
{| class="wikitable sortable mw-datatable"
 
{| class="wikitable sortable mw-datatable"
 
|+ Car Models
 
|+ Car Models
! ID !! Car Model !! Year !! 2018 !! 2019 !! 2020 !! 2021 !! ICGT Challenge !! GTC !! GT4
+
! ID !! Car Model !! Year !! FreeForAll !! GT3 !! GT4 !! GTC !! TCX
 
|-
 
|-
| 0 || Porsche 991 GT3 R || 2018 || {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{yes C|}} || {{no X|}} || {{no X|}}
+
| 0 || Porsche 991 GT3 R || 2018 || {{yes C|}}|| {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}}
 
|-
 
|-
| 1 || Mercedes-AMG GT3 || 2015 || {{yes C|}} || {{yes C|}} || {{yes C|}} || {{no X|}} || {{yes C|}} || {{no X|}} || {{no X|}}
+
| 1 || Mercedes-AMG GT3 || 2015 || {{yes C|}}|| {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}}
 
|-
 
|-
| 2 || Ferrari 488 GT3 || 2018 || {{yes C|}} || {{yes C|}} || {{yes C|}} || {{no X|}} || {{yes C|}} || {{no X|}} || {{no X|}}
+
| 2 || Ferrari 488 GT3 || 2018 || {{yes C|}}|| {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}}
 
|-
 
|-
| 3 || Audi R8 LMS || 2015 || {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{yes C|}} || {{no X|}} || {{no X|}}
+
| 3 || Audi R8 LMS || 2015 || {{yes C|}}|| {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}}
 
|-
 
|-
| 4 || Lamborghini Huracán GT3 || 2015 || {{yes C|}} || {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}}
+
| 4 || Lamborghini Huracán GT3 || 2015 || {{yes C|}}|| {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}}
 
|-
 
|-
| 5 || McLaren 650S GT3 || 2015 || {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}}
+
| 5 || McLaren 650S GT3 || 2015 || {{yes C|}}|| {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}}
 
|-
 
|-
| 6 || Nissan GT-R Nismo GT3 || 2018 || {{yes C|}} || {{yes C|}} || {{no X|}} || {{no X|}} ||  {{yes C|}} || {{no X|}} || {{no X|}}
+
| 6 || Nissan GT-R Nismo GT3 || 2018 || {{yes C|}}|| {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}}
 
|-
 
|-
| 7 || BMW M6 GT3 || 2017 || {{yes C|}} || {{yes C|}} || {{yes C|}} || {{yes C|}} || {{yes C|}} || {{no X|}} || {{no X|}}
+
| 7 || BMW M6 GT3 || 2017 || {{yes C|}}|| {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}}
 
|-
 
|-
| 8 || Bentley Continental GT3 || 2018 || {{yes C|}} || {{yes C|}} || {{yes C|}} || {{yes C|}} || {{yes C|}} || {{no X|}} || {{no X|}}
+
| 8 || Bentley Continental GT3 || 2018 || {{yes C|}}|| {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}}
 
|-
 
|-
| 9 || Porsche 991 II GT3 Cup || 2017 || {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{yes C|}} || {{no X|}}
+
| 9 || Porsche 991 II GT3 Cup || 2017 ||  
 
|-
 
|-
| 10 || Nissan GT-R Nismo GT3 || 2015 || {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{yes C|}} || {{no X|}} || {{no X|}}
+
| 10 || Nissan GT-R Nismo GT3 || 2015 || {{yes C|}}|| {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}}
 
|-
 
|-
| 11 || Bentley Continental GT3 || 2015 || {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}}
+
| 11 || Bentley Continental GT3 || 2015 || {{yes C|}}|| {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}}
 
|-
 
|-
| 12 || AMR V12 Vantage GT3 || 2013 || {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{yes C|}} || {{no X|}} || {{no X|}}
+
| 12 || AMR V12 Vantage GT3 || 2013 || {{yes C|}}|| {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}}
 
|-
 
|-
| 13 || Reiter Engineering R-EX GT3 || 2017 || {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}}
+
| 13 || Reiter Engineering R-EX GT3 || 2017 || {{yes C|}}|| {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}}
 
|-
 
|-
| 14 || Emil Frey Jaguar G3 || 2012 || {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}}
+
| 14 || Emil Frey Jaguar G3 || 2012 || {{yes C|}}|| {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}}
 
|-
 
|-
| 15 || Lexus RC F GT3 || 2016 || {{yes C|}} || {{yes C|}} || {{yes C|}} || {{yes C|}} || {{yes C|}} || {{no X|}} || {{no X|}}
+
| 15 || Lexus RC F GT3 || 2016 || {{yes C|}}|| {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}}
 
|-
 
|-
| 16 || Lamborghini Huracan GT3 Evo || 2019 || {{no X|}} || {{yes C|}} || {{yes C|}} || {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}}
+
| 16 || Lamborghini Huracan GT3 Evo || 2019 || {{yes C|}}|| {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}}
 
|-
 
|-
| 17 || Honda NSX GT3 || 2017 || {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}}|| {{no X|}}
+
| 17 || Honda NSX GT3 || 2017 || {{yes C|}}|| {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}}
 
|-
 
|-
| 18 || Lamborghini Huracan SuperTrofeo || 2015 || {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{yes C|}} || {{no X|}}
+
| 18 || Lamborghini Huracan SuperTrofeo || 2015 ||
 
|-
 
|-
| 19 || Audi R8 LMS Evo || 2019 || {{yes C|}} || {{yes C|}} || {{yes C|}} || {{yes C|}} || {{yes C|}} || {{no X|}} || {{no X|}}
+
| 19 || Audi R8 LMS Evo || 2019 || {{yes C|}}|| {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}}
 
|-
 
|-
| 20 || AMR V8 Vantage || 2019 || {{no X|}} || {{yes C|}} || {{yes C|}} || {{yes C|}} || {{yes C|}} || {{no X|}} || {{no X|}}
+
| 20 || AMR V8 Vantage || 2019 || {{yes C|}}|| {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}}
 
|-
 
|-
| 21 || Honda NSX GT3 Evo || 2019 || {{yes C|}} || {{yes C|}} || {{yes C|}} || {{yes C|}} || {{yes C|}} || {{no X|}} || {{no X|}}
+
| 21 || Honda NSX GT3 Evo || 2019 || {{yes C|}}|| {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}}
 
|-
 
|-
| 22 || McLaren 720S GT3 || 2019 || {{yes C|}} || {{yes C|}} || {{yes C|}} || {{yes C|}} || {{yes C|}} || {{no X|}} || {{no X|}}
+
| 22 || McLaren 720S GT3 || 2019 || {{yes C|}}|| {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}}
 
|-
 
|-
| 23 || Porsche 911 II GT3 R || 2019 || {{yes C|}} || {{yes C|}} || {{yes C|}} || {{yes C|}} || {{yes C|}} || {{no X|}} || {{no X|}}
+
| 23 || Porsche 911 II GT3 R || 2019 || {{yes C|}}|| {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}}
 
|-
 
|-
| 24 || Ferrari 488 GT3 Evo || 2020  || {{no X|}} || {{no X|}} || {{yes C|}} || {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}}
+
| 24 || Ferrari 488 GT3 Evo || 2020  || {{yes C|}}|| {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}}
 
|-
 
|-
| 25 || Mercedes-AMG GT3 || 2020  || {{no X|}} || {{no X|}} || {{yes C|}} || {{yes C|}} || {{no X|}} || {{no X|}} ||{{no X|}}
+
| 25 || Mercedes-AMG GT3 || 2020  || {{yes C|}}|| {{yes C|}} || {{no X|}} || {{no X|}} || {{no X|}}
 
|-
 
|-
| 26 || Ferrari 488 Challenge Evo || 2020 ||  
+
| 26 || Ferrari 488 Challenge Evo || 2020 || {{yes C|}}
 
|-
 
|-
| 27 || BMW M2 Club Sport Racing || 2020 ||  
+
| 27 || BMW M2 Club Sport Racing || 2020 || {{yes C|}}
 
|-
 
|-
| 28 || Porsche 992 GT3 Cup || 2021 ||  
+
| 28 || Porsche 992 GT3 Cup || 2021 || {{yes C|}}
 
|-
 
|-
| 29 || Lamborghini Huracán SuperTrofeo EVO2 || 2021 ||  
+
| 29 || Lamborghini Huracán SuperTrofeo EVO2 || 2021 || {{yes C|}}
 
|-
 
|-
| 30 || BMW M4 GT3 || 2022 ||  
+
| 30 || BMW M4 GT3 || 2022 || {{yes C|}}
 
|-
 
|-
| 31 || Audi R8 LMS GT3 Evo 2 || 2022 ||  
+
| 31 || Audi R8 LMS GT3 Evo 2 || 2022 || {{yes C|}}
 
|-
 
|-
| 50 || Alpine A110 GT4 || 2018 || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{yes C|}}
+
| 50 || Alpine A110 GT4 || 2018 || {{yes C|}} || {{no X|}} || {{no X|}} || {{yes C|}} || {{no X|}}
 
|-
 
|-
| 51 || Aston Martin Vantage GT4 || 2018 || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{yes C|}}
+
| 51 || Aston Martin Vantage GT4 || 2018 || {{yes C|}} || {{no X|}} || {{no X|}} || {{yes C|}} || {{no X|}}
 
|-
 
|-
| 52 || Audi R8 LMS GT4 || 2018 || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{yes C|}}
+
| 52 || Audi R8 LMS GT4 || 2018 || {{yes C|}} || {{no X|}} || {{no X|}} || {{yes C|}} || {{no X|}}
 
|-
 
|-
| 53 || BMW M4 GT4 || 2018 || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{yes C|}}
+
| 53 || BMW M4 GT4 || 2018 || {{yes C|}} || {{no X|}} || {{no X|}} || {{yes C|}} || {{no X|}}
 
|-
 
|-
| 54 ||  
+
| 55 || Chevrolet Camaro GT4 || 2017 || {{yes C|}} || {{no X|}} || {{no X|}} || {{yes C|}} || {{no X|}}
 
|-
 
|-
| 55 || Chevrolet Camaro GT4 || 2017 || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{yes C|}}
+
| 56 || Ginetta G55 GT4 || 2012 || {{yes C|}} || {{no X|}} || {{no X|}} || {{yes C|}} || {{no X|}}
 
|-
 
|-
| 56 || Ginetta G55 GT4 || 2012 || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{yes C|}}
+
| 57 || KTM X-Bow GT4 || 2016 || {{yes C|}} || {{no X|}} || {{no X|}} || {{yes C|}} || {{no X|}}
 
|-
 
|-
| 57 || KTM X-Bow GT4 || 2016 || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{yes C|}}
+
| 58 || Maserati MC GT4 || 2016 || {{yes C|}} || {{no X|}} || {{no X|}} || {{yes C|}} || {{no X|}}
 
|-
 
|-
| 58 || Maserati MC GT4 || 2016 || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{yes C|}}
+
| 59 || McLaren 570S GT4 || 2016 || {{yes C|}} || {{no X|}} || {{no X|}} || {{yes C|}} || {{no X|}}
|-
 
| 59 || McLaren 570S GT4 || 2016 || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{yes C|}}
 
 
|-
 
|-
 
| 60 || Mercedes AMG GT4 || 2016 || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{yes C|}}
 
| 60 || Mercedes AMG GT4 || 2016 || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{yes C|}}
 
|-
 
|-
| 61 || Porsche 718 Cayman GT4 Clubsport || 2019 || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{no X|}} || {{yes C|}}
+
| 61 || Porsche 718 Cayman GT4 Clubsport || 2019 || {{yes C|}} || {{no X|}} || {{no X|}} || {{yes C|}} || {{no X|}}
 
|}
 
|}
 
</div>
 
</div>

Revision as of 15:51, 5 April 2022


Other languages:
Deutsch • ‎English
ACC Dedicated Server.png

Windows / Linux

Windows specific

Default Installation Path
C:\Program Files (x86)\Steam\steamapps\common\Assetto Corsa Competizione Dedicated Server\server\server.exe

Change the configuration.json, event.json and settings.js under the cfg Folder for your needs. After that you can Doubleclick on the accServer.exe to Start the Server. Keep in mind that you need to make Port Forwarding on your Router to get Players on your Server. Else it's just Locally accessible.

Linux specific (Ubuntu 18.04)

We need Wine because there is no Nativ Binary for Linux.

sudo apt-get install wine-development

Copy now all Server Files from your Windows System where you have ACC Installed to the Linux Server. After that you can Start your Server with

wine ./accServer.exe

You need to have "ignorePrematureDisconnects":0 in settings.json

Installation

After version 1.5.7, the Assetto Corsa Competizione dedicated server and Broadcast SDK is transferred to and now available as a separate download in the "Assetto Corsa Competizione Dedicated Server" item in the Steam Tools library.

Install in Steam under Tools "Assetto Corsa Competizione Dedicated Server" and you find all this under "..:\Steam\steamapps\common\Assetto Corsa Competizione Dedicated Server".

Folders Description
cfg The files for setting up a multiplayer server are located in this folder. In the further course of this description, you will be shown what additional folders and files are added automatically or manually.
cfg current If you have started a server, .txt-files are generated here. With these you can check whether the server was started with your parameters. If a parameter was not accepted, you made a mistake in the .json-file.
log This folder contains the server.log file, which permanently records what happens on the server.
results The results of qualifications and races are stored here.
sdk broadcasting
server contains the executable file accServer.exe and the official server manual from Kunos as a PDF file
server cfg ^^ currently I can't find any meaning of the additional cfg folder

cfg-Folder

...\Steam\steamapps\common\Assetto Corsa Competizione Dedicated Server\cfg\

Link to Description
assistRules.json ↓assistRules.json
configuration.json ↓configuration.json
event.json ↓event.json
settings.json ↓settings.json

In the further course of this description, you will be shown what additional folders and files are added automatically or manually.

current-Folder

If you start accServer.exe now, a folder "current" will be created in "cfg" Folder. This contains your settings from the .json-files as a text file.

If you make a mistake in .json, it will be corrected when the server is started and will be displayed in the text file. This gives you another way to go about troubleshooting.

Compare them with your settings at:
configuration.txt ↓configuration.json
entrylist.txt ↓entrylist.json
event.txt ↓event.json
eventRules.txt ↓eventRules.json
settings.txt ↓settings.json

Configuration

The server is exclusively configured via JSON files in UTF16-LE format. In general, it is a good idea to get used to the JSON syntax, and/or test your configurations with an syntax check on https://jsonformatter.curiousconcept.com/.

To get a clean start, you can just remove the .json files and start the server once, it will autogenerate them with current defaults. Additionally, you can reduce the “configVersion” contained in each file to get new properties generated (this is true for all the configs). Certain “advanced” settings will be hidden when the value is set to it’s default during this process.

The configuration is split into different files, which represent different levels of what you would possibly like to keep or change frequently:

configuration.json

  • Here we define the very technical settings that possibly never change and define the server “identity”.
  • The most important thing to know is that both ports must be unique on the system, the firewall allows connections and the ports are accessible from the internet.
Property Description
tcpPort ACC clients will use this port to establish a connection to the server
udpPort Connected clients will use this Port to stream the car positions and is used for the ping test. In case you never see your server getting a ping value, this indicates that the udpPort is not accessible
registerToLobby
  • 0 = This server is not registered in the backend. the server is declared →Private Multiplayer. Is useful for LAN sessions.
  • 1 = this server register to the backend. the server is declared →Public Multiplayer.
maxConnections The maximum amount of connections a server will accept at a time. If you own the hardware server, you can just set any high number you want. If you rented a 16 or 24 slot server, your Hosting Provider probably has set this here and doesn’t give you write-access to this configuration file.
lanDiscovery Defines if the server will listen to LAN discovery requests. Can be turned off for dedicated servers.
configVersion ...

Attention: Running a server on a private PC is not recommended. It requires opening and forwarding Ports onto your private system, which makes it vulnerable to random and/or malicious internet traffic. Additionally, private ISP bandwidth is often asymmetrically limited in the upload, which can easily lead to a bad server performance and in the result in a bad multiplayer experience for everyone around.

settings.json

The setting defines your personal server settings, which may be changed from time to time, but also define the server.

Property Description
serverName The server name displayed in the ACC UI pages
adminPassword The password you specify allows a driver or spectator to log in as Server Admin in the chat window ( ENTER key ) of the server.
carGroup Defines the car group for this server. Possible values are
  • FreeForAll = where “FreeForAll” will allow any driver to join with any car ( that he defined as Primary Car ).
  • GT3 = Limit this server to GT3 Vehicles
  • GT4 = Limit this server to GT4 Vehicles
  • GTC = Limit this server to Porsche 991 II GT3 Cup + Lamborghini Huracan Super Trofeo
trackMedalsRequirement Defines the amount of track medals that a user has to have for the given track
  • values: 0, 1, 2, 3
safetyRatingRequirement Defines the Safety Rating (SA) that a user must have to join this server
  • values: -1, 0, 1, 2, 3, 4, .... 97, 98, 99
racecraftRatingRequirement Defines the Racecraft Rating (RC) that a user must have to join this server
  • values: -1, 0, 1, 2, 3, 4, .... 97, 98, 99
password Password required to enter this server. If a password is set, the server is declared →Private Multiplayer.
spectatorPassword Password to enter the server as spectator. Must be different to “password” if both is set.
maxCarSlots Defines the amount of car slots the server can occupy; this value is overridden if the pit count of the track is lower, or with 30 for public MP. The gap between maxCarSlots and maxConnections ( in configuration.json ) defines how many spectators or other irregular connections ( ie entry list entries ) can be on the server.
dumpLeaderboards If set to 1, any session will write down the result leaderboard in a “results” folder ( must be manually created ).
dumpEntryList Will save an entry list at the end of any Qualifying session. This can be a quick way to collect a starting point to build an entry list, and is a way to save the defaultGridPositions which can be used to run a race without Qualifying session and predefined grid. Also see the corresponding admin command.
isRaceLocked If set to 0, the server will allow joining during a race session. Is not useful in →Public Multiplayer, as the user-server matching will ignore ongoing race sessions.
shortFormationLap
formationLapType Toggles the formation lap type that is permanently used on this server:
  • 5 = short formation lap with position control and UI + 1 ghosted cars lap
  • 4 = one free formation lap + 1 ghosted cars lap
  • 3 – default formation lap with position control and UI
  • 1 – old limiter lap
  • 0 – free (replaces /manual start), only usable for private servers
doDriverSwapBroadcast ?
randomizeTrackWhenEmpty If set to 1, the server will change to a random track when the last drivers leaves ( which causes a reset to FP1 ). The “track” property will only define the default state for the first session.
centralEntryListPath Can override the default entryList path “cfg/entrylist.json”, so multiple ACC servers on the machine can use the same entrylist ( and custom car files ). Set a full path like “C:/customEntryListSeriesA/”, where the entrylist is stored.

Attention: The path seperators have to be slashes ( / ), backslashes ( \ ) will not work.

allowAutoDQ If set to 0, the server won’t automatically disqualify drivers, and instead hand out Stop&Go ( 30 Secounds ) penalties. This way a server admin / race director has 3 laps time to review the incident, and either use /dq or /clear based on his judgement.
ignorePrematureDisconnects Removes a ( very good ) fix where users can randomly lose the connection. There is no sane reason to turn this off.
  • 1 – default: less arbitrary connections lost
  • 0 – more timeouts, but strict disconnection of anyone who

appears inactive for 5 seconds. Can be useful on unsupported platforms where TCP sockets act differently

configVersion

event.json

Defines the race weekend the server runs. This configuration file is meant to be swappable, so you can easily switch between different event templates by renaming/overwriting them.

Property Description
track The track we run.

Setting a wrong value will also print out the available track keys in the log. With the 1.1 update containing the 2019 season content, each track has a _2019 variant. Using this track will set the BoP and track grip correspondingly.

preRaceWaitingTimeSeconds Preparation time before a race. Cannot be less than 30s.
sessionOverTimeSeconds Time after that a session is forcibly closing after the timer reached '0:00. Something like 107% of the expected laptime is recommended.
  • Careful: default 2 minutes does not properly cover tracks like Spa or Silverstone
ambientTemp Sets the baseline ambient temperature in °C.
cloudLevel Sets the baseline cloud level, →Race Weekend Simulation.
  • Values 0.0, 0.1, .... 1.0
rain If weather randomness is off, defines the static rain level. With dynamic weather, it increases the rain chance.

Values greater than 0.1 can override the value of cloudLevel.

weatherRandomness Sets the dynamic weather level:
  • 0 = static weather
  • 1 - 4 = fairly realistic weather
  • 5 - 7 = more sensational
postQualySeconds The time after the last driver is finished ( or the sessionOverTimeSeconds passed ) in Q sessions and the race start. Should not be set to 0, otherwise grid spawning is not secure.
postRaceSeconds Additional time after the race ended for everyone, before the next race weekend starts.
metaData A user defined string that will be transferred to the result outputs.
simracerWeatherConditions Experimental / not supported: if set to 1, this will limit the maximum rain/wetness to roughly 2/3 of the maximum values, translating to something between medium and heavy rain. It may be useful if you feel forced to run very low cloudLevel and weatherRandomness values just to avoid thunderstorm; however high levels (0.4+ clouds combined with 5+ randomness) will still result in quite serious conditions.
isFixedConditionQualification Experimental / not supported: if set to 1, the server will take the rain, cloud, temperature, rain levels literally and make sure whatever is set up never changes. Daytime transitions still happen visually, but do not affect the temperatures or road wetness. Also rubber/grip is always the same. This is intended to be used for private league qualification servers only.
sessions A list of session objects, see the next table
Property Description
hourOfDay Session starting hour of the day
  • Values 0, 1, 2 ... 22, 23
dayOfWeekend Race weekend day / →Race Weekend Simulation:
  • 1 = Friday
  • 2 = Saturday
  • 3 = Sunday
timeMultiplier Rate at which the session time advances in realtime.
  • Values 0, 1, ... 24
sessionType Race session type:
  • P = ( P )ractice
  • Q = ( Q )ualifying
  • R = ( R )ace
sessionDurationMinutes Session duration in minutes
  • Remarks:
  1. At least one non-race session must be set up
  2. Setting up unreasonable day and hours ( also consider time multipliers ! ) can lead to wrong track and weather behaviour, e.g. avoid jumping from Saturday to Friday

eventRules.json

Defines the pitstop rules. Public MP servers will ignore this json file and use default values.

The basic pitstop features offer a huge array of combinations and different aspects you can set up your non-public races. Not every combination does make sense though, so it’s your responsibility to setup the rules so drivers have a good experience. It should be entirely possible to create a race in the style of a single Sprint series race as well as a 3-24h endurance race with or without driver swaps. Of course this shouldn’t limit you to think about your series and especially race event durations, and possibly add more fairness to balance fuel efficient cars – or allow a certain depth of tactics.

Additional notes regarding stints:

  • Stint timer (top left corner in the timing HUD) is reset when the car crosses the pit entry and starts counting down again when crossing the pit exit.
  • When serving a penalty, the stint timer will freeze and continue counting down after pit exit without resetting.
  • When a player's total remaining driving time is less than his current stint time, the total driving time will override the stint timer (!).

When this happens, the stint timer's background turns red, indicating the final stint of the active driver.

Property Description
qualifyStandingType
  • 1 = fastest lap
  • 2 = average lap ( running Endurance mode for multiple Q sessions )

Use 1, averaging Qualy is not yet officially supported.

superpoleMaxCar Not currently listed or described in the Kunos Server Admin manual
pitWindowLengthSec Defines a pit window at the middle of the race. Obviously covers the Sprint series format.
  • -1 = will disable the pit window
  • 600 = Insert the length of the pit stop window here in seconds. ( 10 minutes = 600 seconds ) - Only use with ↓mandatoryPitstopCount with a value of 1 or higher.
driverStintTimeSec Defines the maximum time a driver can stay out without getting a penalty. Can be used to balance fuel efficient cars in endurance races. The stint time resets in the pitlane, no real stop is required.
  • 3300 ( = 55 Minutes )
  • -1 will disable the stint times
isRefuellingAllowedInRace Defines if refuelling is allowed during the race pitstops.
  • true = refueling possible during the race
  • false = No refueling possible during the race
isRefuellingTimeFixed If set to true, any refuelling will take the same amount of time ( 25 seconds ). If turned off, refuelling will consume time linear to the amount refuelled. Very useful setting to balance fuel efficient cars, especially if combined with other features.
mandatoryPitstopCount Defines the basic mandatory pit stops. If the value is greater zero, any car that did not execute the mandatory pitstops will be disqualified at the end of the race. The necessary actions can be further configured using the “isMandatoryPitstopXYRequired” properties. A value of zero disables the feature.
maxTotalDrivingTime Restricts the maximum driving time for a single driver. Is only useful for driver swap situations and allows to enforce a minimum driving time for each driver ( IRL this is used to make sure mixed teams like Pro/Am have a fair distributions of the slower drivers ). -1 disables the feature.
maxDriversCount In driver swap situations, set this to the maximum number of drivers on a car. The maxTotalDrivingTime property will be scaled down to apply to teams with less drivers.
isMandatoryPitstopRefuellingRequired Defines if a mandatory pitstop requires refuelling.
  • true = every driver must refuel at least 1 liter
  • false = refuel as needed
isMandatoryPitstopTyreChangeRequired Defines if a mandatory pitstop requires changing tyres.
  • true = every driver must tyre change
  • false = tyre change as needed
isMandatoryPitstopSwapDriverRequired Defines if a mandatory pitstop requires a driver swap. Will only be effective for cars in driver swap situations; even in a mixed field this will be skipped for cars with a team size of 1 driver.
tyreSetCount Specify the number of permitted tire sets, 1-50 are possible. Not currently listed or described in the Kunos Server Admin manual

assistRules.json

Can be used to turn off certain assists for any car connected to this server. Beware: disabling assists will effectively remove the effect, but there is no special handling how the assists look like in the menu. Without instructions, users will be surprised and confused – up to a point where they become a risk for other drivers. Whenever you think about disabling something, please be sure this is really necessary and a risk in terms of fairness. It is out of question that the ( quite strong ) driving aids “Stability Control” and “Autosteer” may be candidates for league racing, but just turning off the ideal line will not improve anything for anyone (except that the one driver using it may become less safe and ruins the race of others). Even innocent elements like auto-engine start and pit limiter may just force users to re-map their wheels, and for example lose the ability to use their indicators in lapping traffic – again nobody is winning in this scenario.

For (very) obvious reasons, public MP servers will ignore this json file and allow everything.

Property Description
stabilityControlLevelMax Set’s the maximum % of SC that can be used. In case a client has a higher SC set than allowed by the server, he will only run what is allowed (25% in this example). Obviously setting this property to 0 removes all SC, including mouse and keyboard users.

The Stability Control is an artificial driving aid that allows the car to act out of the physics boundaries, and highly recommended to overcome input methods like Keyboards, Gamepads and Mouse steering. However, there is a built-in effect that makes the SC performance inferior, so in theory using (and relying) on SC is already more than enough penalty, and the way to improve performance is to practice driving without.

  • Default: 100
disableAutosteer Disables the steering aid that is only available for gamepad controllers. Unlike SC, this works inside the physics and does not allow unrealistic driving behaviour – except that this is a very strong aid with superhuman feeling for grip and high reaction speed. There is a built-in penalty that should balance the driving performance in most cases, and give an incentive to learn not to use the driving aid.
  • Default: 0
disableIdealLine
  • 1 = Forces the equivalent assist option to “off”
disableAutoPitLimiter
  • 1 = Forces the equivalent assist option to “off”
disableAutoGear
  • 1 = Forces the equivalent assist option to “off”
disableAutoClutch
  • 1 = Forces the equivalent assist option to “off”
disableAutoEngineStart
  • 1 = Forces the equivalent assist option to “off”
disableAutoWiper
  • 1 = Forces the equivalent assist option to “off”
disableAutoLights
  • 1 = Forces the equivalent assist option to “off”

entrylist.json

Acc-wiki server entrylists.jpg

Using entry lists a server admin can setup special roles that link drivers (by Steam Id) to those configuration entries.

It allows the server to identify persons, and allows to force or allow various aspects. Entry list entries will always bypass Rating Requirements, and will be able to join servers even if they are full (as long as we have pit slots left, and the driver number is smaller than configuration.json/ maxClients).

To start, just add a new file called entrylist.json in the “cfg” folder. Using an entry list does not interfere with the classification of “Public” or “Private” MP, and you can selectively use an entry to e.g. reserve a slot for you in a Public MP server. Serious groups might use slots for their members and run a race with a 90 SA restriction in Public MP to fill up their rows with highly capable “randoms”.

File Content
Example: 1x Driver as Admin / 2 Drivers as Team
Property Description

{
"entries": [
{
"drivers": [
{
"playerID": "S765611xxxxxxxxxx1"
}
],
"raceNumber": 88,
"forcedCarModel": -1,
"overrideDriverInfo": 0,
"isServerAdmin": 1
},
{
"drivers": [
{
"firstName": "First",
"lastName": "Driver",
"shortName": "NO1",
"driverCategory": 2,
"playerID": "S765611xxxxxxxxxx3"
},
{
"firstName": "Another",
"lastName": "Person",
"shortName": "NO2",
"driverCategory": 1,
"playerID": "S765611xxxxxxxxxx4"
}
],
"raceNumber": 114,
"forcedCarModel": -1,
"overrideDriverInfo": 0,
"defaultGridPosition": -1,
"ballastKg": 0,
"restrictor": 0,
"customCar": "exampleCar.json",
"overrideCarModelForCustomCar": 1,
"isServerAdmin": 0
}
],
"forceEntryList": 0
}

entries List of entries
drivers List of drivers, see next table. Must at least contain one driver with the SteamId
raceNumber The preferred race number add.
  • -1 if the driver may decide by picking his car.
  • other values: 1, 2, 3 .... 996, 997, 998
forcedCarModel
  • -1: the driver may pick which car to drive.
  • other values: ↓Car model list
overrideDriverInfo If set to 1, the driver’s name and category will be overridden by what is setup in the entry list. If set to 0, it’s up to the client joining.
customCar If set to a filename, the car, team and appearance will be used no matter what the user chose ( Exception: overrideCarModelForCustomCar ). This is useful for leagues and events, where we want consistent car appearance and the chosen car model for the corresponding driver/team. The custom car file has to be located in a “cars” folder next to the entrylist.json ( also works for centralEntryListPath ). Leave blank ( “”, =default ) to let the user chose the car via car selection UI.
overrideCarModelForCustomCar If customCar is used, this setting will apply the car model configured if the value is set to 1 (which is the default). If set to 0, all values except the carModel are applied, so the user is free to pick a car but while team name and appearance will be applied.
isServerAdmin If set to 1, that user will be automatically elevated to server admin when he joins.
defaultGridPosition If set to a value of 1 or greater, this car will obtain this grid position if a race starts without any qualifying session before ( e.g. P -> R ).
ballastkg Assigns ballast in kg for this car. Will be additive to ballast for the car model ( via bop.json ), and can be overridden by the admin command /ballast. Range is 0 to 100.
restrictor Assigns restrictor in % for this car. Will be additive to restrictor for the car model ( via bop.json ), and can be overridden by the admin command /restrictor. Range is 0 to 20.
forceEntryList Will reject drivers that are not in the entry list. Default is 0, which allows the partial definition of entries in a “normal” server configuration. Cannot be used on public servers.
For each entry in “drivers”, we will need at least the SteamId defining the entry. Other possible. values:
firstName First name of the driver, if “overrideDriverInfo” is set to 1
lastName Last name of the driver, if “overrideDriverInfo” is set to 1
shortName Short name of the driver, if “overrideDriverInfo” is set to 1
driverCategory Bronze / Silver / Gold / Platinum category, if “overrideDriverInfo” is set to 1.
playerID Steam64 Id for this client; Add a “S” in the front

bop.json

In addition to the admin commands and entry list based ballast and restrictor, you globally define those values for car and track combinations.

To accomplish this, just add a bop.json like this:

File Content Property Description

{
"entries": [
{
"track": "zolder",
"carModel": 7,
"ballastKg": 1,
"restrictor": 2
},
{
"track": "silverstone_2019",
"carModel": 2,
"restrictor": 5
}
]
}

entries
track enter a Racetrack here
carModel enter a CarModel here
ballast Assigns ballast in kg for this car. Can be overridden by the admin command /ballast.
restrictor Assigns restrictor in % for this car. Can be overridden by the admin command /restrictor.

Each “entry” can be understood as a line with a composite key of track and car model, and the ballast/restrictor are applied if both math. This way you can apply a small balance to one precise combination, or create your full blown custom BoP for all kinds of seasons, tracks and cars.

Important notes:

  1. The additional BoP is at the moment adjustable on public servers, but we will look at this closely. If we see bad and overdone efforts that affect the experience of average users, we will limit the additional BoP to private servers
  2. It is very hard to improve the current BoP, much harder than it may look (especially for 2019, where SRO did a great job). Do not fall for the mistake to use hotlap performance as the reference, and also make sure to start with tiny adjustments.

The values of the bop.json act additive to the entry list, so you can combine a championship penalty with your track/car specific changes. Any admin command (/ballast or /restrictor) will set the corresponding value to whatever you define, and overwrite potential configurations until the car rejoins.

Result Files

Using the “dumpLeaderboards”: 1 option, any session that is finished will write the final standing into a .json file in the “results” folder. Those files are generated with a filename in the pattern of “190806_193009_R.json”, including date, time and session type (P, Q, R).

File Content

{
"sessionType": "R",
"trackName": "silverstone",
"sessionIndex": 1,
"sessionResult": {
"bestlap": 117915,
"bestSplits": [
34770,
49359,
33258
],
"isWetSession": 0,
"type": 1,
"leaderBoardLines": [
{
"car": {
"carId": 1073,
"raceNumber": 912,
"carModel": 0,
"cupCategory": 0,
"teamName": "",
"drivers": [
{
"firstName": "Somebody",
"lastName": "Else",
"shortName": "SOE",
"playerId": "S76561191111111111"
}
]
},
"currentDriver": {
"firstName": "Somebody",
"lastName": "Else",
"shortName": "SOE",
"playerId": "S76561191111111111"
},
"currentDriverIndex": 0,
"timing": {
"lastLap": 119223,
"lastSplits": [
35286,
50178,
33759
],
"bestLap": 118404,
"bestSplits": [
35265,
49659,
33438
],
"totalTime": 719894,
"lapCount": 6,
"lastSplitId": 0
},
"missingMandatoryPitstop": 0,
"driverTotalTimes": [
0.0
]
}, ...
]
},
"laps": [
{
"carId": 1073,
"driverIndex": 0,
"laptime": 125511,
"isValidForBest": true,
"splits": [
40197,
51537,
33777
]
}, ...
],
"penalties": [
{
"carId": 1079,
"driverIndex": 0,
"reason": "Cutting",
"penalty": "DriveThrough",
"penaltyValue": 3,
"violationInLap": 0,
"clearedInLap": 1
},
{
"carId": 1081,
"driverIndex": 0,
"reason": "PitSpeeding",
"penalty": "StopAndGo_20",
"penaltyValue": 20,
"violationInLap": 4,
"clearedInLap": 5
}
]
}

In a nutshell, the root object contains information about the session and track, next to a leaderboard representation, a complete list of laps and a complete list of penalties for this session. The properties should be self-explanatory, in case of doubts and questions please do not hesitate to join the official support forum.

Spectator Mode

The necessary server settings: The difference between "maxConnections": 40; ( configuration.json ) and "maxCarSlots": 30; ( settings.json ) defines How many seats are available on the server. In this case, it is 10. Now only one password has to be assigned. This must be different than what is stated for the accession of the driver. Check also:

  • configuration.json / maxConnections
  • settings.json / spectatorPassword
  • settings.json / maxCarSlots

If someone wants to join a server as a spectator, he must enter the password for the spectator mode.

ID Lists

Removed all “_2019”, “_2020”, “_2021” track suffixes, please just use the track name in any configuration now

Track Name ID's
barcelona
brands_hatch
hungaroring
kyalami
laguna_seca
misano
monza
mount_panorama
nurburgring
paul_ricard
silverstone
spa
suzuka
zolder
zandvoort
imola
oulton_park
donington
snetterton
Car Models
ID Car Model Year FreeForAll GT3 GT4 GTC TCX
0 Porsche 991 GT3 R 2018 Green check.webp Green check.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp
1 Mercedes-AMG GT3 2015 Green check.webp Green check.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp
2 Ferrari 488 GT3 2018 Green check.webp Green check.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp
3 Audi R8 LMS 2015 Green check.webp Green check.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp
4 Lamborghini Huracán GT3 2015 Green check.webp Green check.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp
5 McLaren 650S GT3 2015 Green check.webp Green check.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp
6 Nissan GT-R Nismo GT3 2018 Green check.webp Green check.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp
7 BMW M6 GT3 2017 Green check.webp Green check.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp
8 Bentley Continental GT3 2018 Green check.webp Green check.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp
9 Porsche 991 II GT3 Cup 2017
10 Nissan GT-R Nismo GT3 2015 Green check.webp Green check.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp
11 Bentley Continental GT3 2015 Green check.webp Green check.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp
12 AMR V12 Vantage GT3 2013 Green check.webp Green check.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp
13 Reiter Engineering R-EX GT3 2017 Green check.webp Green check.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp
14 Emil Frey Jaguar G3 2012 Green check.webp Green check.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp
15 Lexus RC F GT3 2016 Green check.webp Green check.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp
16 Lamborghini Huracan GT3 Evo 2019 Green check.webp Green check.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp
17 Honda NSX GT3 2017 Green check.webp Green check.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp
18 Lamborghini Huracan SuperTrofeo 2015
19 Audi R8 LMS Evo 2019 Green check.webp Green check.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp
20 AMR V8 Vantage 2019 Green check.webp Green check.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp
21 Honda NSX GT3 Evo 2019 Green check.webp Green check.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp
22 McLaren 720S GT3 2019 Green check.webp Green check.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp
23 Porsche 911 II GT3 R 2019 Green check.webp Green check.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp
24 Ferrari 488 GT3 Evo 2020 Green check.webp Green check.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp
25 Mercedes-AMG GT3 2020 Green check.webp Green check.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp
26 Ferrari 488 Challenge Evo 2020 Green check.webp
27 BMW M2 Club Sport Racing 2020 Green check.webp
28 Porsche 992 GT3 Cup 2021 Green check.webp
29 Lamborghini Huracán SuperTrofeo EVO2 2021 Green check.webp
30 BMW M4 GT3 2022 Green check.webp
31 Audi R8 LMS GT3 Evo 2 2022 Green check.webp
50 Alpine A110 GT4 2018 Green check.webp Dark Red x.webp Dark Red x.webp Green check.webp Dark Red x.webp
51 Aston Martin Vantage GT4 2018 Green check.webp Dark Red x.webp Dark Red x.webp Green check.webp Dark Red x.webp
52 Audi R8 LMS GT4 2018 Green check.webp Dark Red x.webp Dark Red x.webp Green check.webp Dark Red x.webp
53 BMW M4 GT4 2018 Green check.webp Dark Red x.webp Dark Red x.webp Green check.webp Dark Red x.webp
55 Chevrolet Camaro GT4 2017 Green check.webp Dark Red x.webp Dark Red x.webp Green check.webp Dark Red x.webp
56 Ginetta G55 GT4 2012 Green check.webp Dark Red x.webp Dark Red x.webp Green check.webp Dark Red x.webp
57 KTM X-Bow GT4 2016 Green check.webp Dark Red x.webp Dark Red x.webp Green check.webp Dark Red x.webp
58 Maserati MC GT4 2016 Green check.webp Dark Red x.webp Dark Red x.webp Green check.webp Dark Red x.webp
59 McLaren 570S GT4 2016 Green check.webp Dark Red x.webp Dark Red x.webp Green check.webp Dark Red x.webp
60 Mercedes AMG GT4 2016 Dark Red x.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp Dark Red x.webp Green check.webp
61 Porsche 718 Cayman GT4 Clubsport 2019 Green check.webp Dark Red x.webp Dark Red x.webp Green check.webp Dark Red x.webp
Driver Categorys
ID Category
3 Platinum
2 Gold
1 Silver
0 Bronze
Cup Categorys
ID Category
0 Overall
1 ProAm
2 Am
3 Silver
4 National
Session Types
ID Session Type
0 Practice
4 Qualifying
10 Race

Admin Commands

While connected to a server ( both as driver and spectator ), users can elevate to “server admins” if they are aware of the password. That allows them to use a few special commands. Version 1.0 start with a limited set, which is expected to be extended in future versions. To elevate to admin, hit “enter” to use the chat and type /admin adminPw123. A notification will tell you if successful. Additionally, you can setup an “Entry lists” entry for the admin(s) steamids.

Once elevated, you can use several commands:
Command Number Description
/next Skips the current session
/restart Restarts the current session. Do not use this during the preparation phase
Insert a space between the command and the start number / Kg / %
/kick 1 to 998 Kicks a user from the server, preventing him to join again until the race weekend restarts
/ban 1 to 998 Bans a user from the server, preventing him to join again until the server restarts
/dq 1 to 998 Instantly disqualifies the car, teleporting it to the pits with locked controls
/clear 1 to 998 Removes pending penalties ( e.g. Drivethrough or Stop&Go )
/clear_all clears all penalties from all cars
/cleartp 1 to 998 clears time penalties
/sg10 1 to 998 + 10 seconds stop&go penalty
/sg20 1 to 998 + 20 seconds stop&go penalty
/sg30 1 to 998 + 30 seconds stop&go penalty
/tp5 1 to 998 + 5 seconds penalty time ( reusable )
/tp5c 1 to 998 + 5 seconds penalty time + Indication of the reason: collision ( reusable )
/tp15 1 to 998 + 15 seconds penalty time ( reusable )
/tp15c 1 to 998 + 15 seconds penalty time + Indication of the reason: collision ( reusable )
/dt 1 to 998 Assigns a drivethrough penalty to the given car. As other DTs, it has to be served within 3 laps or the car will become disqualified. In case of a race finish within those 3 laps, the DT will be transformed to a 80s time penalty.
/dtc 1 to 998 see dt + Indication of the reason: collision ( reusable )
/ballast 1 to 998
+ kg
Sets the car’s ballast (in kg) to what you defined. This overrides any other ballast this car has been assigned.
  • Example: /ballast 113 15 = will give car #113 15kg of ballast
  • Range is 0 to 100
/restrictor 1 to 998
+ %
Sets the car’s restrictor (in %) to what you defined. This overrides any other restrictor this car has been assigned.
  • Example: /restrictor 113 7 = will give car #113 7% restrictor, resulting in roughly 7% less hp at max rpm.
  • Range is 0 to 20
/manual entrylist Manually creates an entry list json file containing the drivers connected in this moment. See also settings.json / dumpEntryList
/debug formation Prints information about the current cars and their states. Useful information to report bugs during the formation lap
/debug bandwidth Let’s the server console print the current bandwidth relevant data for both TCP and UDP traffic. Type again to turn it off
/debug qos Let’s the server console print the current network connection quality data. Type again to turn it off.

References

  1. test your configurations with an Online Syntax Check.
  2. Server Admin Handbook (PDF) - find in ACC Install under ..:\Steam\steamapps\common\Assetto Corsa Competizione\server
  3. Server Admin Handbook (Forum) - https://www.assettocorsa.net/forum/index.php?threads/the-server-admin-handbook-thread.59017