Documentation: String Lights for Unreal Engine

ElKaWeh

Available on Fab

Contents:

1. Overview
2. Initial Setup
3. Settings & Features
   1. Light Color (1,2,3)
   2. Brightness
   3. Multi Colored Lights
   4. Enable Blinking Lights
   5. Blinking Speed
   6. Collision Enabled
   7. Spawn Point Lights
   8. Point Light Settings
   9. WPO At Distance

1. Overview

String Lights is a blueprint tool for Unreal Engine that allows you to quickly create string lights as spline meshes in your scene. There are 6 unique types of String Lights, which can all be easily adjusted to your needs.

2. Initial Setup

After importing the package into your Unreal Project, go to Content > StringLights > Blueprints > Presets and simply drag and drop one of the "BP_StringLights[...]" Child Blueprint Classes into your level. You are now ready to go.

There are three presets for each type of String Light, which can be adjusted freely and used simultaneously. However, if you need more than three different versions of the same String Light type, a description on how to create additional presets can be found below under "Additional Info & Advanced Usage".

3. Settings & Features

3.1. Light Color (1,2,3)
Changes the color of the String Light's emissive material(s) and, if they are activated, of its point lights.

StringLights01, StringLights02 and StringLights05 have multicolor options. Only if "Multi Colored Lights" or "Enable Blinking Lights" is turned on, "Light Color 2" and "Light Color 3" will take effect.

3.2. Brightness
Changes the brightness of the String Light's emissive material(s) and, if they are activated, of its point lights.

3.3. Multi Colored Lights
Only StringLights01, StringLights02 and StringLights05 have multicolor options.
When activated, the first light on the string will have Light Color 1, the second one Light Color 2, the third one Light Color 3, the fourth one Light Color 1 and so on.

3.4. Enable Blinking Lights
If activated, the lights will switch between Light Color 1, 2 & 3. If "Multi Colored Lights" is selected, all three colors will be visible at the same time. If "Multi Colored Lights" is not selected, all lights will cycle between Light Color 1,2, & 3 simultaneously.

3.5. Blinking Speed
Delay between each color change in seconds.

3.6. Collision Enabled
Enables collision for the spline mesh. 

3.7. Spawn Point Lights
This option spawns Point Lights, with adjustable spacing along the spline (NOT at each point where a light sits). This option is especially useful, if you are not using Lumen, but it can still make sense to use both in combination. It is very performance heavy, so I recommend enabling it very selectively and to increase the spacing between each Point Light for longer splines, so you have less Point Lights overall.

Sometimes it makes sense to disable the option, and set your own Point Lights instead, as it is also partially done in the overview level.

3.8. Point Light Settings
You have the ability to change Mobility, Intensity Units, Source Radius and Attenuation Radius, as well as enabling or disabling Cast Shadows for the spawned Point Lights. Those are the same options, you would also have when manually creating a Point Light in Unreal. For more information, please check the official Unreal Engine Documentation.

One additional setting here is the Point Light Spacing. This is the interval, at which the Point Lights are spawned along the spline. Increase the value to save performance. When spacing is increased, the source length of each Point Light will automatically adjust to the spacing, so there are no gaps between each light. However, with more spacing, the emitted light will look jagged on strong curves.

3.9. WPO at Distance
WPO at Distance stands for World Position Offset at distance, along the local normals. Since the String Lights are thin in nature, they become invisible at distance, when they get too small to fill in a single pixel. This feature works around this issue, by increasing the thickness of the mesh when the camera is further away. It can be deactivated, by setting the value to 0 or exaggerated by putting in a value greater than.