# Light Mechanic

Using the Light-Mechanic you can configure your furniture to emits light.\
It takes an **offset** from the base-furniture and a **light-level** between 1 & 15\
Light can also be made toggleable by adding `toggleable: true`, meaning right-clicking the furniture will toggle the light on/off.\
Using `toggled_model` you can provide a NexoItem to display when the furniture-light is toggled on\
Likewise, `toggled_item_model` lets you provide an ItemModel directly without a NexoItem to display when toggled on. Note; this is for 1.21.2+ servers only

```yaml
myitem:
  Mechanics:
    furniture:
      lights:
        #toggleable: false                    # Default is false
        #toggled_model: some_nexo_item        # The NexoItem to show when light is on
        #toggled_item_model: namespace:model  # The ItemModel to use when light is on  
        lights:
          - 0,0,0 15    # x,y,z lightLevel
```

<div><figure><img src="/files/spqwR2iuB3zd0rUmaoUc" alt=""><figcaption><p>Table Lamp included in Nexo Default Items (off)</p></figcaption></figure> <figure><img src="/files/Eh01X5O4ZE7f7SUyILMj" alt=""><figcaption><p>Table Lamp included in Nexo Default Items (on)</p></figcaption></figure></div>


---

# 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.nexomc.com/mechanics/furniture-mechanic/light-mechanic.md?ask=<question>
```

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.
