TJ
39 lines
1.3 KiB
Markdown
39 lines
1.3 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 | ⚠️ **See note below.** | Light intensity (default tbd). |
|
|
| 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, but `LightManupulationBehaviour.cs` reads `brightness`. Light intensity args may not apply at runtime unless this is resolved.
|
|
|
|
### 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
|
|
}
|
|
```
|