# Directional Light

### Type

pre-defined

### 3D

No visible mesh. Represents a scene-wide directional light source (like the sun).
The `target` arg defines the direction the light points toward.
Default spawn height is y=5.

### Custom Args:

| Key       | Type                 | Implemented                    | Description                                                         |
| --------- | -------------------- | ------------------------------ | ------------------------------------------------------------------- |
| color     | hexColor             | ⚠️ (Creator tbd)               | Color of the light                                                  |
| intensity | float                | ✔️                             | Light intensity (default 1).                                        |
| target    | string `"x,y,z"`     | ⚠️ (Unity only reads rotation) | World-space look-at point the light aims at                         |
| grabable  | `"true"` / `"false"` | ⚠️                             | Whether the item can be grabbed in-experience (common to all types) |

### Special Notes:

**Key name discrepancy:** The database save format uses `intensity` as the argument key. `LightManupulationBehaviour.cs` read `brightness` and "intensity".

### Example:

```json
{
  "position": { "x": 0.0, "y": 5.0, "z": 0.0 },
  "rotation": { "x": 0.0, "y": 0.0, "z": 0.0 },
  "scale": { "x": 1.0, "y": 1.0, "z": 1.0 },
  "type": "pre-defined",
  "resourcename": "Directional Light",
  "item-custom-args": [
    { "argument": "color", "value": "#ffffff" },
    { "argument": "intensity", "value": "20" },
    { "argument": "target", "value": "0,0,0" }
  ],
  "item-custom-args-adv": null
}
```