> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rageon.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Lights

> Place bulbs, ceiling spots, and neon lights in an interior and tune their color, range, cone, and schedule.

Start from a preset, click the scene, then adjust the light in **Structure details**. Lights need the structure to have its own geometry; see [Geometry](/projects/structures/geometry.md).

## Place a light

**1. Pick a preset**

Click **Light** in the left dock or press `8`. In the top bar, open **Preset** and choose **Bulb**, **Ceiling spot**, or **Neon**.

![Top bar with the Preset list open and the Light tool active in the dock](https://mintcdn.com/rageon/_nzjx4zmIQAxf8Hl/images/structures/structures-light-preset.webp?fit=max\&auto=format\&n=_nzjx4zmIQAxf8Hl\&q=85\&s=b999d3a66b1e41b1c4cb6a0ddeaaabdb)

Preset list open with Bulb, Ceiling spot, and Neon.

**2. Click the scene**

A crosshair labeled with the preset and the position follows the pointer. One click places one light, selects it, and returns to **Select**. A **Ceiling spot** aims along the face under the pointer.

![Spot light selected in the scene with cone lines and the Light section on the right](https://mintcdn.com/rageon/_nzjx4zmIQAxf8Hl/images/structures/structures-light-placed.webp?fit=max\&auto=format\&n=_nzjx4zmIQAxf8Hl\&q=85\&s=0d0d73c0db9fdcdd50c7b84b4e9e3a5a)

A spot light after placing, with its handles and the Light section.

| Preset | You get |
| - | - |
| **Bulb** | Point light, 3 m range, warm color. |
| **Ceiling spot** | Spot light. |
| **Neon** | Capsule light, 1.2 m long, blue. |

**Pointer** in the transform bar decides what the pointer can land on while you place.

## Tune a light

Select a light in the scene or under the **Lights** filter in the tree. Its sections, from the top:

![Light section list with type, color, range, cone warning, volumetric, corona, shadow, and schedule](https://mintcdn.com/rageon/_nzjx4zmIQAxf8Hl/images/structures/structures-light-fiche.webp?fit=max\&auto=format\&n=_nzjx4zmIQAxf8Hl\&q=85\&s=6b77250cda43d08520d54b0216e8a6d5)

The light's sections for a spot with an invalid cone, and the 24-hour schedule.

| Option | What it does | Default |
| - | - | - |
| **Name** | Shown in the tree. | The preset name |
| **Point** / **Spot** / **Capsule** | Light type. | Per preset |
| **Color** | Light color. | White |
| **Intensity** | Brightness. Zero or more. | 1 |
| **Range (m)** | How far the light reaches. Must be above zero. | 5 |
| **Exponent** | Falloff. | 8 |
| **Position (m)**, **Rotation (°)** | Placement. Rotation aims a spot or capsule. | |
| **Room** | **Auto** or a room by name. | **Auto** |
| **Inner (…°)**, **Outer (…°)** in **Cone** | Spot angles, 0 to 90°. The label shows the current angle. Keep the inner one at or below the outer one. | 30°, 45° |
| **Length (m)** | Capsule length. | 1 |
| **Corona size**, **Corona intensity**, **Z bias** | The glow at the source. | 0, 1, 0 |
| **Blur**, **Near clip**, **Shadow distance**, **Specular distance**, **Light distance** | Shadow softness and how far shadows, highlights, and the light itself reach. | 0, 0.1, 100, 100, 100 |
| **Flags (raw)** | Raw light bits. Leave it alone unless you know the value. | 0 |
| **Schedule** | One box per hour (`0` to `23`). Uncheck the hours the light should be off. With none checked the light stays on. | All on |
| **Flashiness** | 0 to 255. | 0 |
| **Clip plane** | Cuts the light at a plane, set with **Normal** and **Offset**. | Off |
| **Projected texture (hash)** | A texture the light projects. | 0 |

The last five rows sit in the **Advanced** section.

### Light shafts

Turn on **Volumetric** > **Active** for a visible beam. **Volume intensity**, **Volume scale**, **Outer color**, **Outer intensity**, **Outer exponent**, and **Volume distance** stay disabled until it is on. In the editor the beam is a translucent shape, so the preview is approximate.

### Handles in the scene

A selected spot shows **Light range**, **Light inner cone**, and **Light outer cone** handles; a capsule shows **Capsule length**. Drag one to change the value. Hold `Ctrl` to skip snap.

## Limits

The [Checker](/projects/structures/checker.md) warns when an interior has too many lights, because the preview shares its light budget with the world, and blocks export above the hard limit. Delete lights or merge them into fewer, stronger ones.

## Troubleshooting

> **The inner cone of "…" exceeds the outer one.**
>
> In **Cone**, lower **Inner** or raise **Outer** until the inner angle is not larger.

> **Light "…" needs a range greater than zero.**
>
> This blocks export. Set **Range (m)** above 0.

> **The intensity of "…" must be zero or positive.**
>
> This blocks export. Set **Intensity** to 0 or more.

> **The room of "…" does not exist.**
>
> The room was deleted. Set **Room** to **Auto**.

> **Lights need their own geometry to be written into the drawable.**
>
> This blocks export. Add geometry to the structure first.

> **Flashiness, blur and fade distances accept integers from 0 to 255.**
>
> Enter a whole number from 0 to 255 in the field you edited.

> **The clipping plane needs a non-zero normal.**
>
> Give **Normal** a direction on at least one axis, or turn **Clip plane** off.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.