Skip to main content
Version: 2.x

Controlled Settings

The Controlled Setting Keys property declares which settings are controlled by a parent setting. This tells the system about the relationship between parent and child settings, but you must implement the actual update logic in the parent setting's code.

Example: A graphics quality preset setting declares that it controls texture quality, shadow quality, and effects quality. When the preset changes, your custom code updates these child settings to match.

Automatic Handling

When you declare controlled settings, the system automatically handles:

  1. Application order - Ensures parent settings apply before their children
  2. Cascading saves - Saves all controlled settings when the parent is saved
  3. Default value tracking - Updates child settings' baseline defaults when the parent changes

Implementing Control Logic

The Controlled Setting Keys property only declares the relationship. You must implement the actual logic to update child settings in your parent setting's application strategy or custom code.

Example: The example project includes an "overall quality" setting that updates Unreal's scalability settings when changed.

Scalability CVars

Unreal Engine's scalability console variables (like sg.ShadowQuality, sg.TextureQuality, etc.) are detected automatically from the engine's scalability configuration. You don't need to declare these relationships manually.