Settings (Editor)
DefaultQuickGameModeOverride.ini — section, keys, example files, and source-control patterns.
The plugin's settings are not surfaced in Project Settings. They are edited through the toolbar widget and persisted to a config file. This page documents that file so you can read or edit it directly when needed (e.g. from a build script, or to commit a default to source control).
File location
<Project>/Config/DefaultQuickGameModeOverride.iniThis is a project-default config file. Values committed here apply to
every developer on the project. The plugin writes through to this
file — not to a per-user Saved/Config/ override — every time the
toolbar widget changes a value.
Section
[/Script/QuickGameModeOverride.QuickGameModeOverrideSettings]That's the script path of the UQuickGameModeOverrideSettings class.
Keys
bOverrideGameMode
| Type | Default | Notes |
|---|---|---|
bool | False | When True, the override applies (provided OverrideGameModeClass is also set). |
OverrideGameModeClass
| Type | Default | Notes |
|---|---|---|
TSubclassOf<AGameModeBase> | unset | The class to swap in. When unset, the override is inactive even if the bool is True. |
The value is a TOptional<TSubclassOf<AGameModeBase>> in code.
"Unset" means the key is absent from the file — no
OverrideGameModeClass=None line will be written by the toolbar.
Example file
A typical override committed to a project:
[/Script/QuickGameModeOverride.QuickGameModeOverrideSettings]
bOverrideGameMode=True
OverrideGameModeClass=/Game/Modes/BP_DebugGameMode.BP_DebugGameMode_CFor a class shipped from C++:
[/Script/QuickGameModeOverride.QuickGameModeOverrideSettings]
bOverrideGameMode=True
OverrideGameModeClass=/Script/MyGame.MyDebugGameModeEditing without the toolbar
You can edit DefaultQuickGameModeOverride.ini by hand (or via a
script). The plugin reads from GetDefault<UQuickGameModeOverrideSettings>()
on subsystem initialization, so changes take effect at the next PIE
session — no editor restart required.
The toolbar reads through the same CDO, so the checkbox and class picker reflect the current file state when the widget rebuilds.
Source control
DefaultQuickGameModeOverride.ini is a project-default file. Two
common patterns:
- Don't commit it. Add it to
.gitignore. The override stays a per-developer convenience. - Commit a baseline. Useful when the team has a known "debug game mode" everyone wants on by default during development. Safe to commit — the override is editor-only, so packaged / standalone builds will ignore the file entirely.