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.
Node migration table
| Before (v1.1) | Now (v1.4) | Notes |
|---|---|---|
| Set / Get Global Illumination Method | Set / Get Global Illumination | New enum EEUSGlobalIllumination |
| Set / Get SSGIQuality | Set / Get Screen Space GIQuality | 1–4 |
| Set Allow Megalights / Get Allow Megalighs | Set Mega Lights Enabled / Is Mega Lights Enabled | Saved value now restored correctly |
| Set / Get Reflection Method | Set / Get Reflections | New enum EEUSReflections |
| Set / Get SSRQuality | Set / Get Screen Space Reflection Quality | 0–4 |
| Set / Get Shadow Method | Set / Get Shadow Method | New enum EEUSShadowMethod |
| Set / Get Antialiasing Method | Set / Get Upscaler | Subsystem node |
| Set / Get MSAAQuality | Set / Get MSAASample Count | New enum EEUSMSAASamples |
| Set / Get Ambient Occlusion | Set / Get Ambient Occlusion Quality | Bool → quality 0–3 |
| Set / Get Bloom Quality, Motion Blur Quality, Lens Flare Quality | Same names | 0 turns the effect off |
| Set / Get Use Nanite | Set Nanite Enabled / Is Nanite Enabled | |
| Set / Get Mobile Antialiasing Method | Set / Get Mobile Anti Aliasing | Adds TSR and SMAA |
| Get Max Feature Level | Get Max Supported Feature Level | Redirected |
| Get Materials / Get Niagara Materials | Get All Materials / Get All Niagara Systems | Redirected |
| Is Shader Compiling | Are Shaders Compiling | Redirected; now also reports PSOs in packaged games |
| Set Game User Settings Ini Value | Set User Settings Ini Value | Redirected |
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 returnsfalsewhen 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.