Create colourful lights that define the environment and capture attention.


The Light Behaviour can be used to create individual light sources anywhere in a scene and can be customised to change the look and feel of an experience by adjusting its colour, intensity, position, and distance the light will travel.

The Lighting Behaviour can also be turned on and off using messages, which means one experience can have many lighting states.

Being able to custom lights is also a great way to brighten up areas of an experience that might not have direct light from the environmental lighting, like caves, tunnels and buildings.


All players in the experience will be able to see the same lights, with the same configuration, behaving in the same way.

If the message required to trigger a lighting state change is driven by player action, then the lighting state can be triggered by ALL players.


Because this Behaviour is multiplayer enabled, make sure to select ‘Synchronized’ in the Behaviour selection window when adding it to an Object.

It’s recommended to use logic entities with Light Behaviour.

This makes them easier to identify in Edit Mode and reduces the face count in an experience, which improves performance.


The Light Behaviour supports previews in edit mode, so you can adjust light parameters and see the results in real time.

Light Type

There are two Light Types, Point and Spot, which control the shape and direction of light.

Point Lights

Setting Light Type to Point Light will make the light emit from a central point and radiate in ALL directions as a ‘sphere’ of light.

Spot Lights

Setting Light Type to Spot Light will make the light emit from a central point and radiate in ONE direction as a cone’ of light.

Starting State

This variable uses a toggle to define if the Light Behaviour is initially On or Off.

Setting the toggle to OFF means the light will be inactive when the experience loads.

Setting the toggle to ON means the light will be active as soon as the experience loads.


This variable controls how bright the light is and can be set using values between 1-100.


This variable sets the ‘distance’ the light will travel and is measured in meters.

Both the slider and the field can be used to set the Range to a value between 1 and 20.

The values on the slider in meters equal one Block. Keeping this in mind can be useful when setting the desired range.


Fall-off defines the gradient in intensity from the centre of the light to the outer edges of the lit area.

The values can be set between 0 - 1, where a lower number will produce a softer gradient, and a higher number will produce a harder edge.

Spot Angle

This parameter will only be available if Light Type is set to ‘Spot’.

The Spot Angle defines how ‘wide’ the cone of light will be and can be adjusted using the slider or manually entering a number between 1 and 90.

Setting the Spot Angle to 1 will create a narrow beam of light, while setting the value to 90 will create a broad beam.

Light Colour

Clicking on the colour bar in the Properties Panel will open a pop-up window containing a range of options to modify the colour of the light.

Colour Preview

In the top left corner of the window is a solid bar of colour which will display a preview of the colour and will update in real-time as you adjust it.

Colour Code

To the right of the Colour Preview is a field with a hash (#) and a string of letters and numbers referred to as a Hex Code. The Hex Code represents the colour displayed in the Colour Preview and can be copied and pasted into other Light Behaviours to achieve the same result.

Colour Selecter

Below the Colour Preview is a large square with a crosshair in it.

Clicking on an area within the square, or clicking and dragging the mouse within the square, will move the crosshair and change the colour preview to the colour in that location.

The colours displayed within the square can be adjusted using the drop-down list or the presets in the bottom right corner of the window.

These options will change which two (2) colour attributes are prioritised when moving the crosshair:

HS - Hue and Saturation

HV - Hue and Vibrance

SH - Saturation and Hue

SV - Saturation and Vibrance

VH - Vibrance and Hue

VS - Vibrance and Saturation

Red, Green, Blue

The Red, Green and Blue sliders, commonly referred to as RGB, can be individually adjusted to change how much of each primary colour is present in the light.

Hue, Saturation, Vibrance

The sliders to the right of the Colour Selecter are labelled H, S, and R and control how much of the colour properties, Hue, Saturation, and Vibrance, are present in the light.


Controls the shade of a colour, such as green, purple, yellow or orange.


Controls how dulled down or intense colour is.


Controls how bright or dark a colour is.


Make sure to click the ‘Apply’ button once the desired colour has been achieved.

Closing the pop-up without clicking ‘Apply’ will result in losing the edits made to the light colour.


The Subtractive parameter can be toggled to 'TRUE or FALSE, and when it's toggled to 'TRUE', the area that was previously lit will now remove light rather than add it.

The Subtractive Light still uses the same variables as the standard light, with a key difference that increasing Intensity will more aggressively remove light within the defined range.

When a standard Light and a Subtractive Light overlap, they will blend depending on which Light Behaviour has the greatest Intensity value.

Message to Turn On

This field can be used to access existing Messages or to create new ones. When received, this message will turn the Light Behaviour ON.

Message to Turn Off

This field can be used to access existing Messages or to create new ones. When received, this message will turn the Light Behaviour OFF.

Last updated