Assetto Corsa Server extra_cfg.yml Options Explained

extra_cfg.yml is AssettoServer’s extension configuration file. It is generated in the server’s cfg directory on first launch and controls features that the stock server_cfg.ini cannot, including Custom Shaders Patch requirements, track metadata, plugins, integrity checks, and several player permissions. This guide explains where the file belongs, what the major options do, which settings live in other files, and how to migrate it safely between AssettoServer releases.

Playing with friends? Godlike.Host runs hosted Assetto Corsa servers from 10 data-center locations, with free DDoS protection.

What extra_cfg.yml controls

AssettoServer separates the original Assetto Corsa dedicated-server settings from its own extensions. The game’s standard server_cfg.ini still defines ordinary server settings such as session rotation and entry lists. AssettoServer-specific behavior is placed in extra_cfg.yml. The application creates this YAML file if it is missing when the server starts, and most extension features are configured there.

#	Preview	Product	Price
1		Assetto Corsa NEW Ultimate Edition - PC Steam [Online Game Code]	$55.88	Buy on Amazon
2		Assetto Corsa NEW Standard - PC Steam [Online Game Code]	$19.99	Buy on Amazon
3		Assetto Corsa Competizione Standard - PC Steam [Online Game Code]	$39.99	Buy on Amazon
4		Assetto Corsa EVO Early Access Standard - PC Steam [Online Game Code]	$39.99	Buy on Amazon
5		Assetto Corsa Rally - Early Access Standard - PC Steam [Online Game Code]	$29.99	Buy on Amazon

As an Amazon Associate I earn from qualifying purchases.

Do not confuse it with cfg/csp_extra_options.ini. That INI file is read for CSP gameplay sections such as [EXTRA_RULES] and [PITS_SPEED_LIMITER]. Some features also require a permission suffix in entry_list.ini. A setting in the wrong file is normally ignored; changing the YAML will not replace the stock INI or the CSP-specific INI.

Location and a safe editing workflow

Find the active file

For a normal dedicated server, edit cfg/extra_cfg.yml inside the directory used by the running AssettoServer executable. If you launch a server preset through Content Manager, use its Folder control to open that preset’s server directory. This avoids editing a similarly named installation or an old backup.

#1 Best Overall

Assetto Corsa NEW Ultimate Edition - PC Steam [Online Game Code]

• Assetto Corsa features an advanced DirectX 11 graphics engine that recreates an immersive environment, dynamic lighthing and realistic materials and surfaces.
• Extremely detailed with single player and multiplayer options, exclusive licensed cars reproduced with the best accuracy possible, thanks to the official cooperation of Car Manufacturers.
• ASSETTO CORSA has been developed at the KUNOS Simulazioni R&D office, located just inside the international racing circuit of Vallelunga, allowing the team to develop the game with the cooperation of real world racing drivers and racing teams.

$55.88

Buy on Amazon

Apply a change

1. Stop AssettoServer completely. Editing while it is running can leave the process using the old values or overwrite your changes during shutdown.
2. Copy cfg/extra_cfg.yml to a dated backup location.
3. Edit the YAML with a text editor that preserves plain text. Use spaces for indentation; do not replace indentation with tabs.
4. Save the file and check that option names and capitalization match the documented schema.
5. Start AssettoServer and read the startup log. YAML parsing errors, unknown options, and configuration refusals are reported there.
6. Join with a test client before opening the server to everyone. A compatible CSP build, permissions, and track metadata can all affect what players see.

YAML is indentation-sensitive. For example, MissingTrackParams must be nested under IgnoreConfigurationErrors; placing it at the top level changes its meaning and can make it ineffective.

Core option families at a glance

Require a specific Custom Shaders Patch build

MinimumCSPVersion sets the minimum CSP build ID accepted by the server. In the beginner documentation version, 1937 is the default and corresponds to CSP 0.1.77:

MinimumCSPVersion: 1937

To remove the requirement, leave the value empty:

MinimumCSPVersion:

The number is a build ID, not a decimal version string. A player can find the installed build in Content Manager under Settings > Custom Shaders Patch > About & Updates. Require a build when your rules or server content depend on CSP behavior; otherwise, clients without that build may fail to join or may lack the features you expect.

