Sun and Sky Actor

An overview of the setup and usage of the SunSky Actor with the SkyAtmosphere component.

See Also

The Sun Position Calculator plugin includes a Geographically Accurate Sun Positioner that gives you fine control over the Sun's position based on a geographic location and date in time. The SunSky Actor is part of this same plugin. It uses the same mathematical equations to govern the position of the Sun in the sky and includes a bundle of components—a Directional Light, Sky Light, and SkyAtmosphere—to produce true-to-life renderings that show realistic patterns of sunlight and shadow.

The SunSky Actor makes it simple and quick to setup your scenes no matter your aesthetic choice with settings for Daylight Saving Time (DST), the date, and the time of day. It's designed to work well within games and other industries, like our Architectural, Engineering and Construction (AEC), or Automotive, Product Design and Manufacturing.

Project Templates and Setup

When creating a new project, the [Project Browser]() enables you to select from different industry types and templates that are relevant for them.

Depending on the template you choose, some properties are enabled/disabled that affect the look and functionality of the SunSky Actor.

Keep these in mind when choosing a Template Category and Template:

  • The Project Setting for Extend default luminance range in Auto Exposure settings is required for this SunSKy Actor to display correctly without editing its properties.

  • Some templates for each Template Category enable the Sun Position Calculator by default. You can verify this by going to the main menu and selecting Edit > Plugins and searching for the plugin.

When choosing an Template Category and a Template you'll want to check the following

Enabling Sun Position Calculator Plugin

  1. From the main menu, choose Edit > Plugins.

  2. Find the Sun Position Calculator plugin under the Misc category, and check its Enabled checkbox.


  3. Click the Restart Now button to apply your changes and re-open the Unreal Editor.


Using the Sun and Sky Actor

Once you've enabled the Sun Position Calculator plugin, you'll find a new Actor called SunSky available in the Editor Modes panel under the Lights category.


Drag it into the Level viewport.


When adding a SunSky Actor to your scene, it's best to remove any Directional Light, Sky Light, or SkyAtmosphere components that already have. Otherwise, it's best to start with a new Blank Level if you're starting from scratch.

When you drag a SunSky Actor into the Level and it appears bright white, you can do one of two things:

  • Enable Extend default luminance range in Auto Exposure settings in the Project Settings under the Rendering category.

  • Or, if you don't want this project setting to affect the look of your project, you can select the SunSky Actor's Directional Light and use a lower Lux intensity.

The SunSky Actor contains movable Actors for Directional Light, Sky Light, and SkyAtmosphere component as part of its Blueprint. When the scene component SunSky(Self) is selected, the exposed Blueprint properties—such as those for date, time of day, latitude and longitude—which can be set are displayed. Selecting the individual components—like those for the Directional Light or SkyAtmosphere—displays their own properties which can be set—like its mobility and intensity.


Properties and Settings

The following adjustable properties are found in the SunSky Actor Details panel.






The degree north or south of the equator.


The degree east or west of the prime meridian.

Time Zone

The specified time for a given region of the world. The time zone uses GMT as a basis.

North Offset

Sets the directional position of North for the SunSky Actor and its components.



Sets the current month.


Sets the current day.

Use Daylight Saving Time

Enables Daylight Saving Time (DST).

DST Start Month

Sets the Date at which DST starts in the current year.

DST Start Day

Sets the Date at which DST starts in the current year.

DST End Month

Sets the Date at which DST ends in the current year.

DST End Day

Sets the Date at which DST ends in the current year.

DST Switch Hour

Sets the beginning and ending hours of DST.


Solar Time

Sets the time of day.

Enter this value as a float in military time. For example 12:30 AM would be 00.5 and 12:30 PM would be 12.5.

ArchVis Template Level Examples

When you create a project, the Template Category for Architecture, Engineering, and Construction includes a template called ArchVis.


This template project is dedicated to architecture visualization workflows with examples for sun studies, interior rendering, and non-photorealistic stylized renderings. It includes the following assets already setup for you to use:

  • Multiple Levels that contain scenes setup to demonstrate visualization with physically accurate lighting using the SunSky Actor.

  • Lighting configuration and Post Process Volume with Ray Tracing features already set for those projects which have enabled Ray Tracing.

  • Example Cameras and Sequencers used to render out the scene. These also include dynamic time-of-day transitions.

This template also enables the Datasmith, which is a collection of tools and plugins designed to import scenes and assets created in offline rendering applications, like 3ds Max and CAD software, into a real-time engine.


The Exterior Level demonstrates usage of the SunSky Actor with multiple cameras used with Sequencer to demonstrate a time-of-day sequence while moving through the scene in various locations. It can be found in the Content/ArchVisProject folder.

It's also a use of the SunSky Actor components for being used to light the scene dynamically. It is also a demonstration of the various real-time Ray Tracing features when they are enabled for the project.


The Interior Level demonstrates usage of the SunSky Actor components being used to light the scene with precomputed static lighting. It can be found in the Content/ArchVisProject folder.

This includes includes:

Additional Notes

  • Ray Tracing features enabled by default on the SunSky Actor for the Directional Light and Sky Light to both support casting of ray traced shadows.

  • It's possible to manually change rotational values of the Directional Light in the SunSky Actor. However, when you change other settings that affects other parts of the SunSky Actor, your manually adjusted rotational values will be reset to the default position. This prevents contradicting values incorporated with the idea of a geolocated calculation.

Additional Resources

  • The website enables you to input a location by name and it returns the map view along with its latitude and longitudinal coordinates.

  • The website has a section of their site dedicated to the Time Zone Map, which can be useful when figuring out what time zone you want to set the SunSky Actor to use. By default, it uses -5 GMT.

Select Skin

Welcome to the new Unreal Engine 4 Documentation site!

We're working on lots of new features including a feedback system so you can tell us how we are doing. It's not quite ready for use in the wild yet, so head over to the Documentation Feedback forum to tell us about this page or call out any issues you are encountering in the meantime.

We'll be sure to let you know when the new system is up and running.

Post Feedback