light
Since 0.6
Use it in a scene entity's components list as { "type": "light", … }. The contract writes the fields flat and refuses unknown keys.
Fields
| Field | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
kind | LightKind | yes | directional, point, spot | ||
color | string | yes | |||
intensity | number | yes | |||
castShadow | boolean | no | |||
range | number | no | |||
angle | number | no | |||
indirectIntensity | number | no | Multiplier on this light's contribution to the indirect (bounced) light, 0..16; absent means no change. Zero keeps the light's direct light and removes its bounce; two doubles the bounce. HD's ray-traced GI only: the standard renderer ignores it (hd-only-ignored). Changing it while the scene runs re-lights the GI within a few frames, with no restart. |
Rules that can refuse it
component-not-writablegi-intensity-rangehd-only-ignoredshader-model-mismatch
Example
From the contract's tested fixture fixtures/contract/full20/scene.json#lamps.
{
"type": "light",
"kind": "point",
"color": "#FFD9A0",
"intensity": 12,
"range": 9
}