Requiring a CSP build does not itself enable every CSP feature. The corresponding sections still belong in cfg/csp_extra_options.ini, and certain actions need entry-list permissions.

Server details and downloadable content

Enable Content Manager server details

Set EnableServerDetails: true to expose AssettoServer’s server-details information to compatible Content Manager clients. A companion cm_content/content.json file can describe download URLs or local archives for cars and tracks.

Keep the cm_content directory beside the server files. Packed-server distributions do not automatically include it, so verify that the folder is present after extracting or copying a server. If details appear empty, check both the option and the file location before changing unrelated settings.

Track parameters, coordinates and time zones

AssettoServer uses track latitude, longitude and time-zone data for features such as live weather. When a track is absent from data_track_params.ini, the server can report a missing-track-parameters error at startup.

Rank #2

Assetto Corsa NEW Standard - PC Steam [Online Game Code]

• Assetto Corsa features an advanced DirectX 11 graphics engine that recreates an immersive environment, dynamic lighthing and realistic materials and surfaces.
• Extremely detailed with single player and multiplayer options, exclusive licensed cars reproduced with the best accuracy possible, thanks to the official cooperation of Car Manufacturers.
• ASSETTO CORSA has been developed at the KUNOS Simulazioni R&D office, located just inside the international racing circuit of Vallelunga, allowing the team to develop the game with the cooperation of real world racing drivers and racing teams.

$19.99

Buy on Amazon

Preferred fix: add accurate metadata

Add a section for the track with the required fields:

[your_track_id]
NAME=Your Track Name
LATITUDE=0.0000
LONGITUDE=0.0000
TIMEZONE=Europe/London

Use the track’s actual coordinates and IANA time-zone identifier rather than copying a nearby circuit. Correct metadata allows WeatherFX time and other world-state calculations to remain synchronized for connected clients.

Fallback: suppress the refusal

If you cannot provide metadata immediately, suppress only that configuration error:

IgnoreConfigurationErrors:
  MissingTrackParams: true

This allows startup, but it does not create coordinates. WeatherFX time can remain unsynchronized when the parameters are missing, so suppression is an operational workaround, not a repair.

Force server-supplied parameters

When every client must use the server’s track metadata, the FAQ configuration uses ForceServerTrackParams: true together with an appropriate MinimumCSPVersion. Choose a CSP build that supports the behavior and test with a client at that build before enforcing it on public sessions.

Configuration-error overrides and their risks

The documented override block can contain these switches:

IgnoreConfigurationErrors:
  MissingCarChecksums: true
  MissingTrackParams: true
  WrongServerDetails: true
  UnsafeAdminWhitelist: true

Each switch suppresses a startup refusal; none repairs the underlying condition. Treat the block as an explicit exception list, not a standard template.

Rank #3

Assetto Corsa Competizione Standard - PC Steam [Online Game Code]

• Assetto Corsa Competizione is designed to faithfully recreate the performance and the driving experience of real Blancpain GT Series cars through a sophisticated mathematical model that accurately replicates tyre grip, aerodynamic impact, engine parameters, suspensions and electronics systems that determine vehicle balance, as well as the influence of mechanical damage on the car's drivability.
• Unreal Engine 4 guarantees photorealistic rendering and an accurate representation of scenarios, car materials and weather conditions. Thanks to the multi-channel audio sampling of real GT cars, the game conveys captivating and immersive acoustic surroundings and realistic environmental effects.
• Even the secondary details are faithfully reproduced to make you feel the thrill of being in the cockpit of a real racing car. Doors, windshield wipers, headlights, racing lights, racing equipment and control devices such as ABS, traction control, engine ignition and ECU mapping, are all under the driver’s management to assure the best performance and offer the player total control of the car.
• Thanks to Laserscan technology, every official circuit is recreated with the utmost accuracy: all curbs and details perfectly fit their real counterparts to grant a gaming experience as faithful to reality as possible.
• A well-structured ranking system will evaluate individual performance and driving behaviour to reward the most virtuous drivers and promote fair play in online competitions. The matchmaking function makes sure that you can compete with opponents of similar skill level and easily find online races to join, while the leaderboards will allow you to compare single-lap performance with virtual pilots from around the world with the same car, circuit and weather conditions.

