| Property Name | Description |
| --------------------------------- | ---------------------------------------------------------------------------------------------- |
| Type | Sets the light to be "Spot" (directional) or "Point" (omnidirectional). |
| Color | Changes the color of light source. |
| Brightness | How bright the light is. |
| Outer Cone Angle (Only Spot Type) | Angle/Frustum of the outer spotlight cone. (Reference Image Light Source Outer-Inner Cone) |
| Inner Cone Angle (Only Spot Type) | Angle/Frustum of the inner spotlight cone. |
| Source Size | Modifies the softness of the light source. (Reference Image Light Source Outer-Inner Cone) |
| Light Range | Distance at which the light falls off. |
| Cast Static Shadows | Enables shadows for static objects. |
| Cast Dynamic Shadows | Enables shadows for dynamic objects, adds additional expense. |
| Shadow Start Distance | Distance from source at which the shadows start. (Reference Image Light Shadow Start Distance) |
Light Source Outer-Inner Cone
Light Shadow Start Distance
## Animation
{% hint style="info" %}
Animations are used to create Flickering lights
{% endhint %}
Animation Properties
| Property Name | Description |
| ------------- | --------------------------------------------------------------- |
| Type | Applies an animation to the light. |
| Rate | Changes the Light animation Speed (Higher faster, lower slower) |
## Cone
{% hint style="info" %}
Light cones are versatile, cheap to render billboard objects. Used to create fake lighting effects, such as, light rays, fog, mist, smoke. Also used to create depth and pathing.
{% endhint %}
Cone Properties
| Property Name | Description |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Type | The light cone attached to the object. (Reference Image Types of Light Cones) |
| Intensity | How bright the light cone is. |
| Length | Changes the length of the light cone; Stacking multiple light cones over one another, or the larger the light cone takes up on screen, the more performance cost it has. |
| Width | Changes the width of the light cone; Stacking multiple light cones over one another, or the larger the light cone takes up on screen, the more performance cost it has. |
| Fade Start | Distance from player when the light cone starts to fade. |
| Fade End | Distance from player when the light come completely fades. |
| Enable Parent Light | Toggles the light to be on/off; used when only a light cone is desired. |
Types of Light Cones
## Gobo
{% hint style="info" %}
Gobos are patterns projected from lights to give different lighting results. Examples being water caustics, faking shadows, or placing a Banished logo.
{% endhint %}
Gobo Properties
| Property Name | Description |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Gobo Information | There can only be a limit of 4 Unique gobos rendering at the same time. Duplicates work fine, but 5+ gobos in close proximity still rendering will cause the gobos to flicker or not render correctly |
| Type | Applies a stencil (pattern) projected from the light (Only works on "Spot" lights). (Reference Image Types of Gobos |
Types of Gobos
## OBB
{% hint style="info" %}
OBB's (Oriented Bounding Box) are used Primarily as a performance tool, clamping light pixels to have more performant heatmaps (Use the Light/Shadow Heatmaps to see light pixel influence)
{% endhint %}
OBB Properties
| Property Name | Description |
| ---------------------- | ------------------------------------------------------------------------------ |
| Enable OBB | Toggles on/off OBB (Reference Images below ) |
| Scale with Light Range | Automatically scales the bounds if ""Light Range" changes |
| Lower X Bound | Moves 1 side of the bounding box, setting can not be higher than Upper X Bound |
| Upper X Bound | Moves 1 side of the bounding box, setting can not be higher than Lower X Bound |
| Lower Y Bound | Moves 1 side of the bounding box, setting can not be higher than Upper Y Bound |
| Upper Y Bound | Moves 1 side of the bounding box, setting can not be higher than Lower Y Bound |
| Bottom | Moves the Bottom of the Volume |
| Top | Moves the Bottom of the Volume |
| Show | Always render OBB Volume |
OBB Adjusted
OBB Default
#### Contributors
Nitro\
Tyler | Lighting Artist\
Captain Punch
---
# 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://wiki.thescriptersguild.com/forge/lighting/settings-object-based-lighting/light-objects.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.