Skip to Content
Engine User Settings

Upgrading to v1.4

Migrate Blueprints from Engine User Settings v1.1 to the Engine User Settings Subsystem introduced in v1.4.

In v1.4.0 every node moved to EngineUserSettingsSubsystem. The C++ library EngineUserSettingsBPLibrary and the EngineUserSettings Blueprint function library asset were removed.

Back up your project

Commit or copy your project before updating the plugin.

C++ library nodes are redirected automatically

Nodes from the old C++ library (RHI, feature level, materials, INI…) are migrated by the CoreRedirects in Config/DefaultEngineUserSettings.ini. Open every Blueprint that uses them and save it once.

Replace the Blueprint function library nodes

Nodes from the old EngineUserSettings Blueprint function library asset (render settings) can't be redirected. Blueprints that used them show errors after the update: replace each node using the table below.

The new rendering nodes don't take a Controller pin any more: they set console variables directly, so they also work in menus and Editor Utility Widgets.

Node migration table

Before (v1.1)Now (v1.4)Notes
Set / Get Global Illumination MethodSet / Get Global IlluminationNew enum EEUSGlobalIllumination
Set / Get SSGIQualitySet / Get Screen Space GIQuality1–4
Set Allow Megalights / Get Allow MegalighsSet Mega Lights Enabled / Is Mega Lights EnabledSaved value now restored correctly
Set / Get Reflection MethodSet / Get ReflectionsNew enum EEUSReflections
Set / Get SSRQualitySet / Get Screen Space Reflection Quality0–4
Set / Get Shadow MethodSet / Get Shadow MethodNew enum EEUSShadowMethod
Set / Get Antialiasing MethodSet / Get UpscalerSubsystem node
Set / Get MSAAQualitySet / Get MSAASample CountNew enum EEUSMSAASamples
Set / Get Ambient OcclusionSet / Get Ambient Occlusion QualityBool → quality 0–3
Set / Get Bloom Quality, Motion Blur Quality, Lens Flare QualitySame names0 turns the effect off
Set / Get Use NaniteSet Nanite Enabled / Is Nanite Enabled
Set / Get Mobile Antialiasing MethodSet / Get Mobile Anti AliasingAdds TSR and SMAA
Get Max Feature LevelGet Max Supported Feature LevelRedirected
Get Materials / Get Niagara MaterialsGet All Materials / Get All Niagara SystemsRedirected
Is Shader CompilingAre Shaders CompilingRedirected; now also reports PSOs in packaged games
Set Game User Settings Ini ValueSet User Settings Ini ValueRedirected

Behavior changes

  • Get Current RHI / Get Preferred RHI return Unknown / Default instead of Vulkan when nothing is saved or the RHI isn't recognized.
  • Set Preferred Feature Level returns a bool: it saves SM5 and returns false when the GPU can't run SM6.
  • Every value is clamped to a safe range when it's set and when it's reapplied at startup, including values edited by hand in GameUserSettings.ini.
  • Saved values from v1.1 keep working: the plugin still uses [/Script/Engine.RendererSettings] for console variables.

Example project

The plugin now includes an example map, Content/Example/Maps/Example, with an Options settings menu built entirely with these nodes. Open it to see a complete graphics menu.

Edit on GitHub

On this page