xrwise-datastructure/objects/DirectionalLight.md

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:

{
  "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
}