# Light {% hint style="success" %} **COPY/PASTE PARAMETERS** New in GM 0.11! Right click on a behaviour or component to copy. Then open an object, add the same behaviour or component, and right click it to paste identical parameter settings. {% endhint %}
{% hint style="info" %} [build-singleplayer-and-multiplayer-logic](https://docs.sandbox.game/en/creator/game-maker/docs/build-singleplayer-and-multiplayer-logic "mention") - about **\[SP]** or **\[MP]** behaviours or components. {% endhint %} ## Light \[SP] \[MP] ## Common Uses * Light fixtures, spotlights, campfires, soft glow to emphasise emissive Assets * Dark spaces with negative light * Child Objects for pickable items (flashlights, torches, etc), moving Objects (vehicle headlights), etc. * Visual hints or puzzles * Localised ambience and storytelling * Environmental highlights (to add emphasis in addition to [**Weather Switcher**](https://docs.sandbox.game/en/creator/game-maker/docs/behaviours/visual/weather-switcher) settings for sky, light color, and shadows) * Applying light to avatars via [**Avatar's Feature**](https://docs.sandbox.game/en/creator/game-maker/behaviours/basic-logic/spawn-point-and-avatars-feature#avatars-feature-components), with a new offset parameter in 0.11 for better implementation. ## Parameter Notes | Options | Details | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ![](https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/PoAndph5Socff0rfHgHA/image.png) |

Light Type (dropdown)

| | ![](https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/HTtygc5zT3mS4EdAAPpw/image.png) | **Starting State** - Set the light be **on** or **off** at the start of the Experience. | | ![](https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/Ud1R4l208zPog0PwP2DL/image.png) |

Intensity (slider: 1-100) - Determines the brightness of the light.

NOTE: This value is used to prioritize how different light sources will blend together.

| | ![](https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/Z1rkyHOO2Jl2ru9ohdcv/image.png) | **Range** (slider) - Defines how far from the source the light will reach in blocks. | | ![](https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/J99knW4u2qOiTiRW3dF2/image.png) |

Falloff (slider) - Increase or decrease the gradient of intensity from the center of the light source.
A lower value creates a softer edge at the range set, while a larger number creates a harder edge.

| | | ***Spot Angle*** (Spot Light - slider) - Set the angle for the cone shape of a spot light (relative to the center of the light cone). | |



When you click on the colour box:


Note: You MUST Click Apply so your settings will be saved.

|

Light Color - Select the colour of the light from a color picker or by inserting a Hex Code. The preview box (top left) updates as you adjust.

Adjust by moving the crosshair in the selection square or dragging the arrows in each slider:
RGB - Red, Green, and Blue primary colors
HSV - Hue, Saturation, and Vibrance present

Filter color options in the selection square:
HS - Hue and Saturation

HV - Hue and Vibrance

SH - Saturation and Hue

SV - Saturation and Vibrance

VH - Vibrance and Hue

VS - Vibrance and Saturation

Hue

Saturation

Vibrance

| | ![](https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/aqbJMJbKUghQrmQuNzr4/image.png) |

Subtractive - Remove light if True



NOTE: When normal light and subtractive light overlap, they will blend depending on which light has the greatest Intensity value.

| | ![](https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/BUE4wLetPf8rsPYCTxj8/image.png) |

Message to Turn ON - Add the message(s) required to turn on the light.

Message to Turn OFF - Add the message(s) required to turn off the light.

| | |

Position Offset (new in 0.11) - Offset the light from the actor the component is applied to.
Note: This parameter improves Light use when applied as an Avatar's Feature.

| --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.sandbox.game/en/creator/game-maker/docs/components/display/light.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.