> For the complete documentation index, see [llms.txt](https://dorreal-art.gitbook.io/dorreal_art_docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dorreal-art.gitbook.io/dorreal_art_docs/documentation/getting-started/quickstart.md).
# Quickstart
This guide gets Echoluma up and running with a simple setup.\
No prior knowledge required.
{% stepper %}
{% step %}
### **Add Echoluma Controller and Echoluma Lights to the Scene**
* Open Content Browser.
* Find `BP_EcholumaLightController` and `BP_EcholumaSpotLight`:
* Drag\&Drop `BP_EcholumaLightController` and multiple `BP_EcholumaSpotLight` actors in your scene.
* All required settings are located in the **Details Panel** of the controller.
{% endstep %}
{% step %}
### Assign Lights to Controller
* Select `BP_EcholumaLightController` in the scene.
* In the details panel, look for **Controlled Lights** under **Playback Control** section.
* Add lights to this array by pressing :circle-plus: and then selecting an **Echoluma Light** in the scene with :eye-dropper: to include them in the sequence.
{% hint style="info" %}
Offsets are applied based on the order in **Controlled Lights**.
The first light in the list receives the first offset, followed sequentially.
{% endhint %}
{% endstep %}
{% step %}
### Set the Tempo
* Adjust **BPM** (Beats Per Minute) to match your desired tempo
* Leave Mode on **Auto**
{% endstep %}
{% step %}
### Enable Playback
* Make sure **Start on Begin Play is enabled**
* Enable **Loop**
{% endstep %}
{% step %}
### Create A Pattern
* Add a few indexes to **Step Pattern** by clicking :circle-plus: next to it
* Set desired indexes as :square-check: to define your active beats\
Only enabled beats will trigger lighting changes.
* You can use **Duplicate Pattern** button to extend your current pattern
{% hint style="info" %}
Leave **Step Pattern** empty to execute on every beat.
This creates a continuous, steady pulse.
{% endhint %}
{% endstep %}
{% step %}
### Set the Tone
Expand the Envelope:
* Set **Attack** and **Release** to
* Increase **Peak** to
{% hint style="info" %}
If the sum of **Attack + Peak + Release** exceeds the duration of a **beat**, the values are automatically scaled at runtime.
> Keeps the envelope within the available time window.
> {% endhint %}
> {% endstep %}
{% step %}
### Make It Stand Out
Inside the **Light Look**:
* Increase **Hit Intensity**
* Change **Hit Color**
* Alternatively, set **Auto Color Behaviour** to **Individual** and **Auto Color Assignment** to **Hit Only**
{% hint style="info" %}
**Dim values** define the passive state of the lights.
They act as the baseline between active beats.
{% endhint %}
{% endstep %}
{% step %}
### Set Lights In Motion
Extend **Movement:**
* Set **Movement** to **Orbit**
* Pick a **Focus Actor** in the scene with the :eye-dropper: tool
* Ensure the distance between lights and the **Focus Actor** is within each light’s **Attenuation Radius**
If not, the effect may not be visible
{% hint style="info" %}
If no **Focus Actor** is assigned, lights will orbit around the **controller** by default.
{% endhint %}
{% endstep %}
{% step %}
### Add Some Magic
Inside **Light FX**:
* Set **Mask Intensity** to 1
* Open the dropdown menu next to the **Mask Texture**
* Write "Gobo" and select **T\_EcholumaGobo\_04**
* Extend **Texture Control**
* Set **Tiling** to 4
{% endstep %}
{% step %}
### Add Another Step
Click the :circle-plus: button next to Echoluma Steps to add another step.
Collapse Index 0 and expand index 1 if its not expanded already.
Change some variables on index 1
{% endstep %}
{% step %}
### Press Play
Hit **Play**.
Congratulations, you have just made your first Light Show within a few minutes!
{% endstep %}
{% endstepper %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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://dorreal-art.gitbook.io/dorreal_art_docs/documentation/getting-started/quickstart.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.