Please first ensure that trueSKY supports the platforms and API’s that you need.
|x64 (D3D11)||x64 (D3D12)||x64 (Vulkan)||x64 (OpenGL)||PS4||Xbox One (D3D11)||x64 (D3D12)||Switch||OSX|
For binary installations of Unreal Engine, binary trueSKY plugin installers are available from https://simul.co/download. For other versions, or if you have a version of Unreal Engine built from source, you will need to build the plugin. For GitHub/Engine Source Integration, check this page.
Important The stock binary version of Unreal does not deploy trueSKY files when packaging a project. You will see a black sky unless you deploy these files. See Deployment for instructions.
When you run the UE4 editor, the trueSKY plugin should be enabled by default. If not, open up the Plugin Configurator for Unreal Engine (from the menu bar: Edit->Plugins). In the plugin configuration window and type “trueSKY” into the search box to find the plugin; check the “Enabled” box to enable it.
If you had to change the “Enabled” setting from disabled to enabled (or vice versa), you’ll need to restart the editor for the change to take effect, as with all editor plugin changes.
The trueSKY Sequence Actor is the primary way to access and interact with the trueSKY renderer and its rendered sky sequence within Unreal Engine 4. You can add this actor from the standard “Place” sidebar in the editor, choosing “All Classes”, typing “trueSKY”, and choosing the “True Sky Sequence Actor” to drag into your scene, or you can use this handy little shortcut:
Once you have the True Sky Sequence Actor in your scene, choose it from “World Outliner” window. Then, to customize it, open up the “Details” window/sidebar; set the reference to an existing TrueSky Sequence Asset in the “Active Sequence” dropdown. By default, there are two sample sequences you can instantly check and see the results for yourself:
To create a new TrueSkySequence asset, go to the “Content Browser” window. Press “New Asset” button (or do a right mouse click inside the window) to open an asset selection window. Choose “Miscellaneous / trueSKY Sequence Asset”. A new asset will be created. Now you can rename/save/delete it.
In the World Outliner, select your trueSKY sequence actor, and in the Details panel, set its Active Sequence to be the newly created asset:
To edit the TrueSkySequence asset just double-click on it:
This will open up the True Sky Sequence Editor:
Enter your licence key in the Sequencer Window. This enables the window’s editing functions.
You can see changes to the properties (e.g. “preview”) only if the edited asset is also assigned to the level’s TrueSkySequenceActor. The trueSky plugin renderer uses only the asset which is referenced from that actor. If you are editing some other asset (which is not assigned to the TrueSky actor of the current level) then you won’t see any visualization of it.
You can edit any number of TrueSkySequence assets at once. However, only that which is also assigned to the active TrueSkySequenceActor is visible in the editor rendering window.
To add clouds, double-click the trueSKY Sequence Asset and right-click on the timeline to add cloud keyframes.
For real-time ambient lighting and reflections, replace the default SkyLight Actor with the TrueSkyLight (found in Modes -> All Classes). Simply drag it into the scene to use.
You can have any number of trueSKY Sequence Actors in your level, all with different Sequence Assets assigned. In the Editor, check the Actor’s property “Active in Editor” to see its weather state in the 3D view. In-game, the active Actor is determined by bounds. By default, a Sequence Actor is unbounded – it is always active. You can create bounding by adding a Box Collision component to the Actor.
When this is done, the Actor will have limited bounds, and only affect the weather when the player is within the bounding box. You should have at most one unbounded trueSKY Sequence Actor in your level: this will apply when the player is not in the bounds of any other Sequence Actor.
To allow a smooth transition between weather states, you should adjust the Mode property of the Sky and Cloud Layers in all the Sequence Assets to allow a gradual transition between the different weather states. If you’re using real-time transition (this is simplest), you can adjust the Interval in seconds (default 10.0) to determine how quickly the change takes place. Otherwise, use the Interval in days.
Use the Blueprint function GetProfilingText to get GPU and CPU timing numbers for trueSKY as a tree. trueSKY performance is highly dependent on your choice of settings. Once you have good settings for a given target hardware setup, performance will be consistent - i.e. there won’t be spikes or hitches. For PC, you may want to make some of these settings controllable for the end user. For console hardware, it is usually best to choose the settings based on your target GPU time for skies, then lock them down.