$39.99

Buy on Amazon

• MissingCarChecksums: present checksums remain loaded, but allowing missing ones can let modified car data onto the server. That weakens integrity and anti-cheat confidence.
• MissingTrackParams: permits a track without coordinate and time-zone metadata, with the WeatherFX synchronization risk described above.
• WrongServerDetails: lets the server continue when its advertised details do not match expected data. Correct the details when possible instead of hiding the warning.
• UnsafeAdminWhitelist: bypasses a safety refusal involving an admin whitelist when Steam authentication is disabled. The documentation describes this as unsafe because SteamIDs can be spoofed in that arrangement.

If a server is public, preserve Steam authentication and checksum enforcement unless you have a documented, tested reason to make an exception. Record every enabled override so another administrator knows which protections were intentionally relaxed.

Load AssettoServer plugins

Plugins are enabled with an EnablePlugins list. The beginner example loads AutoModerationPlugin:

EnablePlugins:
  - AutoModerationPlugin

Start the server once after adding a plugin. Many plugins generate their own configuration file during that first launch. Stop the server, edit the generated plugin configuration, then restart and inspect the log for load failures or version mismatches.

Do not place a server script in this list. AssettoServer plugins run through the plugin system; CSP server scripts are configured separately in csp_extra_options.ini and can be loaded from a remote URL or from files served by the server’s wwwroot.

Put CSP gameplay settings in the right file

Create or edit cfg/csp_extra_options.ini for CSP sections. Examples documented for AssettoServer include allowing wrong-way driving and changing pit-lane speed-limiter behavior. These are INI sections, not YAML keys:

[EXTRA_RULES]
; CSP rule keys go here

[PITS_SPEED_LIMITER]
; pit-lane behavior keys go here

The exact keys depend on the CSP feature you are using. A valid YAML file cannot substitute for this INI, and adding an INI section to extra_cfg.yml will cause it to be ignored or produce a parse error.

Allow teleportation and color changing

Teleportation and player color changing have two control layers: CSP options must be available, and the relevant car entry must grant permission in entry_list.ini. Add one of these suffixes to the skin value:

Rank #4

Assetto Corsa EVO Early Access Standard - PC Steam [Online Game Code]

• As with its predecessor, Assetto Corsa EVO will include cars from different classes spanning across years of motoring history. From road cars, classics, hypercars, and race cars. The most iconic representation of the automotive and motorsport world. Each vehicle is reproduced through Kunos in-house physics and graphic engine simulating mechanical, electronic, and aerodynamic performance, combined with the fidelity of the circuits created using Laserscan technology
• In Early Access 1 you will be able to experience a range of vehicles, tracks and game modes that will evolve on the road to our full 1.0 launch.

$39.99

Buy on Amazon

For example:

[CAR_0]
MODEL=ruf_yellowbird
SKIN=00_yellowbird_black/ADAn

If the INI options exist but no minimum CSP build is required, some features may not appear in the in-game chat menu. A compatible client can still invoke a feature directly, so test both the menu and the underlying action. If nothing works, verify the suffix on the specific car entry, not just the global YAML settings.

Replay clips and server scripts

The extra-options documentation describes replay clips that retain the last configurable number of seconds and can optionally upload clips to an endpoint. This can help review incidents, but the endpoint, access controls and retention period are choices for the server operator. Decide who can retrieve clips and how long they remain available before enabling automatic uploads.

Server scripts are configured in csp_extra_options.ini, either with a remote URL or with files exposed through wwwroot. They are not the same as AssettoServer plugins: scripts execute through CSP’s mechanism, while plugins are loaded by AssettoServer and have separate configuration files.

Why extra_cfg.yml appears to be ignored

You edited the wrong installation

Multiple presets and test servers often have their own cfg folders. Confirm the executable’s working directory and use the active preset’s Folder control. A correctly formatted file in an inactive directory has no effect.

