Config files

Mowo's INI config files in Unreal's dialect - the layer hierarchy, array operators, console variables, class config sections, and which file holds what.

Last updated Oct 26, 2026Edit this pageVersion 1.0.0

Project and engine configuration is INI, in the dialect Unreal developers know: sections, Key=Value lines, array operators and layered files where a project overrides the engine and a user overrides the project FConfigIniFile. Game data is MDF; the .mproject and .mplugin manifests are JSON; per-user editor state nobody edits by hand is binary MDF (.mdfb).

Syntax

Config/DefaultEngine.ini
[ConsoleVariables]
r.Shadow.Cascades=3
net.peer_byte_budget=8000

[/Script/MyGame.Turret]
Range=40.0

[/Script/MyGame.LootTable]
+Items="Content/Items/Medkit.item"
-Items="Content/Items/Debug.item"
LineEffect
[Section]Starts a section
Key=ValueReplaces every value a lower layer gave Key
+Key=ValueAppends, unless the value is already there
.Key=ValueAppends, even when the value is already there
-Key=ValueRemoves that value
!Key=Clears Key

Values are typed by their spelling: True and False, integers, floats, (X=,Y=,Z=) vectors, and text. A value in quotes is always text, so "1" is the string, not the number. Struct values use Unreal's spelling, (Name="Jump",Type=Button,Keys=("A","B")).

Layers

For a config named Engine, the files combine bottom-up, each layer overriding the ones below it FConfigHierarchy:

  1. Engine/Config/BaseEngine.ini
  2. Engine/Config/<Platform>/<Platform>Engine.ini
  3. Config/DefaultEngine.ini
  4. Config/<Platform>/<Platform>Engine.ini
  5. Saved/Config/<Platform>/Engine.ini
Engine defaults, the project's committed settings, then the user's own. <Platform> is the platform id: win-x64, linux-x64 or osx-arm64.

Because the array operators apply per layer, a project that extends an engine list with + keeps what the engine put in it. The same scheme applies to Game, Scalability and GameplayTags. The project's legacy Config/Engine.ini sits under the hierarchy, so DefaultEngine.ini wins over it.

When a project opens, the editor builds the Engine and Game hierarchies, applies [ConsoleVariables] to cvars, applies the [/Script/...] sections to class defaults, loads the gameplay tag tree, and applies scalability. Command-line --cvar= arguments are applied last and still win.

Console variables

[ConsoleVariables] sets cvars as project settings. A name that is not registered yet (a plugin that loads later) is remembered and applied when it registers, so a plugin that is off does not fail the load. Scalability.ini sections named [<Group>@<Level>] set the cvars a scalability level adds, for example [ShadowQuality@3]. See the console variable reference.

Class config sections

A section named [/Script/<Module>.<Class>] sets the MPROPERTY(Config) fields of that class's default object FConfigClassBinder. The class name drops its M or A prefix the way Unreal drops U and A: a class MTurret in module MyGame reads [/Script/MyGame.Turret]. Supported field types are bool, integers, float, double, std::string and std::vector<std::string> (from a list). A field without the Config flag is never written, whatever the file says. Super-class sections apply first, and Game applies after Engine, so a subclass section and a Game section win.

Which file holds what

All project config lives in Config/, which you commit. Per-user files live in Saved/Config/, which you do not.

FileHolds
DefaultEngine.ini, Engine.iniEngine settings and [ConsoleVariables]
DefaultGame.iniGame class config
DefaultScalability.iniScalability level overrides
DefaultGameplayTags.iniThe project's gameplay tags
Plugins.iniWhich plugins the project enables ([enabled] section)
Input.iniInput actions and bindings
Redirects.iniAsset, property, class, struct and enum redirects
Chunks.iniHow the cooked archive splits into chunks
ImportPresets.iniNamed import presets
TextureImport.iniTexture name-suffix rules
Packaging.iniPackaging options
DefaultCrypto.iniThe project's content encryption and signing keys. Never staged into a package.
Saved/Config/<Platform>/*.iniThe user's own overrides
Saved/Config/Editor/*.mdfbPer-user editor state: import preferences, layouts, output log settings

Older MDF configs convert on first use

Older projects kept configs as MDF documents (Engine.mdf, Plugins.mdf, Input.mdf, Redirects.mdf and others). The engine reaches every config file through one resolver, FProjectLayout::ResolveConfigFile FProjectLayout::ResolveConfigFile. When it finds only the old file, it converts it to INI and moves the original to Saved/MigratedSources/Config/. It also fixes the case of a misspelled file name, which matters on case-sensitive file systems. The converters are scheduled for removal, so open older projects with a current engine before then.

Engine sources

This page describes behavior implemented in these files of the engine repository, checked against commit 7f8f31f8d.

  • Engine/Source/Runtime/Core/Public/Core/ConfigIni.h
  • Engine/Source/Runtime/Core/Public/Core/ProjectLayout.h
  • Engine/Source/Runtime/AssetSystem/Public/AssetSystem/TextureImportSidecar.h
  • Engine/Source/Runtime/AssetSystem/Public/AssetSystem/AssetRegistry.h

Page feedback

Was this page helpful?