Skip to main content
Version: 2.x

CommonUI integration

CommonUI is Unreal Engine's official plugin for building cross-platform user interfaces with seamless gamepad and keyboard/mouse support. It provides automatic input detection, platform-specific icons, and navigation systems designed for console and PC games.

Auto Settings provides an optional integration with CommonUI through the AutoSettingsCommonUI module. This integration is disabled by default and only activates when you enable CommonUI in your project.

Optional Feature

The CommonUI integration requires the CommonUI plugin to be enabled in your project. Auto Settings works fully without CommonUI for standard UI implementations.

Overview​

When enabled, the CommonUI integration provides:

  • CommonInput Key Icons - Provides key icons using CommonInput's icon system with automatic gamepad type detection.
  • ButtonGroupSetting Widget - Radio button-style selection using CommonUI buttons.
  • Enhanced ComboBox - Improved gamepad navigation for dropdown selections.

Setup​

  1. Navigate to Edit -> Plugins.
  2. Find and enable the Common UI plugin.
  3. Restart the editor if prompted.

Configuration​

Follow Epic's official guide for CommonUI project setup:

After completing that setup, Auto Settings will automatically detect and enable the CommonUI integration.

CommonInput key icons​

To make Auto Settings use key icons provided by CommonInput:

  1. In Project Settings > Plugins > Auto Settings Input, set Key Icon Source to CommonKeyIconSource.