Files
2026-06-11 16:12:17 +02:00

43 lines
1.7 KiB
Markdown

# 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
}
```