Quality tiers

The five scalability tiers, what each one turns on, how the auto-tier picks one, and the cvars, sg groups and Scalability.ini that override it.

Last updated Nov 1, 2026Edit this pageVersion 1.0.0

A quality tier is one setting that decides which rendering features run and how much each one may spend. Mowo has five tiers: Low, Medium, High, Epic and Cinematic (). High is the code default.

A tier only scales what the project enabled. Global Illumination, ray tracing, MegaLights, the volumetric cloud volume, volumetric fog and frame generation are project switches in Project Settings > Rendering > Features, all off for a new project (Project Settings). A tier, a device profile, an sg.* group or an r.* cvar never turns one of them on while its switch is off, and the renderer does not build its targets or pipelines.

The rule is the tier sets, the cvar refines. A tier writes a whole row of values into SceneRenderer::Options; any r.* cvar that is not -1 then overrides its one value. A tier change applies at the next BeginScene, and resources that change size, such as the shadow atlas or the probe grid, are recreated then. No restart is needed.

Pick a tier

  1. In the editor

    Open Edit > Engine Quality and choose Low, Medium, High, Epic or Cinematic. Auto (GPU-detected) removes your choice and runs the detection again. The choice is saved to your user config and reapplied at every launch. On a GPU with less than 10 GB of memory the card shows a warning line under Epic and Cinematic with the frame rate they cost the 8 GB reference card against High; both stay selectable.

  2. From the viewport

    Click Quality on the viewport toolbar. The card shows the active preset, a Low to Cinematic selector, one override row per category (View distance, Shadows, Global illum., Reflections, Textures, Effects, Foliage, Post process) that offers the same Low to Cinematic tiers, the upscaler, and Auto, Benchmark and Reset buttons.

  3. In Project Settings

    Open Project Settings > Engine > Scalability. It lists the preset and each category with its tier value and lets you pin individual ones.

  4. In a shipped game

    The player settings screen has a Quality Preset row in the Graphics category that writes r.Quality, one row per category that pins it to any tier or leaves it on the preset, and rows for the most important single knobs (). A row the player sets stays where they put it when the preset changes.

  5. From code or the console

    Set r.Quality: 0 is Low, 4 is Cinematic, -1 means not set.

Mowo Editor viewport with the Quality card open from the viewport toolbar, showing the preset selector with High active, the Overrides section with the View distance, Shadows, Global illum., Reflections, Textures, Effects, Foliage and Post process rows, the Resolution section with the Upscaler dropdown, and the Auto, Benchmark and Reset buttons in the footer
The viewport Quality card.
SetQuality.cpp
#include "Core/IConsoleManager.h"

Mowo::IConsoleManager::Get().SetByName("r.Quality", "3");

To inspect what a tier would set without a GPU, call the static ApplyQualityPreset:

InspectTier.cpp
#include "Renderer/SceneRenderer.h"

Mowo::SceneRenderer::Options opts;
Mowo::SceneRenderer::ApplyQualityPreset(opts, Mowo::EQualityPreset::Epic);

const bool vsm = opts.EnableVSM;
const bool rtReflections = opts.RTReflections;
const uint32_t cascades = opts.ShadowCascadeCount;

(void)vsm;
(void)rtReflections;
(void)cascades;

Where the tier comes from

The active tier is resolved in this order, highest first:

  1. An explicit r.Quality: the user config, Scalability.ini, the editor menu, the in-game settings or --cvar=r.Quality=N in a development build.
  2. A tier the platform recommends for the device. On Steam this is the recommended profile the developer set for that hardware.
  3. The auto-tier, which fills only an unset slot, capped by the matched device profile.
  4. The code default, High.

The editor and the game run the same auto-tier, so the editor viewport, Play In Editor and the shipped game pick the same tier on the same machine. Each logs a [Quality] line with the tier and why it was chosen.

The auto-tier

decides from a measurement when it has one and from the GPU's name and memory when it does not.

Measured

On the first launch on a machine the engine runs a short synthetic GPU and CPU benchmark once and stores the result; later launches read it. The Benchmark button in the viewport Quality card runs it again. The GPU index maps to a tier, with 100 as a reference mid-range card:

GPU indexTier
Under 25Low
25 to 55Medium
55 to 150High
150 to 240Epic
240 and upCinematic

VRAM still caps a measured tier: under 4 GB caps it at Medium, under 6 GB at High. The matched device profile's TierCap caps it as well, so a benchmark never picks a tier the profile rules out for that GPU family. r.AutoQuality.Benchmark 0 ignores the measurement.

From the device

Without a measurement:

DeviceTier
Apple silicon Max or UltraEpic
Other Apple siliconHigh
Integrated GPULow
Under 4 GB VRAMLow
Under 6 GB VRAMMedium
Older discrete GPUs matched by nameMedium
20 GB or more, and a known high-end GPU or mesh shaders plus ray queryCinematic
12 GB or more, and a known high-end GPU or mesh shaders plus ray queryEpic
Anything elseHigh

Caps

  • A device without mesh shaders is capped at High; one without ray query is capped at Epic.
  • A slow CPU caps the tier: by its measured index when there is one, otherwise 4 or fewer logical cores cap at Medium and 8 or fewer at High.
  • Under 8 GB of system RAM drops to Low; under 16 GB caps at High.

An unknown core count or RAM size never lowers the tier.

Tip

Simulate another machine with r.AutoQuality.ForceVRAMMB, r.AutoQuality.ForceIntegrated, r.AutoQuality.ForceName, r.AutoQuality.ForceCores and r.AutoQuality.ForceRamMB. Forcing a device skips the stored measurement.

Device profiles

A device profile, matched from DeviceProfiles.ini by GPU vendor, name, device-id range, VRAM, driver, graphics API and platform, caps the auto-detected tier and sets cvars at device-profile priority: above the tier, below every INI, the player's settings and the command line. The engine ships profiles for the RTX 20 to 50 series, GTX 16, Radeon RX 6000 to 9000, Arc A and B, Intel and AMD integrated graphics, Apple M-series and the Steam Deck; the Deck's applies at Low and moves sg.GlobalIlluminationQuality to Medium so the Deck keeps Global Illumination, renders through FSR at Quality, caps the frame rate at 40 with t.MaxFPS and sets the dynamic-resolution target to 22 ms. See Device profiles for the rules, the driver blocklist and how to add your own.

Upscaler choice

The auto-tier also picks the anti-aliasing method. It chooses the engine's TSR, or TAA when the tier renders at a fixed native resolution (Cinematic). Low, Medium and High pick their quality mode from the output resolution (Auto upscaling), in the editor viewport as in the game. Vendor upscalers (DLSS, FSR, XeSS, MetalFX) are picked automatically only when r.AutoQuality.VendorUpscalers is 1. See Upscaling and anti-aliasing.

What each tier turns on

Values come from the tier rows in. The Project switch column names the switch a row also needs; with it off the row is off at every tier (FScalabilityTiers::GetComposed clears it, and FScalabilityTiers::Get keeps the raw table).

FeaturecvarProject switchLowMediumHighEpicCinematic
Clustered lighting——ononononon
Auto-exposure——ononononon
Bloom, motion blur, contact shadows——offonononon
Global Illuminationr.DDGIGlobal Illuminationoffonononon
Screen-space reflectionsr.SSR—offonononon
GTAOr.GTAO—offonononon
Screen-space subsurface scattering——offonononon
SDF far sun shadowsr.Shadow.SdfFarGlobal Illuminationoffonononon
Screen-probe final gather—Global Illuminationoffoffononon
Depth prepassr.DepthPrepass—offoffononon
PCSS soft shadowsr.Shadow.Soft—offoffononon
Translucent reflectionsr.Reflections.TranslucentGlobal Illuminationoffoffononon
Terrain runtime virtual texturer.Terrain.RVT—offoffononon
Cloud shadowsr.Clouds.ShadowsVolumetric Cloudsoffoffononon
Virtual shadow mapsr.VSM—offoffoffonon
MegaLightsr.MegaLightsMegaLightsoffoffoffonon
Ray-traced reflectionsr.RTReflectionsRay Tracingoffoffoffonon
Ray-traced AOr.RTAORay Tracingoffoffoffonon
Hardware ray-traced GI gatherr.GI.HWRTGatherGlobal Illumination + Ray Tracingoffoffoffonon
SDF reflections and the near radiance cascader.GI.NearCascadeGlobal Illuminationoffoffoffonon
Volumetric fogr.VolumetricFogVolumetric Fogoffoffoffonon
Meshlet G-Bufferr.MeshletGBuffer—offoffoffonon
Ray-traced sun shadowsr.RTShadowsRay Tracingoffoffoffoffon

Most of these cvars take -1 for the tier value and 0 or 1 to force the feature. r.GI.NearCascade and r.Reflections.Translucent are gates instead: they default to 1 and let the tier's choice through; set 0 to turn the feature off.

Ray-traced rows need ray query on the device, and the meshlet path needs mesh shaders. Without them the feature falls back each frame, see Ray tracing. SSGI is off at every tier; r.SSGI 1 forces it when Global Illumination is on. The raymarched cloud volume (Epic and Cinematic pick it once clouds are on) also needs Volumetric Clouds; without it a cloud actor draws the flat cloud layer at every tier.

Numeric budgets per tier

Every row has an r.* cvar that defaults to -1 (the tier value).

KnobcvarLowMediumHighEpicCinematic
Sun shadow map sizer.Shadow.Resolution10242048204840964096
Sun shadow cascadesr.Shadow.Cascades23444
PCSS penumbra ceiling (texels)r.Shadow.MaxPenumbraTexels816204864
Local shadow view budgetr.Shadow.MaxLocalViews163248128128
Largest local shadow tiler.Shadow.LocalTileSize5121024102410242048
Contact shadow stepsr.ContactShadowSteps68121620
Probe rays per prober.DDGI.RaysPerProbe1624324864
Probes per axisr.DDGI.ProbesPerAxis812161616
Radiance cache interval (frames)r.GI.RadianceInterval88821
Screen-probe raysr.GI.ScreenProbes.Rays3232486496
SSR max stepsr.SSR.MaxSteps326496128160
SSR trace resolution divisorr.SSR.TraceDivisor22221
GTAO slicesr.GTAO.Slices23444
AO resolution divisorr.AO.Divisor22211
Bloom mipsr.Bloom.Mips45566
Depth of field kernelr.DoF.Bokehgaussiangaussiangaussiandiskdisk
Render scaler.RenderScale0.751.01.01.01.0
Upscaler qualityr.UpscalerQualityAuto, 2 steps lowerAuto, 1 step lowerAutoQualityNative
Mesh LOD biasr.MeshLODBias+2+1000
Small-object cull (fraction of vertical FOV)r.MinScreenCoverage0.00250.00150.0010.0006off
Hi-Z occlusion cullr.OcclusionCullononononoff
Max anisotropyr.MaxAnisotropy48161616
View distance scaler.ViewDistanceScale0.60.81.01.01.5
Foliage densityr.Foliage.DensityScale0.40.71.01.01.0
Ray-traced sun shadow samplesr.RTShadows.Samples22234
MegaLights samples per pixelr.MegaLights.Samples———23
Particle spawn rate scaler.Effects.SpawnRateScale0.350.61.01.01.0
Emitters per viewr.Effects.MaxActiveEmitters163264unlimitedunlimited
Note

The upscaler-quality row only matters when a scaling method (TSR, FSR, DLSS, XeSS, MetalFX or Spatial) is active. Auto picks the mode from the output resolution (Quality at 1080p, Balanced at 1440p, Performance at 4K) and shifts it toward Performance on the lower tiers, so at 1080p Low renders at Performance and Medium at Balanced, the modes these tiers fixed before; with r.Upscaler.AutoQuality 0 they use those fixed modes at every resolution. TAA and None render at full resolution. An explicit r.RenderScale wins over the quality mode.

Scalability groups

One dial is sometimes too blunt: a machine can be short of fill rate and long on memory. The sg.* cvars pick which tier row a group of settings comes from, while everything else follows r.Quality ().

cvarControls
sg.ViewDistanceQualityLOD thresholds and bias, small-object and occlusion culling, view distance, meshlet G-Buffer, depth prepass
sg.ShadowQualityClustered lighting, sun and local shadows, contact shadows, PCSS, VSM, MegaLights, SDF far and ray-traced sun shadows
sg.GlobalIlluminationQualityGlobal Illumination on or off and its budgets, GTAO and ray-traced AO
sg.ReflectionQualitySSR, SDF, ray-traced and translucent reflections
sg.PostProcessQualityBloom, motion blur, depth of field kernel, auto-exposure, subsurface scattering
sg.AntiAliasingQualityRender scale and upscaler quality
sg.TextureQualityAnisotropy, terrain virtual texture
sg.EffectsQualityParticle budgets, volumetric fog, clouds
sg.FoliageQualityFoliage density

Each group defaults to -1 (follow r.Quality). Set one to 0 through 4 to pin it. For example, sg.GlobalIlluminationQuality=0 keeps everything else at the base tier and turns Global Illumination off, because its on/off switch is part of the row.

Category selectors

Every place that lets you set a category offers the same tiers as the overall preset, Cinematic included, and a pick pins the whole group: every knob in the group's row moves to that tier, not a single value.

WhereWhat a category pick writes
Viewport Quality card, one row per categorythe group's sg.* cvar and a cvars.sg.* key in your user config, so it survives a restart and shows again when the card reopens
Project Settings > Engine > Scalability, Global Illumination, Reflections and Effects rowsthe same sg.* pin in the project config; the other rows pin their own cvar to the value in the clicked column
Settings > Graphics in a shipped gameone row per group (Shadow Quality, Global Illumination Quality and so on) with Follow the preset and the five tiers

A category set to a tier other than the preset puts the card and the Scalability page in a Custom state, and picking the preset's own tier on that row, or Reset, hands the category back to the preset. Pinning or releasing a group applies on the next frame without a restart.

Everything a tier carries

The two tables above list the switches and the headline budgets. These are the remaining values the tier rows set, so the whole ladder is in one place. A value that rises with quality never drops on a higher tier, and the checks that hold the table to that are the quality-tier-audit test row.

KnobLowMediumHighEpicCinematic
Global SDF resolution64646464128
GI probe trace steps96128192192256
GI screen trace steps3248646496
SDF reflection trace steps96128160160224
Surface-cache atlas edge10241024102420482048
Surface-cache card edge6464128256256
Ray-traced AO rays22223
LOD 1 / LOD 2 coverage0.12 / 0.0450.10 / 0.0350.08 / 0.0250.06 / 0.020.04 / 0.015
PCSS blocker / filter samples8 / 812 / 1212 / 1616 / 2424 / 32
Smallest local shadow tile128256256256256
Cheap shadow march for atlas losersonononoff, MegaLights covers themoff, MegaLights covers them
SDF far shadow steps2424244864
Foliage shadow cascades02334
Volumetric fog grid120 x 68 x 48160 x 90 x 64160 x 90 x 64160 x 90 x 64240 x 135 x 128
Cloud march / light steps32 / 448 / 564 / 680 / 6128 / 8
Cloud implementation2.5D2.5D2.5Draymarchedraymarched
Particle overdraw budget (screens)61224unlimitedunlimited
Hi-Z occlusion cullononononoff, so a capture never loses a caster

Low gives up Global Illumination, screen-space reflections, ambient occlusion, bloom and motion blur and renders at 0.75 of the output resolution with Performance upscaling, which is the budget of an RTX 3050 class card at 1440p. The Steam Deck device profile borrows the Medium Global Illumination row on top of Low. Ray-traced passes, the hardware GI gather, virtual shadow maps, MegaLights, volumetric fog and the meshlet path start at Epic, and ray-traced sun shadows only on Cinematic.

Scalability.ini

A project can tune tiers and groups in config. The engine reads Scalability.ini through the usual layers: Engine/Config/BaseScalability.ini, the project's Config/DefaultScalability.ini, a platform folder, then Saved/Config/Scalability.ini ().

Config/DefaultScalability.ini
[ConsoleVariables]
r.Quality=2

[ScalabilityGroups]
sg.ShadowQuality=3

[ShadowQuality@3]
r.Shadow.MaxDistance=250
  • [ConsoleVariables] sets cvars.
  • [ScalabilityGroups] pins sg.* groups.
  • A [<Group>@<Level>] section sets extra cvars while that group is pinned to that level. The group name drops the sg. prefix.

Values from this file sit below every other INI and below the player's own settings.

Dynamic resolution

r.DynamicRes 1 steers the render scale toward a GPU frame-time target between r.DynamicRes.MinScale and r.DynamicRes.MaxScale. The default, -1, turns it on in the shipped game and off in the editor viewport.

cvarDefaultMeaning
r.DynamicRes-1-1 auto, 0 off, 1 on
r.DynamicRes.TargetMs16.6GPU frame-time target in milliseconds
r.DynamicRes.MinScale0.6Lowest render scale
r.DynamicRes.MaxScale1.0Highest render scale

A scale step reallocates nothing: passes render into a sub-rectangle of full-size targets, so temporal histories survive it.

Troubleshooting

  • A tier change does not show. Setting r.Quality back to -1 at runtime leaves the current options in place. Set 0 to 4, or pick Auto in the editor menu to run detection again.
  • An RT feature is on but nothing changes. The device or backend has no ray query, so the raster fallback runs. D3D11 never has it.
  • Every knob jumps when you pick a preset in the game's settings. Only rows still at their tier value follow the preset; a row the player changed keeps its value.

API reference

Engine sources

This page describes behavior implemented in these files of the engine repository, checked against commit 4312aef10.

  • Engine/Source/Runtime/SceneRenderer/Public/Renderer/SceneRenderer.h
  • Engine/Source/Runtime/SceneRenderer/Public/Renderer/ScalabilityTiers.h
  • Engine/Source/Runtime/RHI/Public/RHI/ProjectRenderFeatures.h
  • Engine/Source/Runtime/SceneRenderer/Public/Renderer/QualityAutoTier.h
  • Engine/Source/Runtime/SceneRenderer/Public/Renderer/DeviceProfiles.h
  • Engine/Config/BaseDeviceProfiles.ini

Page feedback

Was this page helpful?