The setting belongs elsewhere

Move stock server settings to server_cfg.ini, CSP sections to csp_extra_options.ini, and teleport or color permissions to entry_list.ini. Check the startup log after each move.

YAML syntax or indentation is invalid

Use spaces, preserve nesting, and compare the spelling and capitalization with the current generated file. Start the server from a terminal or inspect its log so a parser error is visible instead of assuming the option was silently ignored.

The client does not meet the requirement

Check the player’s CSP build against MinimumCSPVersion. A server can start normally while a client is rejected for using an older build.

Best Value

Assetto Corsa Rally - Early Access Standard - PC Steam [Online Game Code]

• The Monte Carlo Rally is famous for unpredictable weather, featuring snow, ice, and dry asphalt. It tests drivers' skills and adaptability, making it one of the most challenging rallies in the world.
• This iconic location is being delivered as two fully laser-scanned stages, Col de Turini and Sisteron including fully dynamic weather conditions.

$29.99

Buy on Amazon

A feature needs a second permission

Teleportation and color changing require the matching entry-list suffix. CSP gameplay rules require the INI file, even when extra_cfg.yml is valid.

Track metadata was suppressed rather than fixed

If WeatherFX time is wrong after setting MissingTrackParams: true, restore the warning and add accurate track parameters. Suppression only removes the startup refusal.

Update AssettoServer without breaking the configuration

Do not blindly copy an old extra_cfg.yml over a new release. The documented parameters and plugin keys can change between versions, and an obsolete option name can prevent the new server from working.

1. Stop and back up the complete old server directory, including cfg, plugin files and wwwroot.
2. Extract the new AssettoServer release into a fresh directory rather than overwriting the old installation.
3. Run the new executable once. This generates the release’s current cfg/extra_cfg.yml and any initial plugin configuration files.
4. Compare the new file with your backup line by line. Reapply only settings you still need, using the new option names and nesting.
5. Copy compatible content, entry lists, CSP INI files and web assets after checking their paths.
6. Start the new server with a test preset, read every warning, and verify joining, permissions, weather time and plugins before switching production traffic.

This migration method preserves new defaults and makes schema changes visible. Keep the old directory untouched until the replacement has passed your checks.

Administrator decision checklist

• Client compatibility: decide whether to require a minimum CSP build and test a client at that build.
• Integrity: keep Steam authentication and car checksums enabled unless an exception is documented and accepted.
• World state: provide correct track coordinates and time zones; force server parameters only when clients support the required CSP behavior.
• Player features: configure CSP rules in the INI and grant teleport or color permissions per entry-list car.
• Operations: confirm plugin files, download metadata, replay retention and script hosting paths.
• Maintenance: generate a fresh file for every upgrade and migrate settings instead of replacing the new schema wholesale.

The practical rule is simple: use extra_cfg.yml for AssettoServer extensions, use the CSP INI for CSP sections, and use entry_list.ini for per-car permissions. When a setting seems ineffective, verify the active directory, file type, indentation, client build and startup log in that order.

Frequently Asked Questions

Do I need a separate purchase to run an AssettoServer?

You need Assetto Corsa for PC and any DLC required by the cars or tracks on your server. AssettoServer itself does not replace the game or content licenses.

Can I delete extra_cfg.yml to reset settings?

Stop the server, move the file to a backup name, and launch once. AssettoServer will generate a current file, after which you can migrate needed settings deliberately rather than restoring an obsolete copy.

Quick Recap

Bestseller No. 1

Assetto Corsa NEW Ultimate Edition - PC Steam [Online Game Code]

$55.88

Bestseller No. 2

Assetto Corsa NEW Standard - PC Steam [Online Game Code]

$19.99

Bestseller No. 3

Assetto Corsa Competizione Standard - PC Steam [Online Game Code]

$39.99

Bestseller No. 4

Assetto Corsa EVO Early Access Standard - PC Steam [Online Game Code]

$39.99

Bestseller No. 5

Assetto Corsa Rally - Early Access Standard - PC Steam [Online Game Code]

$29.99

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.