描述
Performance Preset Wizard is an editor-only tool for Unreal Engine that helps you define, manage, and apply reusable performance profiles.
Instead of manually changing scalability settings and console variables every time, you store them in UPerformancePresetAsset data assets and apply them with one click. Presets can be shared through source control, duplicated per project, and used as consistent performance profiles for artists, designers, QA, and technical teams.
🔹 Key Features
Centralized performance presets via DataAssets
Each UPerformancePresetAsset can define:
• Target platform / hardware tier
• Scalability levels such as View Distance, Shadows, Textures, Effects, Post Process, Foliage, Shading, GI, Reflections, and Landscape
• Optional CVar overrides for project-specific fine tuning
These assets become your single source of truth for performance settings.
🔹Dedicated Performance Preset Wizard window
Open the wizard from the editor main menu:
Window → Performance → Performance Preset Wizard
The tab provides:
• A sorted list of all preset assets
• Preset details with name, description, scalability summary, and CVar list
• Apply Preset, Restore Previous, and Refresh controls
• A “Use as Editor startup preset” checkboxn
🔹One-click preset application
One-click preset application
When a preset is applied, the plugin:
• Builds Unreal scalability quality levels from the preset
• Applies them through Scalability::SetQualityLevels()
• Applies valid CVar overrides through IConsoleManager
• Reports applied, missing, and invalid CVar entries
🔹Restore Previous
Before applying a preset, the plugin captures the current scalability settings and the CVar values it is about to change. Restore Previous returns to that captured state.
🔹Editor startup preset
Any preset can be marked as the editor startup preset. When enabled, it is applied automatically during normal editor startup and skipped in commandlets.
🔹Enhanced preset Details panel
The plugin adds a custom Details panel for UPerformancePresetAsset:
• Quality dropdowns: Low / Medium / High / Epic / Cinematic
• Bulk CVar text editor
• Export from Array and Apply to Array workflow
• Undo/redo and asset dirtiness handling
🔹Bulk CVar format
Example:
r.ScreenPercentage=90
r.Lumen.Reflections=0,editor
r.MotionBlurQuality=0
Use ,editor or ,e to mark an override as editor-only. Empty lines and comments are ignored.
Typical Use Cases
• Switch between Laptop Dev, Mid Range, High End, VR, Mobile Prototype, Console-like, and Cinematic profiles
• Give designers and technical artists a simple UI for applying known performance states
• Keep QA and review sessions consistent
• Start the editor in a predictable performance configuration
• Store performance profiles as source-control-friendly assets
🔹 Requirements & Compatibility
Engine: Unreal Engine 5.4+ (editor-only)
• Editor-only plugin
• No runtime dependency in packaged builds
• C++ plugin using ToolMenus, PropertyEditor, Slate, AssetRegistry, Scalability, and IConsoleManager
• Tested on Windows editor
• Mac/Linux are listed in the plugin descriptor but not explicitly tested
🔹 Included Content
Performance Preset Wizard editor plugin (C++ source)
UPerformancePresetAsset type for storing presets
EPerformanceTargetPlatform enum for platform/hardware targeting
FPerformanceCVarOverride struct for data-driven CVar overrides
Detail customization for UPerformancePresetAsset:
Quality dropdowns
Bulk CVar text editor
Performance preset wizard tab:
Preset list view
Detail preview
Apply / Refresh / Startup preset controls
Project settings integration via UPerformancePresetWizardSettings
Startup preset application on editor launch
Quick start documentation / README
🔹 Dependencies
The plugin relies on standard editor modules, including:
PropertyEditor (detail customization)
ToolMenus (menu integration)
AssetRegistry / AssetTools (asset discovery and management)
Slate / SlateCore (custom UI)
Standard engine systems (Scalability, IConsoleManager)
No runtime dependencies are introduced into packaged builds.
🔹 Support
Feedback from technical artists, graphics programmers, designers, QA, and performance engineers is welcome.
🔹 Discord Support Channel: