Console Variables
XFSDK Light uses the xl_ prefix. XFSDK Core, standalone XFSDK Enhanced SMAA, and standalone XFSDK Hybrid SDF GI use x_ instead. For shared GI and loading-screen settings, only the prefix changes; SMAA has its own documented Light controls. Bend-style screen-space shadows (xl_sss_*) are Light-only.
Set Light CVars in the console, in Config/DefaultEngine.ini under [SystemSettings], from Blueprint with Set XFSDK Int / Float / Bool, or in the developer menu.
Anti-aliasing
| Name | Default | Description |
|---|---|---|
xl_smaa_mode | 0 | 0 off, 1 SMAA, 2 SMAA 2TX |
xl_smaa_debug | 0 | 1 edges, 2 blend weights |
xl_smaa_disable_diag | 0 | 1 disables diagonal edge detection |
xl_smaa_corner_rounding | 0.25 | 0 sharp corners, 1 no corner detection |
xl_smaa_max_search_steps | 32 | Edge search length (16 / 32 / 64) |
xl_smaa_max_diag_search_steps | 16 | Diagonal search length (8 / 16 / 20) |
xl_smaa_hdr_edge_detection | 1 | Tonemap before edge detection |
xl_smaa_predication | 1 | Depth-guided edge detection |
xl_smaa_predication_threshold | 0.01 | Depth difference that counts as an edge |
xl_smaa_predication_scale | 2.0 | Threshold rise away from depth edges (1–5) |
xl_smaa_predication_strength | 0.4 | Threshold drop at depth edges (0–1) |
xl_smaa_tx2_history_weight | 1 | 0 CryEngine 3 motion fade, 1 50/50 unless object motion differs |
xl_smaa_tx2_velocity_rejection | 1.0 | Object motion difference (pixels) that drops the history |
xl_smaa_tx2_velocity_dilation | 1 | Take motion from the nearest surface in 3×3 |
xl_smaa_tx2_rcas_intensity | 0.0 | RCAS after SMAA 2TX. 0 off, up to 1 standard, up to 2 stronger |
xl_smaa_tx2_debug | 0 | 1 history weight, 2 reprojection, 3 frame difference |
Screen space shadows
| Name | Default | Description |
|---|---|---|
xl_sss_enable | 0 | Turns screen space shadows on |
xl_sss_surface_thickness | 0.05 | Pixel thickness, fraction of depth (≈ fraction of camera distance) |
xl_sss_sample_count | 60 | Shadow length in pixels (16–120) |
xl_sss_shadow_strength | 0.5 | 0 none, 1 black |
xl_sss_shadow_contrast | 4.0 | Edge sharpness (1–8) |
xl_sss_bilinear_threshold | 0.02 | Depth edge threshold for sample blending |
xl_sss_ignore_edge_pixels | 0 | Edge pixels don't cast |
xl_sss_min_depth_delta | 0.05 | Ignore casters closer than this fraction of a thickness window (0–0.5) |
xl_sss_max_distance | 5000 | Fully faded at this distance (cm) |
xl_sss_fade_ratio | 0.6 | Fade starts at this fraction of the max distance |
xl_sss_multi_light | 0 | 0 one light, 1 up to 4 lights |
xl_sss_use_early_out | 1 | Skip sky and out-of-range pixels |
xl_sss_shadow_mode | 0 | 0 darken, 1 remove direct light |
xl_sss_shadow_desaturation | 0.0 | Mode 0: desaturate shadows (0–1) |
xl_sss_material_thickness | 0 | Read per-material thickness (needs the shader patch) |
xl_sss_material_thickness_range | 4.0 | Material thickness range in stops (1–8) |
xl_sss_depth_bias | 0 | Read per-material depth bias (needs the shader patch) |
xl_sss_depth_bias_range | 8.0 | Depth bias at height 0, in cm (0.5–50) |
xl_sss_debug_mode | 0 | 1 edges, 2 shadow mask, 3 material thickness, 4 depth bias |
Global illumination
The canonical Hybrid SDF GI reference lists shared settings using the Core/standalone x_ prefix. On XFSDK Light, change only that prefix to xl_:
| Core / standalone GI | Light equivalent |
|---|---|
x_gi_method=2 | xl_gi_method=2 |
x_gi_dfgi_lite_quality=1 | xl_gi_dfgi_lite_quality=1 |
x_gi_dfgi_lite_final_gather=1 | xl_gi_dfgi_lite_final_gather=1 |
See the Core reference for quality modes, final gather controls, all other settings, and debug views. The shared GI commands x_gi_dfgi_lite_list_volumes and x_gi_dfgi_lite_bake_volumes likewise become xl_gi_dfgi_lite_list_volumes and xl_gi_dfgi_lite_bake_volumes in Light.
System
| Light-only name | Default | Description |
|---|---|---|
xl_developer_menu_visible | 1 | Show the Light developer menu (Development builds) |
Loading-screen controls are documented once in XFSDK Core — Loading Screens. Replace x_ with xl_ when using them in Light. For example, x_common_loading_screen_always_show becomes xl_common_loading_screen_always_show.
PSO prewarming settings and integration are documented in XFSDK Core — PSO Prewarming and Light system setup.
Engine settings XFSDK Light changes
| Name | When | Value |
|---|---|---|
r.TemporalAA.Upscaler | xl_smaa_mode 2 | 1 |
r.TemporalAASamples | xl_smaa_mode 2 | 2 |
r.ScreenPercentage | xl_smaa_mode 2 | 100 |
They are restored when SMAA 2TX is turned off.