Source: Roblox Creator Hub · CC BY 4.0 · View source · Code samples: MIT Imported 2026-10-03. Formatting adapted for this site.
Atmospheric effects
Atmospheric effects simulate realistic environments by scattering sunlight in unique ways based on properties that control air particles. Using the Atmosphere object, you can:
- Control particle density.
- Create a silhouette or blend distant objects with an offset.
- Simulate a haze or glare.
- Set an atmosphere's color or decay.
Atmosphere properties
Every property of the Atmosphere object inside the Lighting service works together to support the overall vision, themes, and mood of your game.
Density
The Density property controls how many particles exist in the air of your game; the higher the density, the more particles, which obstruct a player's view of objects and terrain.
0
<img src="https://prod.docsiteassets.roblox.com/assets/lighting-and-effects/atmosphere/Density-A.jpg" width="800" height="400" alt="Atmosphere with Density value of 0" />0.35
<img src="https://prod.docsiteassets.roblox.com/assets/lighting-and-effects/atmosphere/Density-B.jpg" width="800" height="400" alt="Atmosphere with Density value of 0.35" />Note
Density only directly affects objects and terrain; however, since you view a skybox through those objects and terrain, the visibility of a skybox is also affected.
Offset
The Offset property controls how light transmits between the camera and the sky background. When you increase this value, it creates a horizon silhouette; when you decrease this value, it blends distant objects into the sky for a seemingly endless and seamless open world.
0
<img src="https://prod.docsiteassets.roblox.com/assets/lighting-and-effects/atmosphere/Offset-A.jpg" width="800" height="400" alt="Atmosphere with Offset value of 0" />1
<img src="https://prod.docsiteassets.roblox.com/assets/lighting-and-effects/atmosphere/Offset-B.jpg" width="800" height="400" alt="Atmosphere with Offset value of 1" />Note
Carefully balance the Offset property with the Density property. A low offset value may cause the skybox to be seen through objects and terrain, and a high offset value may cause distant objects and terrain to have too much detail for your desired lighting effect.
Haze
The Haze property controls the haziness of the atmosphere to create a visible effect both above the horizon and far into the distance from the camera. To create environmental moods, like a smoky tint for a polluted alien planet or a foggy blue tint for a somber game, combine this property with the Color property.
1
<img src="https://prod.docsiteassets.roblox.com/assets/lighting-and-effects/atmosphere/Haze-A.jpg" width="800" height="400" alt="Atmosphere with Haze value of 1" />2.8
<img src="https://prod.docsiteassets.roblox.com/assets/lighting-and-effects/atmosphere/Haze-B.jpg" width="800" height="400" alt="Atmosphere with Haze value of 2.8" />Color
The Color property sets the hue of the atmosphere for subtle environmental moods and themes. To expand this property's visible effect, combine it with a high Haze property value.
[255, 255, 255]
<img src="https://prod.docsiteassets.roblox.com/assets/lighting-and-effects/atmosphere/Color-A.jpg" width="800" height="400" alt="Atmosphere with Color value of [255, 255, 255]" />[255, 200, 255]
<img src="https://prod.docsiteassets.roblox.com/assets/lighting-and-effects/atmosphere/Color-B.jpg" width="800" height="400" alt="Atmosphere with Color value of [255, 200, 255]" />Glare
The Glare property sets an atmospheric glare around the sun. A high value results in an increased effect of sunlight cast onto the sky and game. To see this property's visible effect, you must combine a glare with a Haze value higher than 0.
0
<img src="https://prod.docsiteassets.roblox.com/assets/lighting-and-effects/atmosphere/Glare-A.jpg" width="800" height="400" alt="Atmosphere with Glare value of 0" />1
<img src="https://prod.docsiteassets.roblox.com/assets/lighting-and-effects/atmosphere/Glare-B.jpg" width="800" height="400" alt="Atmosphere with Glare value of 1" />Decay
The Decay property sets the hue of the atmosphere away from the sun, gradually falling off from Color toward this value. To see this property's visible effect, you must combine a glare with Haze and Glare values higher than 0.
[255, 255, 255]
<img src="https://prod.docsiteassets.roblox.com/assets/lighting-and-effects/atmosphere/Decay-A.jpg" width="800" height="400" alt="Atmosphere with Decay value of [255, 255, 255]" />[255, 90, 80]
<img src="https://prod.docsiteassets.roblox.com/assets/lighting-and-effects/atmosphere/Decay-B.jpg" width="800" height="400" alt="Atmosphere with Decay value of [255, 90, 80]" />