Skip to main content
Version: 2.x

Setting Widgets

AutoSettings provides abstract widget base classes that automatically bind to Setting Types. Ready-to-use implementations are included in Plugins/AutoSettings/Content/UI/Settings/.

Available Widgets

WidgetClassUse CaseValue TypeExamples
CheckBoxCheckBoxSettingWidgetOn/Off settingsBooleanVSync, Subtitles
SliderSliderSettingWidgetNumeric rangesFloat/IntegerVolume, FOV, Sensitivity
ComboBoxComboBoxSettingWidgetMany optionsString/IntegerResolution, Language
SpinnerSpinnerSettingWidgetFew incremental optionsString/IntegerQuality levels
ButtonGroup*ButtonGroupSettingWidgetFew optionsString/IntegerQuality levels, Anti-aliasing method
Input MappingInputMappingSettingWidgetKey bindingsKeyEnhanced Input remapping
*CommonUI Required

ButtonGroup requires the CommonUI plugin. See CommonUI Integration for setup.

Getting Started

Ready-made widgets are available in two locations:

  • Plugin widgets (Plugins/AutoSettings/Content/UI/Settings/) - Minimal blank slate implementations
  • Example project widgets - Styled to fit into a settings menu

Start with the example project widgets for a complete menu implementation, or use the plugin widgets as a minimal starting point for full customization.

Custom Widget Types

To create completely new control types beyond the built-in widgets:

  1. Create a new Widget Blueprint
  2. Add SettingWidget (or a specific type like SelectSettingWidget) as a parent class
  3. Build your custom UI in the Designer
  4. Implement the required widget logic