DocsProcedural SkyboxPerformance And Troubleshooting

Performance And Troubleshooting

Keep the sky readable, responsive, and efficient

Performance Controls

SettingHigher Value DoesLower Value Does
Visual Update FrequencyUpdates visuals less often for better performance.Smoother transitions.
Min Time Change ThresholdSkips very small visual changes.Updates more subtle time changes.
Sky Light Recapture IntervalRecaptures skylight less frequently.More responsive ambient lighting changes.
Aggressive OptimizationReduces material parameter updates further.Keeps the most responsive visual updates.
Sky Light Cubemap ResolutionSharper captured lighting, more cost.Lower cost, softer captured lighting.

Common Fixes

IssueWhat To Check
Sky does not move during PlayEnable Time Of Day Cycle and raise Time Speed above 0.
Stars visible during dayLower Star Brightness Min, check SkyOpacity behavior on your custom material, and use the actor-driven parameters listed in this guide.
Clouds too strong at nightLower Cloud Opacity Night, Cloud Opacity Max, or the material's CloudOpacity value.
Clouds look blocky or pixelatedRaise Panning Cloud Quality and lower Panning Cloud Global Tiling on the SkyBox Time of Day Actor.
Moon is not visibleEnable Moon, check Time Of Day, make sure the moon is above the horizon, and verify Moon Scale and Moon Brightness are not too low.
Moon path looks clipped or jitteryRaise Max Visual Elevation in Moon Parameters. Low values can flatten the moon arc near transit.
Moon craters overlap or look stretchedUse the actor's Moon Parameters crater controls. The default shader uses evenly distributed view-disc craters to avoid random cluster overlap; lower crater count or radius if you want a cleaner moon.
Moon glow is not visibleRaise the moon material Brightness and enable post process Bloom. Bloom should glow from the moon surface, not from a separate circular halo mesh.
Scene is too dark at nightRaise Moon Intensity, Sky Light Intensity, Auto Exposure Min Brightness, or Ambient Fill on the moon material.
Sun glow looks too harshLower Lens Flare settings or prefer Bloom for a smoother glow.
Sky light feels delayedLower Sky Light Recapture Interval or call Recapture Sky Light after a large time jump.
Procedural Skybox - Performance And Troubleshooting | Athian Games