added first couple objects

2026-06-11 09:16:29 +02:00
parent 7288000ee6
commit 71c21cf536
6 changed files with 212 additions and 0 deletions
@@ -0,0 +1,38 @@
+# 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
+}
+```