incanto 0.5.0 → 0.6.0

package/editor/index.html

@@ -5,7 +5,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>Incanto Scene Editor</title>
     <link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'><rect width='16' height='16' rx='3' fill='%236ee7dc'/><text x='8' y='12' text-anchor='middle' font-size='11' font-family='monospace' fill='%230e1018'>i</text></svg>" />
-    <script type="module" crossorigin src="./assets/index-D2qufqUo.js"></script>
+    <script type="module" crossorigin src="./assets/index-mofVSmuA.js"></script>
     <link rel="modulepreload" crossorigin href="./assets/GameServer-C56iOUgF.js">
     <link rel="stylesheet" crossorigin href="./assets/index-DF3tMeKJ.css">
   </head>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "incanto",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Vibe-coding-first web game engine SDK — JSON-driven scenes on three.js",
   "keywords": [
     "game-engine",

package/schemas/scene.schema.json

@@ -398,6 +398,10 @@
               "type": "number",
               "default": 0
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -526,6 +530,10 @@
               "maxItems": 3,
               "default": [0, 0, 0]
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -684,6 +692,10 @@
               "type": "number",
               "default": 0
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -775,6 +787,10 @@
               "maxItems": 3,
               "default": [0, 0, 0]
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -984,6 +1000,10 @@
               "maxItems": 3,
               "default": [0, 0, 0]
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -1070,6 +1090,10 @@
               "type": "number",
               "default": 0
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -1176,6 +1200,10 @@
               "maxItems": 3,
               "default": [0, 0, 0]
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -1274,6 +1302,10 @@
               "type": "number",
               "default": 0
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -1382,6 +1414,10 @@
               "maxItems": 3,
               "default": [0, 0, 0]
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -1562,6 +1598,10 @@
               "maxItems": 3,
               "default": [0, 0, 0]
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -1728,6 +1768,10 @@
               "type": "number",
               "default": 0
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -1840,6 +1884,10 @@
               "maxItems": 3,
               "default": [0, 0, 0]
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -1950,6 +1998,10 @@
               "maxItems": 3,
               "default": [0, 0, 0]
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -2082,6 +2134,10 @@
               "maxItems": 3,
               "default": [0, 0, 0]
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -2315,6 +2371,10 @@
               "type": "number",
               "default": 0
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -2440,6 +2500,10 @@
               "maxItems": 3,
               "default": [0, 0, 0]
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -2560,6 +2624,10 @@
               "type": "number",
               "default": 0
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -2666,6 +2734,10 @@
               "maxItems": 3,
               "default": [0, 0, 0]
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -2776,6 +2848,10 @@
               "maxItems": 3,
               "default": [0, 0, 0]
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -2889,6 +2965,10 @@
               "maxItems": 3,
               "default": [0, 0, 0]
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -3120,6 +3200,10 @@
               "type": "number",
               "default": 0
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -3206,6 +3290,10 @@
               "maxItems": 3,
               "default": [0, 0, 0]
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -3292,6 +3380,10 @@
               "maxItems": 3,
               "default": [0, 0, 0]
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -3386,6 +3478,10 @@
               "type": "number",
               "default": 0
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -3582,6 +3678,10 @@
               "maxItems": 3,
               "default": [0, 0, 0]
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -3777,6 +3877,10 @@
               "type": "number",
               "default": 0
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -3897,6 +4001,10 @@
               "maxItems": 3,
               "default": [0, 0, 0]
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -4011,6 +4119,10 @@
               "type": "number",
               "default": 0
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -4126,6 +4238,10 @@
               "maxItems": 3,
               "default": [0, 0, 0]
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -4264,6 +4380,10 @@
               "type": "number",
               "default": 0
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -4355,6 +4475,10 @@
               "maxItems": 3,
               "default": [0, 0, 0]
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -4445,6 +4569,10 @@
               "maxItems": 3,
               "default": [0, 0, 0]
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -4660,6 +4788,10 @@
               "maxItems": 3,
               "default": [0, 0, 0]
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -5147,6 +5279,10 @@
               "maxItems": 3,
               "default": [0, 0, 0]
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {
@@ -5238,6 +5374,10 @@
               "maxItems": 3,
               "default": [0, 0, 0]
             },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
             "scale": {
               "type": "array",
               "items": {

package/skills/incanto-building-2d-games.md

@@ -240,3 +240,9 @@ solid core carries the colour). `rate: 0` +
 
 `node.replay()` re-arms a one-shot. Simulation is deterministic under the
 engine seed — runScript verifies particle gameplay reproducibly.
+
+## `static: true` for big scenes
+
+Mark unchanging subtrees (tile decor, backgrounds) `static: true` — the
+renderer syncs them once and skips them every frame. Flip to `false` to
+resume live syncing.

package/skills/incanto-building-3d-games.md

@@ -366,3 +366,16 @@ from a `seed`, with `heightAt(x, z)` for spawning/placement and a
 `{shape: 'heightfield'}` collider recipe (Terrain3D as the CHILD of a
 `StaticBody3D`). Full themes table, custom layer format and the water/beach
 pairing live in the **incanto-environment** skill.
+
+## Performance levers for big scenes
+
+- **`static: true`** (any Node3D): the renderer syncs that subtree ONCE and
+  skips it every frame after — mark terrain, buildings, rocks, fences,
+  whole decor groups. Do NOT mark animated nodes (Water3D, Particles3D,
+  animated models, cameras): they freeze (the engine warns once). Set
+  `static = false` at runtime to resume live syncing after an edit.
+- **`environment.shadows.static: true`**: the shadow pass renders once per
+  scene/environment change instead of every frame (measured ~42% of a
+  dense-forest frame). Use when shadow CASTERS don't move — pair moving
+  characters with sprite/blob shadows. After a one-off world edit call
+  `renderer.refreshShadows()`.

package/skills/incanto-node-reference.md

@@ -21,6 +21,7 @@ description: GENERATED complete reference of every Incanto node type — props,
 |---|---|---|
 | `position` | `[0,0]` | array |
 | `rotation` | `0` | number |
+| `static` | `false` | boolean |
 | `scale` | `[1,1]` | array |
 | `renderOrder` | `0` | number |
 | `visible` | `true` | boolean |
@@ -42,6 +43,7 @@ Signals: `animationFinished(name)`
 |---|---|---|
 | `position` | `[0,0,0]` | array |
 | `rotation` | `[0,0,0]` | array |
+| `static` | `false` | boolean |
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
@@ -70,6 +72,7 @@ Signals: `animationFinished(name)`
 |---|---|---|
 | `position` | `[0,0]` | array |
 | `rotation` | `0` | number |
+| `static` | `false` | boolean |
 | `scale` | `[1,1]` | array |
 | `renderOrder` | `0` | number |
 | `visible` | `true` | boolean |
@@ -83,6 +86,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 |---|---|---|
 | `position` | `[0,0,0]` | array |
 | `rotation` | `[0,0,0]` | array |
+| `static` | `false` | boolean |
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
@@ -115,6 +119,7 @@ Signals: `finished`
 |---|---|---|
 | `position` | `[0,0,0]` | array |
 | `rotation` | `[0,0,0]` | array |
+| `static` | `false` | boolean |
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
@@ -126,6 +131,7 @@ Signals: `finished`
 |---|---|---|
 | `position` | `[0,0]` | array |
 | `rotation` | `0` | number |
+| `static` | `false` | boolean |
 | `scale` | `[1,1]` | array |
 | `renderOrder` | `0` | number |
 | `visible` | `true` | boolean |
@@ -141,6 +147,7 @@ Signals: `finished`
 |---|---|---|
 | `position` | `[0,0,0]` | array |
 | `rotation` | `[0,0,0]` | array |
+| `static` | `false` | boolean |
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
@@ -155,6 +162,7 @@ Signals: `finished`
 |---|---|---|
 | `position` | `[0,0]` | array |
 | `rotation` | `0` | number |
+| `static` | `false` | boolean |
 | `scale` | `[1,1]` | array |
 | `renderOrder` | `0` | number |
 | `visible` | `true` | boolean |
@@ -171,6 +179,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 |---|---|---|
 | `position` | `[0,0,0]` | array |
 | `rotation` | `[0,0,0]` | array |
+| `static` | `false` | boolean |
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
@@ -197,6 +206,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 |---|---|---|
 | `position` | `[0,0,0]` | array |
 | `rotation` | `[0,0,0]` | array |
+| `static` | `false` | boolean |
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
@@ -230,6 +240,7 @@ Signals: `movementStateChanged(state)`
 |---|---|---|
 | `position` | `[0,0]` | array |
 | `rotation` | `0` | number |
+| `static` | `false` | boolean |
 | `scale` | `[1,1]` | array |
 | `renderOrder` | `0` | number |
 | `visible` | `true` | boolean |
@@ -244,6 +255,7 @@ Signals: `movementStateChanged(state)`
 |---|---|---|
 | `position` | `[0,0,0]` | array |
 | `rotation` | `[0,0,0]` | array |
+| `static` | `false` | boolean |
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
@@ -260,6 +272,7 @@ Signals: `movementStateChanged(state)`
 |---|---|---|
 | `position` | `[0,0,0]` | array |
 | `rotation` | `[0,0,0]` | array |
+| `static` | `false` | boolean |
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
@@ -280,6 +293,7 @@ Signals: `movementStateChanged(state)`
 |---|---|---|
 | `position` | `[0,0,0]` | array |
 | `rotation` | `[0,0,0]` | array |
+| `static` | `false` | boolean |
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `2` | number |
@@ -317,6 +331,7 @@ Signals: `movementStateChanged(state)`
 |---|---|---|
 | `position` | `[0,0]` | array |
 | `rotation` | `0` | number |
+| `static` | `false` | boolean |
 | `scale` | `[1,1]` | array |
 | `renderOrder` | `0` | number |
 | `visible` | `true` | boolean |
@@ -334,6 +349,7 @@ Signals: `movementStateChanged(state)`
 |---|---|---|
 | `position` | `[0,0,0]` | array |
 | `rotation` | `[0,0,0]` | array |
+| `static` | `false` | boolean |
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
@@ -351,6 +367,7 @@ Signals: `movementStateChanged(state)`
 |---|---|---|
 | `position` | `[0,0]` | array |
 | `rotation` | `0` | number |
+| `static` | `false` | boolean |
 | `scale` | `[1,1]` | array |
 | `renderOrder` | `0` | number |
 | `visible` | `true` | boolean |
@@ -366,6 +383,7 @@ Signals: `movementStateChanged(state)`
 |---|---|---|
 | `position` | `[0,0,0]` | array |
 | `rotation` | `[0,0,0]` | array |
+| `static` | `false` | boolean |
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
@@ -382,6 +400,7 @@ Signals: `movementStateChanged(state)`
 |---|---|---|
 | `position` | `[0,0,0]` | array |
 | `rotation` | `[0,0,0]` | array |
+| `static` | `false` | boolean |
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
@@ -397,6 +416,7 @@ Signals: `movementStateChanged(state)`
 |---|---|---|
 | `position` | `[0,0,0]` | array |
 | `rotation` | `[0,0,0]` | array |
+| `static` | `false` | boolean |
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
@@ -432,6 +452,7 @@ _No props (structural fields only)._
 |---|---|---|
 | `position` | `[0,0]` | array |
 | `rotation` | `0` | number |
+| `static` | `false` | boolean |
 | `scale` | `[1,1]` | array |
 | `renderOrder` | `0` | number |
 | `visible` | `true` | boolean |
@@ -442,6 +463,7 @@ _No props (structural fields only)._
 |---|---|---|
 | `position` | `[0,0,0]` | array |
 | `rotation` | `[0,0,0]` | array |
+| `static` | `false` | boolean |
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
@@ -452,6 +474,7 @@ _No props (structural fields only)._
 |---|---|---|
 | `position` | `[0,0,0]` | array |
 | `rotation` | `[0,0,0]` | array |
+| `static` | `false` | boolean |
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
@@ -465,6 +488,7 @@ _No props (structural fields only)._
 |---|---|---|
 | `position` | `[0,0]` | array |
 | `rotation` | `0` | number |
+| `static` | `false` | boolean |
 | `scale` | `[1,1]` | array |
 | `renderOrder` | `0` | number |
 | `visible` | `true` | boolean |
@@ -497,6 +521,7 @@ Signals: `finished`
 |---|---|---|
 | `position` | `[0,0,0]` | array |
 | `rotation` | `[0,0,0]` | array |
+| `static` | `false` | boolean |
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
@@ -530,6 +555,7 @@ Signals: `finished`
 |---|---|---|
 | `position` | `[0,0]` | array |
 | `rotation` | `0` | number |
+| `static` | `false` | boolean |
 | `scale` | `[1,1]` | array |
 | `renderOrder` | `0` | number |
 | `visible` | `true` | boolean |
@@ -549,6 +575,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 |---|---|---|
 | `position` | `[0,0,0]` | array |
 | `rotation` | `[0,0,0]` | array |
+| `static` | `false` | boolean |
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
@@ -568,6 +595,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 |---|---|---|
 | `position` | `[0,0]` | array |
 | `rotation` | `0` | number |
+| `static` | `false` | boolean |
 | `scale` | `[1,1]` | array |
 | `renderOrder` | `0` | number |
 | `visible` | `true` | boolean |
@@ -584,6 +612,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 |---|---|---|
 | `position` | `[0,0,0]` | array |
 | `rotation` | `[0,0,0]` | array |
+| `static` | `false` | boolean |
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
@@ -605,6 +634,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 |---|---|---|
 | `position` | `[0,0]` | array |
 | `rotation` | `0` | number |
+| `static` | `false` | boolean |
 | `scale` | `[1,1]` | array |
 | `renderOrder` | `0` | number |
 | `visible` | `true` | boolean |
@@ -618,6 +648,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 |---|---|---|
 | `position` | `[0,0,0]` | array |
 | `rotation` | `[0,0,0]` | array |
+| `static` | `false` | boolean |
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
@@ -631,6 +662,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 |---|---|---|
 | `position` | `[0,0,0]` | array |
 | `rotation` | `[0,0,0]` | array |
+| `static` | `false` | boolean |
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
@@ -663,6 +695,7 @@ Signals: `timeout`
 |---|---|---|
 | `position` | `[0,0,0]` | array |
 | `rotation` | `[0,0,0]` | array |
+| `static` | `false` | boolean |
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
@@ -731,6 +764,7 @@ Signals: `bannerShown`
 |---|---|---|
 | `position` | `[0,0,0]` | array |
 | `rotation` | `[0,0,0]` | array |
+| `static` | `false` | boolean |
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
@@ -744,6 +778,7 @@ Signals: `blocksChanged`
 |---|---|---|
 | `position` | `[0,0,0]` | array |
 | `rotation` | `[0,0,0]` | array |
+| `static` | `false` | boolean |
 | `scale` | `[1,1,1]` | array |
 | `visible` | `true` | boolean |
 | `renderOrder` | `1` | number |